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 (مرجع واجهة برمجة تطبيقات العميل)