تشغّل Adrasis خادم Model Context Protocol (MCP) مبنيًّا على Distribution Partner API الخاصة بها. يبحث وكلاء الذكاء الاصطناعي عن أماكن الإقامة وخدمات النقل والجولات ورحلات الطيران العارض والباقات ويحجزونها وفق قواعد API، داخل حساب شريك.
يغلّف الخادم عقد REST الخاص بـ Adrasis Distribution Partner API. يستدعي وكيلك الأدوات بدلًا من نقاط النهاية، وتعمل كل أداة كما يعمل استدعاء REST الذي تستند إليه.
عند المقارنة بين خوادم MCP الخاصة بالسفر، يتوقف معظم الأمر على ثلاثة أسئلة: من أين يأتي التوريد، ومن يتحكم فيما يُسمح للوكيل بفعله، وهل الحجز حقيقي. هنا التوريد هو ما تديره وكالة أو منظّم رحلات في Adrasis Console، ويتحكم هذا المالك في الوصول عبر حساب شريك وصلاحياته. ويُنشئ استدعاء book الناجح الحجز ويُنقص المخزون، كما يفعل الحجز عبر REST.
لا يُعاد تفسير شيء من أجل الوكلاء. تستخدم الأدوات مخططات الطلب والاستجابة ومنطق الأعمال والتسعير وقواعد الاستخدام نفسها التي يستخدمها عقد REST، فيعمل الوكيل والتكامل التقليدي وفق مجموعة قواعد واحدة.
# خادم MCP يعمل عن بُعد، streamable HTTP https://ari.console.adrasis.com/mcp # رمز وصول OAuth 2.0 Authorization: Bearer <access token>
يمكن للوكيل أيضًا تجاوز MCP واستدعاء عقد REST مباشرة. والعقد الكامل القابل للقراءة آليًا منشور في مرجع API (بالإنجليزية).
خادم MCP مخصص لوكيل ذكاء اصطناعي يحجز من توريد شركة أخرى عبر حساب شريك. أما مشغّل الذكاء الاصطناعي فيُنجز العمل داخل مؤسستك أنت.
يشارك في ذلك طرفان. مالك المخزون وكالة أو منظّم رحلات يحتفظ بعقوده وأسعاره في Adrasis Console. والشريك هو من يبني الوكيل: وكالة سفر إلكترونية (OTA) أو تطبيق سفر أو وكالة أخرى أو شريك تقني. يُنشئ المالك حساب شريك، ويتيح للشريك أماكن الإقامة التي يجوز له حجزها، ويُصدر بيانات الاعتماد، ولا يعمل الوكيل إلا داخل ذلك الحساب.
يرسل فريقك الأوامر عبر لوحة الدردشة في Console أو البريد الإلكتروني أو WhatsApp. ويُعِدّ مشغّل الذكاء الاصطناعي العمل على الكتالوج والأسعار والعقود والتوزيع الخاصة بك. وتُستخدم رسائل SMS للتنبيهات وموافقات العمليات. ويُجاب فورًا عن الطلبات التي تقتصر على قراءة البيانات. أما كل ما يغيّر البيانات فتُعرض معاينته ولا يُنفَّذ إلا بعد تأكيدك، ولا يقرأ مشغّل الذكاء الاصطناعي بيانات أي مؤسسة أخرى أبدًا. اطّلع على طريقة عمل مشغّل الذكاء الاصطناعي.
تقابل كل أداة عملية REST واحدة وتستخدم مخططات الطلب والاستجابة الخاصة بها. والأدوات مجمّعة حسب المنتج، وتحتاج كل منها إلى إحدى صلاحيتين.
البيانات المرجعية ومحتوى أماكن الإقامة والبحث عن التوافر ودورة الحجز الكاملة للفنادق وبيوت العطلات والفلل والشقق. «أماكن الإقامة المفتوحة» هي قائمة أماكن الإقامة المفتوحة لملف شريك واحد.
| الأداة | وظيفتها | الصلاحية |
|---|---|---|
search_property_availability |
ابحث عن العرض الأقل سعرًا لكل مكان إقامة، حتى 200 مكان إقامة. | distribution:read |
search_place_availability |
ابحث عن العروض الأقل سعرًا في وجهة ما، حتى 100 مكان إقامة في الصفحة. | distribution:read |
list_countries |
اعرض قائمة الدول مع المعرّفات ورموز ISO والأسماء المترجمة. | distribution:read |
list_place_types |
اعرض أنواع الأماكن الثمانية وأيها قابل للبحث في كل دولة. | distribution:read |
list_places |
ابحث عن الوجهات حسب الدولة أو النوع أو المكان الأم أو الاسم. | distribution:read |
list_properties |
اعرض محتوى أماكن الإقامة من «أماكن الإقامة المفتوحة»، دون أسعار. | distribution:read |
get_property |
اقرأ المحتوى الكامل لمكان إقامة واحد. | distribution:read |
prebook |
احسب سعر العرض المختار من جديد؛ وأرجِع رمز الحجز المبدئي وحالة المطابقة وسياسة الإلغاء. | distribution:booking |
book |
أكّد الحجز، مع مفتاح منع التكرار لإعادة المحاولة بأمان. | distribution:booking |
get_booking |
اقرأ حجزًا واحدًا، أو استعلم دوريًا عن حجز معلّق. | distribution:booking |
list_bookings |
طابِق الحجوزات حسب مرجعك أو فترة زمنية أو التغييرات الأخيرة. | distribution:booking |
cancellation_quote |
عاين رسوم الإلغاء دون تغيير أي شيء. | distribution:booking |
cancel |
ألغِ الحجز وطبّق رسومه. يمكن تكرار الطلب بأمان. | distribution:booking |
البحث عن العروض في مكان إقامة واحد متاح عبر REST فقط. يُرجع أفضل عرض لمجموعة المسافرين كاملة، يليه كل خيار متاح من الغرف وخطط الأسعار لكل غرفة مطلوبة، من الأرخص إلى الأغلى مع كميات قابلة للاختيار.
يتبع كل منتج نمط البحث والحجز المبدئي والحجز نفسه المتبع في الإقامة. الرحلات الجوية رحلات طيران عارض، ويُبحث عن رحلة الذهاب والعودة كرحلتين منفصلتين.
| الأداة | وظيفتها | الصلاحية |
|---|---|---|
search_transfers |
ابحث عن عروض خدمات النقل بين منطقتين لتاريخ خدمة ومجموعة مسافرين. | distribution:booking |
prebook_transfer |
أعد تسعير عرض خدمة النقل وأرجِع رمز حجز مبدئي مع شروط إلغائه. | distribution:booking |
book_transfer |
أكّد خدمة النقل باستخدام مفتاح منع التكرار. | distribution:booking |
search_tours |
ابحث عن عروض جولة في تاريخ مغادرة لمجموعة مسافرين. | distribution:booking |
prebook_tour |
أعد تسعير عرض الجولة وأرجِع رمز حجز مبدئي مع شروط إلغائه. | distribution:booking |
book_tour |
أكّد الجولة باستخدام مفتاح منع التكرار. | distribution:booking |
search_flights |
ابحث عن عروض رحلات الطيران العارض لتاريخ مغادرة وتركيبة ركاب. | distribution:booking |
prebook_flight |
أعد تسعير عرض الرحلة الجوية وأرجِع رمز حجز مبدئي مع شروط إلغائه. | distribution:booking |
book_flight |
أكّد حجز الرحلة الجوية باستخدام مفتاح منع التكرار. | distribution:booking |
تضمّ الباقة من 2 إلى 8 خدمات اختارها الوكيل مسبقًا، من نوعين من المنتجات على الأقل، وتُباع بسعر شامل واحد. إما أن تُؤكَّد كل الخدمات أو لا تُؤكَّد أي منها. بعد الحجز، تُسترجع الباقة وتُلغى باستخدام get_booking وcancellation_quote وcancel، ويمكن توجيه الأداتين الأخيرتين أيضًا إلى خدمات منفردة داخلها.
| الأداة | وظيفتها | الصلاحية |
|---|---|---|
search_packages |
اجمع من 2 إلى 8 خدمات مختارة في عرض واحد بسعر شامل واحد. | distribution:booking |
prebook_package |
أعد التحقق من كل خدمة وأرجِع حالة المطابقة وإفصاح الامتثال ورمز حجز مبدئي. | distribution:booking |
book_package |
احجز الباقة كاملة دفعة واحدة: إما أن تُؤكَّد كل الخدمات أو لا تُؤكَّد أي منها. | distribution:booking |
تجمع الرحلة حجوزات مؤكدة بالفعل في خط سير واحد. يحتفظ كل حجز بإجماليه وسياسة إلغائه ودورة حياته، فلا تكون الرحلة أبدًا باقة مسعّرة.
| الأداة | وظيفتها | الصلاحية |
|---|---|---|
create_trip |
اجمع الحجوزات المؤكدة في رحلة واحدة. تبقى أسعارها منفصلة. | distribution:booking |
get_trip |
اقرأ رحلة مع حجوزاتها وإجمالياتها حسب كل عملة. | distribution:booking |
add_trip_member |
أضف حجزًا قائمًا إلى رحلة. | distribution:booking |
remove_trip_member |
أخرِج حجزًا من رحلة دون تغيير الحجز. | distribution:booking |
cancel_trip |
ألغِ كل حجوزات الرحلة وأبلغ عن نتيجة كل منها. | distribution:booking |
يتكون المسار الموثّق من ثماني خطوات، من الجغرافيا إلى الإلغاء. يتوقف الوكيل مرتين لينتظر تأكيد مستخدمه: قبل الحجز وقبل الإلغاء.
list_countries وlist_place_types وlist_places للعثور على الدولة وأنواع الأماكن التي يمكن البحث فيها هناك والوجهة نفسها، مثل أنطاليا.list_properties وget_property. لا تقبل أيٌّ منهما نقطة بيع.search_property_availability لأماكن إقامة معروفة، أو search_place_availability لاستعراض وجهة كاملة. حدّد طريقة توزيع الغرف: strict يُبقي كل غرفة كما طُلبت تمامًا، وflexible يتيح توزيع مجموعة المسافرين على ما يصل إلى تسع غرف. احتفظ بقيمة selection_token للعرض المختار على جانب الخادم.prebook، الذي يعيد تسعير العرض. اقرأ حالة المطابقة وسياسة الإلغاء، ثم أكّدهما مع المستخدم.book مع بيانات الضيوف وبيانات الاتصال وidempotency_key فريد. إعادة المحاولة بالمفتاح نفسه ومتن الطلب دون تغيير خلال 24 ساعة من الطلب الأول تُرجع الحجز الأصلي بدل إنشاء حجز ثانٍ.get_booking حتى تستقر الحالة.list_bookings، اعتمادًا على مرجعك الخاص agency_reference أو نطاق زمني محدد للتواريخ أو للتغييرات. لا تتضمن النتائج أي بيانات شخصية للضيوف.cancellation_quote، ولا تستدعِ cancel إلا عندما يؤكد المستخدم.الحجز المبدئي لا يحتجز المخزون. يُعاد التحقق من التوافر عند تشغيل book، لذا قد تذهب الغرفة الأخيرة إلى شخص آخر بين الخطوتين، فيبحث الوكيل من جديد. رمز الحجز المبدئي صالح لمدة 30 دقيقة ولا يصلح إلا لحجز واحد.
لا تمر أي عملية دفع عبر الخادم. يبقى الشريك هو التاجر المسجَّل (merchant of record). الأسعار التي تتطلب خطوة دفع في مكان آخر، مثل خصم من البطاقة أو جدول دفعات مقدمة، لا يمكن حجزها بهذه الطريقة.
ببيانات اعتماد العميل نفسها في OAuth 2.0 التي يستخدمها تكامل REST. تُثبت جلسة الوكيل هويتها تمامًا كما يفعل عميل REST.
يستبدل الشريك معرّف العميل وسر العميل برمز وصول عبر https://ari.console.adrasis.com/api/v1/oauth/token. الرمز صالح لمدة ساعة واحدة، ولا يُصدَر رمز تحديث: عند انتهاء صلاحيته، يطلب الوكيل رمزًا جديدًا ببيانات الاعتماد نفسها. توصي الوثائق بالاحتفاظ برمز واحد وتجديده قبيل انتهاء صلاحيته، بدل طلب رمز لكل استدعاء.
يُرسَل الرمز في ترويسة Authorization لجلسة MCP. يُمرَّر حساب الشريك وصلاحيات الرمز دون تغيير في كل استدعاء لأداة، ويُرفض استدعاء أي أداة تتطلب صلاحية لا يملكها الرمز.
| الصلاحية | ما تشمله |
|---|---|
distribution:read |
البيانات المرجعية ومحتوى أماكن الإقامة والبحث عن توافر الإقامة. |
distribution:booking |
الحجز المبدئي للإقامة والحجز وقراءة الحجوزات وعروض أسعار الإلغاء والإلغاء، إضافة إلى كل أدوات خدمات النقل والجولات والرحلات الجوية والباقات والرحلات، بما فيها أدوات البحث الخاصة بها. |
امنح الوكيل ما يحتاج إليه فقط. الوكيل الذي يجيب عن أسئلة التوافر ويجب ألا يحجز أبدًا يحصل على distribution:read وحدها. تحصل بيانات الاعتماد الجديدة على الصلاحيتين افتراضيًا، لذا اختر الحد الأدنى عند إنشاء بيانات اعتماد لوكيل. ويمكن أيضًا طلب رمز بصلاحيات أقل مما تملكه بيانات اعتماده. رموز الأخطاء وبقية التفاصيل في دليل التحقق من الهوية (بالإنجليزية).
ما فتحه له مالك المخزون فقط. أما في الإقامة، فهو قائمة «أماكن الإقامة المفتوحة» في ملف شريك واحد.
تعيد أدوات أماكن الإقامة أماكن الإقامة المنشورة المفتوحة صراحةً في «أماكن الإقامة المفتوحة» للملف المحدد، ولا شيء غيرها. يبدأ كل حساب شريك بالملف «الافتراضي» الذي يضم لقطة لأماكن الإقامة التي كانت منشورة عند إنشاء الحساب. ويبقى مكان الإقامة الذي يُنشر لاحقًا غير مفتوح للشريك إلى أن يفتحه له المالك. وإغلاق مكان إقامة يخرجه من نتائج ذلك الملف دون حذفه أو إغلاقه في الملفات الأخرى.
عندما يحتاج الشريك نفسه إلى كتالوجات منفصلة لجماهير مختلفة، يضيف المالك ملفات أخرى إلى الحساب. تقبل الأدوات المرتبطة بالملف المعامل الاختياري profile_public_id: لا ترسله لاستخدام الملف الافتراضي، أو أرسله لاختيار ملف آخر من الحساب نفسه. وتذكر كل نتيجة ناجحة الملف الذي استُخدم فعلًا. بيانات الاعتماد تابعة للحساب، لذا تعمل بيانات اعتماد واحدة مع كل الملفات.
تعرض list_properties وget_property ما هو مفتوح للملف، ولا تقبلان نقطة بيع. ولا توسّع الأسعار أو المخزون أو قواعد الوجهات نطاقهما ولا تضيّقه. أما إمكانية بيع إقامة لمسافر فتحددها أدوات التوافر وحدها، وهي تقبل نقطة بيع المسافر في صورة رمز بلد.
list_bookings هي الاستثناء من اختيار الملف. فهي تقرأ الحجوزات في الحساب كله، ولا يفعل profile_public_id فيها سوى حصر التقرير في الحجوزات التي أنشأها ملف واحد.
يُعِدّ مالك المخزون حساب الشريك في Adrasis Console. ويُستخدم المضيف نفسه للتطوير والاعتماد والتشغيل الفعلي.
يفتح المالك «الاتصال»، ثم «قنوات البيع» و«شركاء API» و«حسابات الشركاء»، وينشئ حسابًا واحدًا للعلاقة. ويأتي معه الملف الافتراضي.
يفتح المالك أماكن الإقامة المقصودة في كل ملف: واحدًا تلو الآخر، أو كمجموعة، أو عبر عوامل التصفية حسب البلد والمكان.
بيانات اعتماد باسم مستقل لكل بيئة، بأدنى الصلاحيات. يُعرض السر مرة واحدة فقط، لذا يُحفظ مباشرة في أداة لإدارة الأسرار.
تتيح بيانات الاعتماد التجريبية الوصول إلى كتالوج توضيحي. وعند الترقية إلى التوريد الفعلي، يبقى معرّف العميل والمضيف وسير التكامل كما هي.
يحتوي الكتالوج التوضيحي على أسعار وبيانات توافر مولَّدة للاختبار، ولا تؤثر الحجوزات التجريبية في المخزون الفعلي ولا تنشئ رسومًا. ومع ذلك ألغِ كل حجز تجريبي: فالحجز التجريبي المفتوح يشغَل مخزونًا توضيحيًا، وقد تبدأ الاختبارات المتكررة بإرجاع SOLD_OUT.
لا يُنشر حد ثابت للطلبات. يُتفق على حدود الطلبات لكل اتصال، فتحقّق منها مع جهة اتصالك في Adrasis قبل زيادة حجم الطلبات. وإضافة بيانات اعتماد أو ملفات لا تزيد الحصة المسموح بها. يستطيع المالك تدوير بيانات الاعتماد أو تعطيلها أو إبطالها من تبويب «الوصول عبر API» في الحساب، وتتوقف بيانات الاعتماد المعطّلة أو المبطلة عن العمل مع رموز الوصول الصادرة منها.
ما يخص المالك مشروح في شركاء API وبيانات الاعتماد (بالإنجليزية). إذا كان فريقك يبني وكيل ذكاء اصطناعي للسفر ويريد أن يصبح شريكًا، تواصل معنا.
اطلب الوصول إلى Console لإعداد توريدك الخاص، أو أخبرنا عن الوكيل الذي تبنيه والوصول الذي يحتاجه.