executePrompt (αναφορά API προγράμματος-πελάτη) (προεπισκόπηση)

Σημαντικό

• Αυτή είναι μια δυνατότητα προεπισκόπησης.
• Οι δυνατότητες προεπισκόπησης δεν προορίζονται για χρήση στην παραγωγή και μπορεί να έχουν περιορισμένη λειτουργικότητα. Αυτές οι δυνατότητες υπόκεινται σε συμπληρωματικούς όρους χρήσης και διατίθενται πριν από μια επίσημη κυκλοφορία, έτσι ώστε οι πελάτες να μπορούν να αποκτήσουν πρώιμη πρόσβαση και να παρέχουν σχόλια.

Εκτελεί ένα θέμα του Microsoft Copilot Studio με βάση τα ερωτήματα εναύσματος που έχουν καταχωρηθεί στο θέμα. Επιστρέφει τον πίνακα τύπου MCSResponse.

Σύνταξη

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

Παράμετροι

Όνομα παραμέτρου	Type	Απαραίτητο	Περιγραφή
promptText	string	Ναι	Το κείμενο που έχει καταχωρηθεί ως ερώτημα εναύσματος στο θέμα MCS.
successCallback	Function	Ναι	Μια συνάρτηση για κλήση όταν η λειτουργία είναι επιτυχής.
errorCallback	Function	Ναι	Μια λειτουργία για κλήση όταν αποτύχει η λειτουργία.

Τιμή επιστροφής

Ένας πίνακας MCSResponse

Παράδειγμα

Στο Microsoft Copilot Studio, ένα θέμα ενεργοποιείται από ερωτήματα όπως "hello" ή "hi". Όταν executePrompt εκτελείται με αντίστοιχο promptText, ενεργοποιεί το θέμα και επιστρέφει μια δραστηριότητα Μήνυμα με το κείμενο απόκρισης.

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

Απάντηση

Αυτό είναι ένα παράδειγμα της απόκρισης που μπορεί να επιστραφεί.

[
    {
        "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 προγράμματος-πελάτη)