Partajați prin


executePrompt (referință API client) (previzualizare)

Important

  • Aceasta este o caracteristică de previzualizare.
  • Caracteristicile în regim de previzualizare nu sunt destinate utilizării în producție și pot avea funcționalități restricționate. Aceste funcții sunt supuse termenilor de utilizare suplimentari și sunt disponibile înainte de o lansare oficială, astfel încât clienții să poată avea acces anticipat și să poată oferi feedback.

Execută un subiect Microsoft Copilot Studio pe baza interogărilor declanșatoare înregistrate în subiect. Returnează matricea de tip MCSResponse.

Sintaxă

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

Parametri

Nume parametru Tip Obligatoriu Descriere
promptText string Da Textul care este înregistrat ca interogare de declanșare în subiectul MCS.
successCallback Funcţie Da O funcție de apelat atunci când operațiunea reușește.
errorCallback Funcţie Da O funcție de apelat atunci când operațiunea eșuează.

Valoarea returnată

O matrice de MCSResponse

Exemplu

În Microsoft Copilot Studio, un subiect este declanșat de interogări cum ar fi "salut" sau "salut". Atunci când executePrompt rulează cu promptText potrivit, acesta activează subiectul și returnează o activitate Mesaj cu textul răspunsului.

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

Response

Acesta este un exemplu de răspuns care poate fi returnat.

[
    {
        "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 (referință API client)