executePrompt (referência da API do cliente) (visualização)

Importante

• Este é um recurso de visualização.
• As funcionalidades de pré-visualização não se destinam a utilização em produção e podem ter funcionalidades restritas. Esses recursos estão sujeitos a termos de uso suplementares e estão disponíveis antes de um lançamento oficial para que os clientes possam obter acesso antecipado e fornecer feedback.

Executa um tópico do Microsoft Copilot Studio com base nas consultas de gatilho registradas no tópico. Retorna a matriz do tipo MCSResponse.

Sintaxe

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

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Description
promptText	cadeia (de caracteres)	Yes	O texto registrado como uma consulta de gatilho no tópico MCS.
successCallback	Função	Yes	Uma função a ser chamada quando a operação for bem-sucedida.
errorCallback	Função	Yes	Uma função para chamar quando a operação falhar.

Valor de retorno

Uma matriz de MCSResponse

Example

No Microsoft Copilot Studio, um tópico é acionado por consultas como "olá" ou "oi". Quando executePrompt executado com promptText correspondente, ele ativa o tópico e retorna uma atividade de mensagem com o texto de resposta.

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

Resposta

Este é um exemplo da resposta que pode ser retornada.

[
    {
        "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 (referência da API do cliente)