Freigeben über


executePrompt (Client-API-Referenz) (Vorschauversion)

Wichtig

  • Dies ist eine Vorschauversion.
  • Funktionen in der Vorschauversion sind nicht für den Produktionseinsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen unterliegen den ergänzenden Nutzungsbedingungen und stehen vor dem offiziellen Release zur Verfügung, damit die Kundschaft frühen Zugriff darauf erhalten und Feedback geben können.

Führt ein Microsoft Copilot Studio Thema basierend auf den im Thema registrierten Triggerabfragen aus. Gibt das Array vom Typ MCSResponse zurück.

Syntax

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

Parameter

Parametername typ Erforderlich Eigenschaft
promptText string Ja Der Text, der als Triggerabfrage im Thema MCS registriert ist.
successCallback Function Ja Eine Funktion zum Aufrufen, wenn der Vorgang erfolgreich war.
errorCallback Function Ja Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug.

Rückgabewert

Ein Aray von MCSResponse

Beispiel

In Microsoft Copilot Studio, wenn ein Thema durch Abfragen wie Hallo oder Hi ausgelöst wird. Wenn executePrompt mit der passenden promptText ausgeführt wird, wird das Thema aktiviert und eine Message-Aktivität mit dem Antworttext zurückgegeben.

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

Antworten

Dies ist ein Beispiel für die Antwort, die zurückgegeben werden kann.

[
    {
        "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 (Client-API-Referenz)