Xrm.Copilot (مرجع واجهة برمجة تطبيقات العميل)

يوفر أساليب للتفاعل مع Microsoft Copilot في Power Apps المستندة إلى النموذج، بما في ذلك معاينة واجهات برمجة التطبيقات لتنفيذ موضوعات Microsoft Copilot Studio المسجلة.

الأساليب المتوفرة بشكل عام

الطريقة الوصف
addActionHandler تسجيل دالة معالج مخصص لإجراء Microsoft Copilot.
addDefaultActionHandlers استعادة المعالجات الافتراضية للنظام الأساسي لإجراء Microsoft Copilot.
getCurrentAgent إرجاع عامل Copilot Microsoft النشطة حاليا، أو غير معرفة إذا لم تكن حالة العامل معروفة بعد.
isM365CopilotEnabled إرجاع ما إذا كان Microsoft Copilot ممكنا في البيئة الحالية.
openM365CopilotPanel فتح اللوحة الجانبية Microsoft Copilot.
removeActionHandler إزالة معالج مخصص مسجل مسبقا لإجراء Microsoft Copilot.
removeDefaultActionHandlers إزالة المعالجات الافتراضية للنظام الأساسي لإجراء Microsoft Copilot.
sendPromptToM365Copilot يرسل مطالبة إلى اللوحة الجانبية Microsoft Copilot، مما يتسبب في معالجة Copilot والاستجابة نيابة عن المستخدم.
updateالسياق يرسل سياق التطبيق المحدث إلى اللوحة الجانبية Microsoft Copilot.

أساليب المعاينة

الطريقة الوصف
حدث التنفيذ (معاينة) تنفيذ موضوع Microsoft Copilot Studio استنادا إلى اسم الحدث المسجل. إرجاع صفيف من نوع MCSResponse.
executePrompt (معاينة) تنفيذ موضوع Microsoft Copilot Studio استنادا إلى استعلامات المشغل المسجلة في الموضوع. إرجاع الصفيف من نوع MCSResponse.

الواجهات

الواجهة الوصف
M365CopilotAgent توضح هذه المقالة عامل Copilot Microsoft النشطة حاليا — التي تم إرجاعها بواسطة getCurrentAgent.
M365CopilotAgentMode توضح هذه المقالة كيفية الإشارة إلى عامل Copilot Microsoft.
MCSResponse يصف البيانات التي تم إرجاعها بواسطة أساليب executeEvent و executePrompt .
PowerAppsContent توضح هذه المقالة بيانات السياق التي تم تمريرها إلى أسلوب updateContext . جميع الخصائص اختيارية.
SendPromptToM365CopilotOptions يصف المعلمات الاختيارية التي تم تمريرها إلى أسلوب sendPromptToM365Copilot .

كائن Xrm لواجهة برمجة تطبيقات العميل