executePrompt (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 uma matriz do tipo MCSResponse.

Disponível para

Aplicações condicionadas por modelo

Sintaxe

context.copilot.executeEvent(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

Tipo: Promise<MCSResponse>

Veja Promise e MCSResponse

Example

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

const response = await context.copilot.executePrompt("hello");

Resposta

[
    {
        "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

Copilot
executeEvent
Referência da API da estrutura do componente Power Apps
Visão geral da estrutura do componente Power Apps