Compartilhar via

Usar variáveis de entrada e saída para passar as informações

  • Artigo

Use variáveis como parâmetros de entrada e saída para passar informações entre fluxos do Power Automate e agentes do Copilot Studio.

Importante

Um agente só pode receber até1 MB de dados de um fluxo em uma ação única. No entanto, não há limite para quantas variáveis ou a quantidade de dados que um agente pode enviar.

Neste exemplo, você cria um fluxo com um parâmetro de entrada e o retorna a um agente como um parâmetro de saída.

Pré-requisitos

Tipos de parâmetros compatíveis

Os agentes do Copilot Studio oferecem suporte aos seguintes tipos de parâmetros de entrada e saída para fluxos do Power Automate:

  • Número
  • String
  • Boolean

Os seguintes tipos de dados não têm suporte:

  • Object
  • Date
  • Carimbo de data/hora
  • Lista [Cadeia de Caracteres]
  • Lista [Número]
  • Lista [Booliano]
  • Lista [Objeto]
  • Lista [Data]
  • Lista [Carimbo de data/hora]

Criar um tópico e um fluxo

  1. Acesse a página Tópicos do seu agente.

  2. Crie um novo tópico chamado Mensagem de eco.

  3. Adicione a frase de gatilho Eco.

  4. Adicione um nó de Pergunte e digite a mensagem "Diga-me algo e repetirei para você."

  5. Em Identificar, escolha Resposta completa do usuário.

  6. Para Salvar resposta do usuário como, renomeie a variável como userResponse.

    Captura de tela de um nó Pergunta que coleta a resposta do usuário.

  7. Selecione o ícone Adicionar nó no nó Pergunta e selecione Adicionar uma ação.

  8. Na guia Ações básicas, selecione Novo fluxo do Power Automate.

  9. No Power Automate, selecione o nome do fluxo e substitua-o pelo Parâmetro Eco.

Adicionar um parâmetro de entrada ao fluxo

  1. Selecione o gatilho de fluxo Executar um fluxo do Copilot e selecione Adicionar uma entrada.

  2. Selecione Texto e digite o nome String_Input.

    Captura de tela do parâmetro de entrada de gatilho de fluxo.

Adicione um parâmetro de saída ao fluxo

  1. Selecione a ação de resposta Responder ao Copilot e selecione Adicionar uma saída.

  2. Selecione Texto e digite o nome String_Output.

    Captura de tela do parâmetro de saída da ação de resposta.

  3. Para o valor, insira uma barra (/) na caixa, selecione Inserir conteúdo dinâmico e selecione a variável String_Input.

  4. Selecione Salvar.

Chamar o fluxo do tópico

  1. No Copilot Studio, selecione o ícone Adicionar nó no nó Pergunta e selecione Adicionar uma ação.

  2. Na guia Ações básicas, selecione o fluxo criado anteriormente, Parâmetro Eco.

  3. Defina o parâmetro de entrada de fluxo para a variável de saída do nó Pergunta: String_Input (string) obtém seu valor da variável userResponse.

    Captura de tela do nó Ação que chama o fluxo 'Parâmetro Echo'.

  4. Adicionar um nó Mensagem.

  5. Selecione Inserir variável e, em seguida, selecione String_Output.

    Captura de tela do nó da mensagem que ecoa a entrada do usuário.

  6. Selecione Salvar.

  7. Testar seu agente.

    Captura de tela da conversa de um agente.

Conteúdo relacionado