executePrompt (Client API reference) (preview)

Importante

• Esta é unha funcionalidade de vista previa.
• As funcionalidades en versión preliminar non están destinadas a usarse en produción e poderían ter restrinxida a funcionalidade. Estas funcións están suxeitas a termos de uso adicionais e están dispoñibles antes dun lanzamento oficial para que os clientes poidan acceder anticipadamente e proporcionar comentarios.

Executa un tema de Microsoft Copilot Studio baseado nas consultas de desencadeamento rexistradas no tema. Devolve a matriz de tipo MCSResponse.

Sintaxe

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

Parámetros

Nome do parámetro	Tipo	Obrigatorio	Descrición
promptText	cadea	Si	O texto que se rexistra como consulta de desencadeamento no tema MCS.
successCallback	Function	Si	Unha función a chamar cando a operación teña éxito.
errorCallback	Function	Si	Unha función a chamar cando a operación falla.

Devolver valor

Un array de MCSResponse

Exemplo

En Microsoft Copilot Studio, un tema desencadea por consultas como "ola" ou "ola". Cando executePrompt se executa con promptText correspondente, activa o tema e devolve unha actividade Message co texto da resposta.

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

Response

Este é un exemplo da resposta que se pode devolver.

[
    {
        "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?"
    }
]

Artigos relacionados

Xrm.Copilot (Referencia da API do cliente)