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 Power Automate fluxos e Copilot Studio agentes.

Importante

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

Neste exemplo, você criará um fluxo com um parâmetro de entrada e o retornará para um agente como um parâmetro de saída.

Pré-requisitos

Tipos de parâmetros compatíveis

Os copilotos podem usar os seguintes tipos de entradas e saídas com fluxos do Power Automate:

  • Número
  • Cadeia de caracteres
  • Booliano

Os tipos a seguir não são compatíveis:

  • Objeto
  • Data
  • 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. Vá para 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ó Pergunta e digite a mensagem Diga-me algo e repetirei para você.

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

  6. Em Salvar resposta como, selecione o ícone de lápis e renomeie a variável como userResponse.

    Captura de tela de um nó Pergunta.

  7. Na tela de criação, selecione Adicionar nó (+). Selecione Chamar uma ação e, depois, Criar um fluxo.

  8. No portal do Power Automate, nomeie o fluxo Parâmetro Eco.

Adicionar parâmetros de entrada ao fluxo

  1. No gatilho de fluxo do Microsoft Copilot Studio, selecione Adicionar uma entrada.

    Captura de tela de um gatilho de fluxo do Microsoft Copilot Studio, com Adicionar uma entrada em destaque.

  2. Selecione Texto e digite o nome String_Input.

    Captura de tela da entrada do gatilho de fluxo.

Adicionar parâmetros de saída ao fluxo

  1. Na ação de resposta Retornar valores para o Microsoft Copilot Studio, selecione Adicionar uma saída.

    Captura de tela da ação de resposta do fluxo, com Adicionar uma saída em destaque.

  2. Selecione Texto e digite o nome String_Output.

    Captura de tela da saída da ação de resposta.

  3. Para o valor de String_Output, selecione a variável String_Input.

    Captura de tela de um parâmetro de entrada selecionado como o valor de um parâmetro de saída.

  4. Selecione Salvar.

Select variáveis no agente tópico

  1. Na tela de criação do Microsoft Copilot Studio, selecione Adicionar nó (+) e, em seguida, selecione Chamar uma ação.

  2. Selecione o fluxo criado anteriormente, Parâmetro Eco.

  3. Em String_Input(text) obtém valor de, selecione userResponse.

  4. Adicionar um nó Mensagem. Selecione Inserir variável e, em seguida, selecione String_Output.

    Captura de tela de um nó Ação para o fluxo do parâmetro Eco.

  5. Teste seu tópico no painel Testar agente .

    Captura de tela de uma conversa agente.

Opcionalmente, use valores literais para parâmetros de entrada

Como alternativa, em vez de usar uma variável como parâmetro de entrada de uma ação, você pode digitar o valor diretamente na caixa "obtém valor de".

Captura de tela de um valor literal transmitido como parâmetro de entrada.

Conteúdo relacionado