Adicionar variáveis de entrada e saída

  • Artigo

Importante

As capacidades e os recursos do Power Virtual Agents agora fazem parte do Microsoft Copilot Studio após investimentos significativos em IA generativa e integrações aprimoradas no Microsoft Copilot.

Alguns artigos e capturas de tela podem fazer referência ao Power Virtual Agents enquanto atualizamos a documentação e o conteúdo do treinamento.

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

Importante

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

Neste exemplo, você criará um fluxo com um parâmetro de entrada e o retornará a um copiloto 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 copiloto.

  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.

Selecionar variáveis no tópico do copiloto

  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 o copiloto.

    Captura de tela de uma conversa do copiloto.

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.

Usar variáveis