Data Actions: واجهة API الخاصة بك كأداة
حوّل نقطة API لديك بالفعل إلى شيء يستطيع المساعد استدعاءه.
Data Actions (إجراءات البيانات) مخصصة لما يسأل عنه عملاؤك ولا يستطيع أي مستند الإجابة عنه: «أين طلبي؟»، «كم بقي في المستودع؟»، «هل ما زالت عضويتي سارية؟». الإجابة موجودة في نظامك أنت، خلف API. إجراء البيانات هو تلك النقطة، موصوفة مرة واحدة، ليستطيع المساعد استدعاءها أثناء المحادثة والإجابة بالرقم الحقيقي.
نصيحة: ليس لديك API خاص بك؟ تجاوز هذه الصفحة. المساعد مكتمل من دونها — هذه مخصصة للفرق التي تتعامل أنظمتها بـ HTTP أصلًا.
كيف يختلف هذا عن API Connections#
كلاهما يمنح المساعد أدوات؛ ويختلفان في من يشغّل الخادم. API Connections تربط خادم MCP موجودًا بالفعل ويعرض أدواته الخاصة. أما Data Actions فهي لحالة عدم وجود مثل هذا الخادم: تصف نقاط API هنا ويقدّمها Pommy للمساعد كأدوات. وإذا كان لـ API الخاص بك مستند OpenAPI، فلا تصف شيئًا يدويًا — استورده فتصل النقاط كمجموعة.
المجموعات والإجراءات#
توجد الإجراءات داخل مجموعات. المجموعة نظام واحد — «API الطلبات»، «المستودع» — لها عنوانها الأساسي، ومصادقتها الخاصة إن احتاجت. وداخلها، كل إجراء نقطة واحدة: اسم يراه المساعد، ووصف لمتى يُستخدم، والطريقة والمسار، والمعاملات. اكتب الوصف للمساعد لا للمطوّر: فهو الشيء الوحيد الذي يخبره *متى* يكون هذا الإجراء هو المناسب.
إضافة إجراء#
- أنشئ مجموعة
افتح Data Actions من القائمة اليسرى وأنشئ مجموعة للنظام الذي تربطه. أعطها العنوان الأساسي، وإذا كان API يحتاج إلى بيانات اعتماد فأضفها هنا — تُحفظ مع المجموعة ولا تتكرر لكل إجراء.
- أضف الإجراءات، أو استوردها
أضف النقاط واحدة تلو الأخرى، أو استخدم Import from OpenAPI (استيراد من OpenAPI) ودع Pommy يقرأ المستند. تصل الإجراءات المستوردة متوقفة لتراجعها قبل أن يعمل أي شيء فعليًا.
- فعّل ما يُسمح للمساعد باستخدامه
لكل إجراء مفتاحه الخاص، وللمجموعة كذلك. فعّل فقط ما يحتاجه هذا المساعد حقًا — الإجراء المتوقف غير مرئي له.
إجراءات تحتاج إلى معرفة من يسأل#
بعض الإجابات شخصية — فالطلب يخص عميلًا واحدًا. يمكن تحديد مجموعة على أنها تتطلب التحقق من الهوية، وعندها لا تعمل إجراءاتها إلا إذا كان في المحادثة زائر مُتحقَّق منه. هذا ما يمنع شخصًا غريبًا من السؤال عن طلب شخص آخر.
تحذير: يعمل إجراء البيانات على نظامك الحي بأي بيانات اعتماد أعطيتها للمجموعة. ابدأ بنقاط القراءة فقط؛ ولا تُضف أي شيء يكتب إلا بعد أن تراقب سلوك نقاط القراءة.
اختباره#
بعد تفعيل إجراء، اطرح السؤال الذي قد يطرحه العميل — في الويدجت، وبكلماته، لا باسم النقطة. إذا أجاب المساعد من نظامك، فالوصف يؤدي عمله. وإذا تجاهل الإجراء، فالوصف عادة هو السبب: قل بوضوح عن أي سؤال يجيب الإجراء ومتى يُلجأ إليه.