Usar variáveis de entrada e saída para passar as informações
Use variáveis como parâmetros de entrada e saída para transmitir informações entre fluxos do Power Automate e copilotos do 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
- Entenda como criar um fluxo na tela de criação do Copilot Studio
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
Acesse a página Tópicos do seu copiloto.
Crie um novo tópico chamado Mensagem de eco.
Adicione a frase de gatilho Eco.
Adicione um nó Pergunta e digite a mensagem Diga-me algo e repetirei para você.
Em Identificar, escolha Resposta completa do usuário.
Em Salvar resposta como, selecione o ícone de lápis e renomeie a variável como userResponse.
Na tela de criação, selecione Adicionar nó (+). Selecione Chamar uma ação e, depois, Criar um fluxo.
No portal do Power Automate, nomeie o fluxo Parâmetro Eco.
Adicionar parâmetros de entrada ao fluxo
No gatilho de fluxo do Microsoft Copilot Studio, selecione Adicionar uma entrada.
Selecione Texto e digite o nome String_Input.
Adicionar parâmetros de saída ao fluxo
Na ação de resposta Retornar valores para o Microsoft Copilot Studio, selecione Adicionar uma saída.
Selecione Texto e digite o nome String_Output.
Para o valor de String_Output, selecione a variável String_Input.
Selecione Salvar.
Selecionar variáveis no tópico do copiloto
Na tela de criação do Microsoft Copilot Studio, selecione Adicionar nó (+) e, em seguida, selecione Chamar uma ação.
Selecione o fluxo criado anteriormente, Parâmetro Eco.
Em String_Input(text) obtém valor de, selecione userResponse.
Adicionar um nó Mensagem. Selecione Inserir variável e, em seguida, selecione String_Output.
Teste seu tópico no painel Testar o 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".