executePrompt (مرجع واجهة برمجة تطبيقات العميل) (معاينة)

هام

• هذه ميزة إصدار أولي.
• الهدف من ميزات المعاينة ليس الاستخدام في الإنتاج وقد يكون لها دالات مقيدة. تخضع هذه الميزات لشروط الاستخدام التكميلية، وهي متاحة قبل الإصدار الرسمي حتى يتمكن العملاء من الوصول المبكر وتقديم التعليقات.

تنفيذ موضوع Microsoft Copilot Studio استنادا إلى استعلامات المشغل المسجلة في الموضوع. إرجاع الصفيف من نوع MCSResponse.

بناء الجملة

Xrm.Copilot.executePrompt(promptText).then(successCallback, errorCallback);

المعلمات

اسم المعلمة	نوع	مطلوبة	Description
promptText	string	‏‏نعم‬	النص المسجل ك استعلام مشغل في موضوع MCS.
successCallback	الدالة	‏‏نعم‬	وظيفة للاتصال عند نجاح العملية.
errorCallback	الدالة	‏‏نعم‬	وظيفة للاتصال عند فشل العملية.

قيمة الإرجاع

صفيف MCSResponse

مثال

في Microsoft Copilot Studio، يتم تشغيل موضوع بواسطة استعلامات مثل "hello" أو "hi". عند executePrompt التشغيل مع مطابقة promptText، فإنه يقوم بتنشيط الموضوع وإرجاع نشاط رسالة مع نص الاستجابة.

const response = await Xrm.Copilot.executePrompt("hello"); 

Response

هذا مثال على الاستجابة التي قد يتم إرجاعها.

[
    {
        "type": "message",
        "timestamp": "2025-02-05T16:46:07.7799759+00:00",
        "replyToId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "attachments": [],
        "textFormat": "markdown",
        "text": "Hello, how can I help you today?",
        "speak": "Hello, <break strength=\"medium\" /> how can I help?"
    }
]

المقالات ذات الصلة

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