المساعدون وأدوات الوكيل
{slug}.qaema.ai/mcp
Section titled “{slug}.qaema.ai/mcp”كل منشأة منشورة تعرض خادم MCP للقراءة فقط على مسارها الخاص /mcp، دون تسجيل دخول ودون جلسة — يستطيع مساعد الزائر الذكي الاتصال به مباشرة. يحمل ست أدوات:
get_venue_info— الاسم، وهل المنشأة مفتوحة الآن، وساعات العمل، والعنوان، ووسائل التواصل والواي فاي، وروابط الحجز/الاستلام/التوصيل.get_menu— القائمة المنشورة كاملة لسياق معين (داخل المطعم، أو الاستلام، أو التوصيل)، بأقسامها وأصنافها، وأسعارها، وسعراتها الحرارية، وشاراتها، وعروضها الحية.search_items— أصناف تطابق كلمة معينة، مع استبعاد مسببات حساسية، واشتراطات غذائية، وسقوف للسعر والسعرات الحرارية.get_item— صنف واحد بمعرّفه، مع قسمه.check_allergens— حكم سلامة لكل صنف ولكل مسبب حساسية (أدناه).find_items— قائمة مفلترة ومرتبة بشكل حتمي، حسب السعر أو السعرات الحرارية أو الاسم.
نتائج search_items وfind_items محدودة بـ 50 صنفًا لكل منها، وكل استدعاء للقراءة فقط — يستطيع المساعد أن ينظر، لا أن يكتب أبدًا.
llms.txt و/.well-known/mcp
Section titled “llms.txt و/.well-known/mcp”{slug}.qaema.ai/llms.txt هو القائمة المنشورة كاملة بصيغة markdown نصية — كل قسم وصنف، والأسعار، والسعرات الحرارية، ومسببات الحساسية، والوسوم الغذائية، وحالة النفاد — قابلة للقراءة في جلب واحد، لمساعد لا يتحدث MCP. /.well-known/mcp وثيقة اكتشاف صغيرة تسمّي خادم MCP الخاص بالمنشأة، ورابطه، وطريقة نقله، لمساعد يبحث هناك أولاً.
البيانات المهيكلة
Section titled “البيانات المهيكلة”تحمل كل صفحة قائمة أيضًا بيانات schema.org المهيكلة — المطعم، وأقسام قائمته، وكل صنف بسعره وسعراته الحرارية وأي أنظمة غذائية يناسبها — بحيث يستطيع مساعد بحث أو تسوق عام قراءتها مباشرة من الصفحة، دون استدعاء أي أداة على الإطلاق.
أحكام سلامة مسببات الحساسية
Section titled “أحكام سلامة مسببات الحساسية”لا يخمّن check_allergens أبدًا: يعود الصنف unsafe حين يكون مسبب الحساسية المطلوب مقرَّرًا عليه أو مدرجًا كخطر “قد يحتوي”، وsafe فقط حين تكون قد أقررت بشيء عن ذلك الصنف ولم يطابق شيء منه، وunknown حين لا يوجد إقرار في أي من الاتجاهين. كل نتيجة تحمل إخلاء مسؤولية بتأكيد الأمر مع الطاقم قبل الطلب إن كانت الحساسية شديدة.
حد المعدل
Section titled “حد المعدل”يسمح MCP العام للقائمة بـ 60 طلبًا في الدقيقة لكل عنوان زائر؛ وتجاوز ذلك يعيد خطأ تجاوز حد المعدل بدلاً من أي بيانات قائمة، ويُتحقَّق من الحد قبل النظر في أي شيء يخص المنشأة.
ما تراه بصفتك المالك
Section titled “ما تراه بصفتك المالك”في كل مرة يبدأ فيها مساعد جلسة مقابل قائمتك — عبر خادم MCP أو جلب llms.txt — يُحتسب ذلك ضمن رقم “عمليات جلب المساعد” في لوحة تحليلاتك، مصنَّفًا حسب العميل الذي أجرى الاستدعاء. يُجمَع هذا تحت مفتاح التحليلات نفسه المستخدَم لكل زيارة أخرى، فتعطيل التحليلات للمنشأة يوقف هذا أيضًا.
توجيه مساعد إلى القائمة
Section titled “توجيه مساعد إلى القائمة”يكفي أن يعطي الزائر مساعده رابط قائمتك، {slug}.qaema.ai — من رمز QR، أو رابط مُشارَك، أو نتيجة بحث. المساعد الذي يدعم MCP يجد نقطة النهاية /mcp من /.well-known/mcp أو من الصفحة نفسها؛ والذي لا يدعمه يستطيع مع ذلك قراءة llms.txt أو البيانات المهيكلة للصفحة مباشرة. لا حاجة لتثبيت أو ضبط أي شيء من جهة الزائر.