ChatAman Docsby CodeEra
English فتح المنصة

التوثيق

مرجع أدوات MCP في شات أمان

كل الأدوات التي يوفرها خادم MCP في شات أمان، مقسمة حسب المجال، مع الصلاحية التي تحتاجها كل أداة.

لا يرى المساعد إلا الأدوات المسموح بها لاتصاله. ابدأ كل جلسة بالأداة get_connection_context.

الاتصال والحسابات

الأداة الصلاحية الوظيفة
get_connection_context أي اتصال اسمك والمؤسسة والتوقيت والصلاحيات وحالة التأكيد
list_connected_accounts عرض الحسابات الحسابات المرتبطة وحالة قدراتها الآن
get_account_capabilities عرض الحسابات ما يستطيع حساب واحد فعله وحدود منصته

الوسائط

الأداة الصلاحية الوظيفة
list_media_assets عرض الوسائط تصفح مكتبة الوسائط أو أصول المحتوى
get_media_asset_details عرض الوسائط تفاصيل وسيط واحد
create_media_upload رفع الوسائط فتح جلسة رفع قصيرة المدة
complete_media_upload رفع الوسائط التحقق من الملف المرفوع وإضافته للمكتبة
get_media_upload_status رفع الوسائط حالة جلسة الرفع

المنشورات

الأداة الصلاحية الوظيفة
list_posts / get_post_details / get_post_status عرض المنشورات قراءة المنشورات ونتيجة النشر لكل حساب
list_scheduled_posts عرض المنشورات المنشورات المجدولة القادمة
validate_post عرض المنشورات تشغيل كل فحوص النشر دون أي تغيير
get_post_approval_status عرض المنشورات حالة موافقة المنشور
get_operation_status عرض المنشورات متابعة عملية نشر أو جدولة
create_post_draft / update_post_draft كتابة المسودات إنشاء المسودات وتعديلها
submit_post_for_approval طلب الموافقة إرسال مسودة للمراجعة
publish_post النشر والجدولة النشر الآن
schedule_post / reschedule_post النشر والجدولة الجدولة أو تغيير موعد منشور مجدول
cancel_scheduled_post إلغاء الجدولة إيقاف منشور مجدول
edit_published_post تعديل المنشورات المنشورة تغيير نص منشور منشور
delete_published_post حذف المنشورات المنشورة حذف منشور منشور

التعليقات

الأداة الصلاحية الوظيفة
list_comments / get_comment_details قراءة التعليقات قراءة التعليقات (موسومة كنص غير موثوق)
draft_comment_reply الرد على التعليقات اقتراح رد للاعتماد
reply_to_comment الرد على التعليقات إرسال رد اعتمده شخص
mark_comment_for_review الرد على التعليقات تحويل تعليق لمراجعة شخص

التحليلات

الأداة الصلاحية الوظيفة
get_post_analytics عرض التحليلات مؤشرات المنشور المخزنة لكل منصة
get_account_insights عرض التحليلات إحصاءات يومية للحساب مع إظهار الأيام الناقصة
get_publishing_report عرض التحليلات نتائج النشر المسجلة لكل حساب

المبيعات والحجوزات

الأداة الصلاحية الوظيفة
search_products عرض الطلبات والحجوزات والمبيعات البحث في المنتجات والخدمات
list_bookings / get_booking عرض الطلبات والحجوزات والمبيعات قراءة الحجوزات والطلبات
sales_summary عرض الطلبات والحجوزات والمبيعات إجمالي المبيعات حسب اليوم أو الموظف أو الفرع أو المنتج
create_booking إنشاء وتعديل الحجوزات إنشاء حجز أو طلب
update_booking_status إنشاء وتعديل الحجوزات تغيير حالة الحجز إلى حضر أو لم يحضر أو محجوز أو ملغى

قواعد تتبعها كل الأدوات

  • تعديل أي منشور يحتاج expected_version من آخر قراءة، حتى لا يكتب المساعد فوق تعديل أحدث.
  • العمليات ذات الأثر الخارجي تحتاج idempotency_key، وإعادة المحاولة بنفس المفتاح لا تكرر العملية.
  • النتيجة بالحالة accepted تعني أن العملية في قائمة التنفيذ وليست منشورة بعد. تابعها بالأداة get_operation_status.
  • نص التعليقات وأي محتوى من أطراف خارجية بيانات، وليس تعليمات.