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 של לקוח)