executePrompt (תצוגה מקדימה)

חשוב

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

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

זמין עבור

יישומים מונחי-דגמים

תחביר

context.copilot.executeEvent(promptText).then(successCallback, errorCallback);

פרמטרים

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

ערך החזרה

סוג: Promise<MCSResponse>

ראה הבטחהו- MCSResponse

דוגמה

ב- Microsoft Copilot Studio, כאשר נושא מופעל על-ידי שאילתות כגון "hello" או "hi". כאשר executePrompt הוא פועל עם התאמה promptText, הוא מפעיל את הנושא ומחזיר פעילות הודעה עם טקסט התגובה.

const response = await context.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?"
    }
]

מאמרים קשורים

טייס משנה
executeEvent
חומר עזר ל- API של מסגרת רכיב Power Apps
מבט כולל על מסגרת הרכיבים של Power Apps