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 passar informações entre fluxos de agente e agentes do Copilot Studio.

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

• Compreender como criar um fluxo a partir da tela de criação do Copilot Studio

Tipos de parâmetros compatíveis

Os agentes do Copilot Studio dão suporte aos seguintes tipos de parâmetros de entrada e saída para fluxos de agente:

• Número
• Cadeia de caracteres
• Booliano

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

• 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. 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.

   

7. Selecione o ícone Adicionar nó no nó Pergunta e selecione Adicionar uma ferramenta.

8. Na guia Ações básicas, selecione Novo Fluxo do agente. A guia do designer de fluxo do agente é aberta com um modelo inicial para um fluxo do agente chamado por um agente. O fluxo tem duas ações: Quando um agente chama o fluxo e Responder ao agente.

9. Selecione Publicar para salvar o fluxo antes de fazer qualquer alteração. Uma notificação é exibida quando o fluxo é criado com êxito.

10. Selecione Voltar ao agente para retornar ao tópico. Um novo nó Ação é adicionado ao tópico para o fluxo.

11. Selecione Salvar para terminar de adicionar o fluxo como uma ferramenta ao agente.

Editar os detalhes de fluxo

1. No nó Ação com o fluxo, selecione o link Exibir detalhes do fluxo para retornar ao fluxo do agente.

2. Na guia Visão geral do fluxo, edite os detalhes do fluxo, substituindo o nome por Parâmetro eco. Selecione Salvar.

3. Volte para a guia Designer.

Adicionar um parâmetro de entrada ao fluxo

1. Selecione o gatilho de fluxo Quando um agente chama o fluxo e selecione Adicionar uma entrada.

2. Selecione Texto e digite o nome String_Input.

   

Adicione um parâmetro de saída ao fluxo

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

2. Selecione Texto e digite o nome String_Output.

   

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 rascunho e Publicar. O Copilot Studio informa você quando o fluxo do agente é publicado.

5. Selecione Voltar ao agente para retornar ao editor de tópicos do agente. O novo fluxo de ação é adicionado ao tópico.

Chamar o fluxo do tópico

1. Selecione o novo nó da ação.

2. 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.

   

3. Adicionar um nó Mensagem.

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

   

5. Selecione Salvar.

6. Testar seu agente.

   

Conteúdo relacionado

• Visão geral das variáveis