Partager via


executePrompt (référence de l’API client) (version préliminaire)

Important

  • Cette fonctionnalité est en version préliminaire.
  • Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont soumises à des conditions d’utilisation supplémentaires, et sont disponibles avant une version officielle de telle sorte que les clients puissent tirer parti d’un accès anticipé et fournir leurs commentaires.

Exécute une rubrique Microsoft Copilot Studio en fonction des requêtes de déclencheur enregistrées dans la rubrique. Renvoie le tableau de type MCSResponse.

Syntaxe

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

Paramètres

Nom du paramètre Type Requise Description
promptText chaine Oui Texte inscrit en tant que requête de déclencheur dans la rubrique MCS.
successCallback Function Oui Fonctionnalité à appeler lorsque l’opération aboutit.
errorCallback Function Oui Fonction à appeler lorsque l’opération échoue.

Valeur renvoyée

Un tableau de MCSResponse

Exemple

Dans Microsoft Copilot Studio, une rubrique est déclenchée par des requêtes telles que « bonjour » ou « salut ». Lorsque le paramètre executePrompt s’exécute avec un promptText correspondant, il active la rubrique et renvoie une activité Message avec le texte de réponse.

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

Response

Il s’agit d’un exemple de réponse qui peut être renvoyée.

[
    {
        "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 (référence de l’API client)