Partilhar via

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

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

  • Last updated on