التطبيقات المتصلة

المنصة الأساسية

connected_apps_readوكيل الذكاء الاصطناعي

يعرض التطبيقات الخارجية (البريد الإلكتروني، والتقويم، وCRM، والمراسلة، ...) التي ربطها جهاز وكيل ذكاء اصطناعي، مع حساباتها، وخدمات Performance Hub المدمجة، والتطبيقات المميزة، وطلبات الربط المعلّقة. تنتمي الاتصالات إلى جهاز وكيل واحد. مرّر search للعثور على أي تطبيق قابل للربط وslug الخاص به. تعمل أدوات التطبيقات المتصلة عبر خادم MCP المنفصل "connected_apps" (PH_APPS_SEARCH_TOOLS، ثم PH_APPS_MULTI_EXECUTE_TOOL).

الإجراءات:

list: عرض Connected Apps. تعرض التطبيقات المتصلة كل حساب (id، وalias، وhealthy)؛ مرّر alias أو id بوصفه account عند تشغيل أدوات ذلك التطبيق.

المعلمات

الاسم	النوع	الوصف
`action`*	`"list"`	الإجراء المطلوب؛ كل إجراء موصوف في وصف الأداة.
`deviceId`	`string`	deviceUuid لوكيل الذكاء الاصطناعي من device_inventory_read. يعمل الوكلاء على أنفسهم، لذا يتركونه؛ ويمكن للأشخاص تركه عندما يكون في المنشأة وكيل واحد.
`search`	`string`	البحث في الكتالوج الكامل بالاسم أو slug أو الفئة أو الوصف، مثل "accounting"
`facilityId`	`string`	معرّف المنشأة. اختياري إذا كانت المنشأة المتصلة هي المقصودة.

connected_apps_writeوكيل الذكاء الاصطناعي

يطلب ربط تطبيق خارجي بجهاز وكيل ذكاء اصطناعي حتى تصبح أدواته متاحة. اعثر على slug التطبيق باستخدام connected_apps_read أولًا. يُشعر مالك الوكيل والشخص الموجود في المحادثة (مرة واحدة يوميًا كحد أقصى لكل تطبيق) ويعيد رابط ربط للمحادثة؛ ومن يسجّل الدخول عبر ذلك الرابط يصبح الحساب الذي يعمل الوكيل باسمه، لذا شاركه بحذر.

الإجراءات:

request_connect: طلب ربط. التطبيقات المتصلة بالفعل تعيد حساباتها بدلًا من ذلك، ما لم يُمرَّر alias لإضافة حساب آخر. يتطلب toolkit.

المعلمات

الاسم	النوع	الوصف
`action`*	`"request_connect"`	الإجراء المطلوب؛ كل إجراء موصوف في وصف الأداة.
`deviceId`	`string`	deviceUuid لوكيل الذكاء الاصطناعي من device_inventory_read. يعمل الوكلاء على أنفسهم، لذا يتركونه؛ ويمكن للأشخاص تركه عندما يكون في المنشأة وكيل واحد.
`toolkit`	`string`	slug التطبيق من connected_apps_read list أو search
`reason`	`string`	سبب حاجة الوكيل إلى التطبيق؛ ويظهر للأشخاص الذين يتلقون الإشعار
`alias`	`string`	تسمية لحساب إضافي لتطبيق متصل بالفعل، مثل عنوان صندوق البريد
`facilityId`	`string`	معرّف المنشأة. اختياري إذا كانت المنشأة المتصلة هي المقصودة.