executePrompt (הפניה ל- API של לקוח) (תצוגה מקדימה)

חשוב

• ‏‫‏‫זוהי תכונת Preview.‬‬
• תכונות Preview אינן מיועדות לשימוש בייצור וייתכן שיש להן פונקציונליות מוגבלת. תכונות אלה כפופות לתנאי השימוש המשלימים והן זמינות לפני הפצה רשמית, כך שהלקוחות יכולים לקבל גישה מוקדמת ולספק משוב.

(תצוגה מקדימה) ביצוע Microsoft Copilot Studio מבוסס על שאילתות הגורם המפעיל הרשום בנושא. הפונקציה מחזירה את המערך מסוג MCSResponse.

תחביר

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

פרמטרים

שם פרמטר	Type	נדרש	תיאור
promptText	מחרוזת	כן	הטקסט הרשום כשאילתת גורם מפעיל בנושא MCS.
successCallback	Function	כן	פונקציה שיש לקרוא לה כאשר הפעולה מצליחה.
errorCallback	Function	כן	פונקציה שיש לקרוא לה כאשר הפעולה נכשלת.

ערך החזרה

מערך של 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 (חומר עזר עבור API של לקוח)