خادم MCP لحجز السفر
لوكلاء الذكاء الاصطناعي.

تشغّل Adrasis خادم Model Context Protocol (MCP) مبنيًّا على Distribution Partner API الخاصة بها. يبحث وكلاء الذكاء الاصطناعي عن أماكن الإقامة وخدمات النقل والجولات ورحلات الطيران العارض والباقات ويحجزونها وفق قواعد API، داخل حساب شريك.

خادم MCP يعمل عن بُعد مبني على Partner 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.

خادم 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

كيف يحجز الوكيل إقامة؟

يتكون المسار الموثّق من ثماني خطوات، من الجغرافيا إلى الإلغاء. يتوقف الوكيل مرتين لينتظر تأكيد مستخدمه: قبل الحجز وقبل الإلغاء.

  1. حدّد الجغرافيا. استدعِ list_countries وlist_place_types وlist_places للعثور على الدولة وأنواع الأماكن التي يمكن البحث فيها هناك والوجهة نفسها، مثل أنطاليا.
  2. ابنِ السياق دون أسعار. اقرأ محتوى أماكن الإقامة من «أماكن الإقامة المفتوحة» باستخدام list_properties وget_property. لا تقبل أيٌّ منهما نقطة بيع.
  3. ابحث. استدعِ search_property_availability لأماكن إقامة معروفة، أو search_place_availability لاستعراض وجهة كاملة. حدّد طريقة توزيع الغرف: strict يُبقي كل غرفة كما طُلبت تمامًا، وflexible يتيح توزيع مجموعة المسافرين على ما يصل إلى تسع غرف. احتفظ بقيمة selection_token للعرض المختار على جانب الخادم.
  4. احجز مبدئيًا. مرّر هذا الرمز إلى prebook، الذي يعيد تسعير العرض. اقرأ حالة المطابقة وسياسة الإلغاء، ثم أكّدهما مع المستخدم.
  5. احجز. استدعِ book مع بيانات الضيوف وبيانات الاتصال وidempotency_key فريد. إعادة المحاولة بالمفتاح نفسه ومتن الطلب دون تغيير خلال 24 ساعة من الطلب الأول تُرجع الحجز الأصلي بدل إنشاء حجز ثانٍ.
  6. استعلم دوريًا. إذا عاد الحجز بحالة قيد الانتظار، كما في سعر ينتظر قبول مكان الإقامة، فاستدعِ get_booking حتى تستقر الحالة.
  7. طابِق. طابِق الحجوزات على مستوى الحساب باستخدام list_bookings، اعتمادًا على مرجعك الخاص agency_reference أو نطاق زمني محدد للتواريخ أو للتغييرات. لا تتضمن النتائج أي بيانات شخصية للضيوف.
  8. ألغِ عند الطلب. اعرض الرسوم باستخدام 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. ويُستخدم المضيف نفسه للتطوير والاعتماد والتشغيل الفعلي.

  1. حساب الشريك

    يفتح المالك «الاتصال»، ثم «قنوات البيع» و«شركاء API» و«حسابات الشركاء»، وينشئ حسابًا واحدًا للعلاقة. ويأتي معه الملف الافتراضي.

  2. أماكن الإقامة المفتوحة

    يفتح المالك أماكن الإقامة المقصودة في كل ملف: واحدًا تلو الآخر، أو كمجموعة، أو عبر عوامل التصفية حسب البلد والمكان.

  3. بيانات الاعتماد

    بيانات اعتماد باسم مستقل لكل بيئة، بأدنى الصلاحيات. يُعرض السر مرة واحدة فقط، لذا يُحفظ مباشرة في أداة لإدارة الأسرار.

  4. الاعتماد والانتقال إلى التشغيل الفعلي

    تتيح بيانات الاعتماد التجريبية الوصول إلى كتالوج توضيحي. وعند الترقية إلى التوريد الفعلي، يبقى معرّف العميل والمضيف وسير التكامل كما هي.

يحتوي الكتالوج التوضيحي على أسعار وبيانات توافر مولَّدة للاختبار، ولا تؤثر الحجوزات التجريبية في المخزون الفعلي ولا تنشئ رسومًا. ومع ذلك ألغِ كل حجز تجريبي: فالحجز التجريبي المفتوح يشغَل مخزونًا توضيحيًا، وقد تبدأ الاختبارات المتكررة بإرجاع SOLD_OUT.

لا يُنشر حد ثابت للطلبات. يُتفق على حدود الطلبات لكل اتصال، فتحقّق منها مع جهة اتصالك في Adrasis قبل زيادة حجم الطلبات. وإضافة بيانات اعتماد أو ملفات لا تزيد الحصة المسموح بها. يستطيع المالك تدوير بيانات الاعتماد أو تعطيلها أو إبطالها من تبويب «الوصول عبر API» في الحساب، وتتوقف بيانات الاعتماد المعطّلة أو المبطلة عن العمل مع رموز الوصول الصادرة منها.

ما يخص المالك مشروح في شركاء API وبيانات الاعتماد (بالإنجليزية). إذا كان فريقك يبني وكيل ذكاء اصطناعي للسفر ويريد أن يصبح شريكًا، تواصل معنا.

هل أنت مستعد لربط وكيل؟

اطلب الوصول إلى Console لإعداد توريدك الخاص، أو أخبرنا عن الوكيل الذي تبنيه والوصول الذي يحتاجه.