Iniciar um fluxo de agente

Saiba como usar um fluxo de agente no Copilot Studio dando a um agente a capacidade de produzir uma previsão do tempo sob solicitação.

Pré-requisitos

Este exemplo depende de um exemplo anterior em que você criou um fluxo de agente que busca uma previsão do tempo.

Se você ainda não criou o fluxo de previsão do tempo, faça isso agora.

Chamar um fluxo do agente de um agente

Aqui, mostramos como adicionar o fluxo de previsão do tempo como uma ferramenta a um agente. Esse método permite ao orquestrador de agentes chamar o fluxo quando precisar fornecer uma previsão do tempo.

1. No painel de navegação esquerdo no Copilot Studio, selecione Agentes e selecione o agente ao qual você deseja adicionar o fluxo.

2. Vá para a página Ferramentas e selecione Adicionar uma ferramenta.

3. Selecione Fluxo para mostrar a lista de fluxos publicados disponíveis.

4. Selecione o fluxo Obter previsão do tempo que você criou anteriormente.

5. Selecione Adicionar e configurar.

   O fluxo é adicionado ao agente e exibido na lista de ferramentas do agente. O painel de configuração para a ferramenta usada pelo agente é aberto. Você pode usar esse painel para configurar a ferramenta para o agente.

6. Em Nome e Descrição, insira um nome de exibição para a ferramenta e uma descrição clara que ajuda o orquestrador do agente a entender quando usar o fluxo. Por exemplo, "Obtenha a previsão do tempo de hoje na cidade fornecida ou código postal."

7. Em Entradas, selecione como você deseja que o agente preencha o valor da variável.

8. Em Conclusão, selecione o que você deseja que o agente faça depois que ele terminar de usar a ferramenta.

9. Quando terminar a configuração, selecione Salvar.

Chamar um fluxo de agente de um tópico

Aqui mostramos como usar um nó de Ação em um tópico para chamar o fluxo quando um cliente perguntar sobre a previsão do tempo.

1. No Copilot Studio, acesse a página Tópicos de seu agente.

2. Crie um novo tópico e nomeie-o como Obter clima.

3. Adicione as seguintes frases de gatilho:

   • vai chover
   • previsão de hoje
   • obter clima
   • como está o clima

   

4. Selecione o ícone Adicionar nó abaixo do nó de Gatilho e selecione Enviar uma mensagem.

5. No nó da Mensagem, digite Eu posso ajudar você om isso. na caixa de texto.

6. Selecione o ícone Adicionar nó no nó Mensagem e selecione Fazer uma pergunta para adicionar um nó de Pergunta para a primeira informação do seu fluxo, a cidade.

7. No nó Pergunta:

   1. Digite a pergunta "Qual é a sua cidade?" na caixa de texto.
   2. Em Identificar, selecione Resposta completa do usuário.
   3. Observe o nome da variável associada a essa resposta, Var1. Você pode deixar o nome como está ou substituí-lo por um nome mais significativo, como "Cidade" (consulte Renomear uma variável, se necessário).

8. Proceda da mesma forma para adicionar outro nó de Pergunta para a outra informação do seu fluxo, o CEP:

   1. Digite a pergunta "Qual é o seu CEP?" na caixa de texto.
   2. Em Identificar, selecione Número.
   3. Observe o nome da variável associada a essa resposta, Var2. Você pode deixar o nome como está ou substituí-lo por um nome mais significativo (por exemplo, "ZIPcode").

9. Selecione o ícone Adicionar nó no nó Pergunta do CEP, selecione Adicionar uma ferramenta e, em seguida, selecione o fluxo criado anteriormente, Obter previsão do tempo.

10. Defina as entradas do fluxo para as variáveis de saída dos nós da pergunta. Cidade (String) obtém seu valor de Var1 (ou City se você o renomeou) e CEP (Número) obtém seu valor de Var2 (ou ZIPcode se você o renomeou).

    

11. Sob o nó Ação, adicione um nó de Mensagem e informe uma mensagem que usa informações de saída do fluxo. Por exemplo:

    "Previsão de hoje para location: day_summary"
    "A possibilidade de chuva é de chance_of_rain%"
    Onde location,day_summary e chance_of_rain são parâmetros de saída do seu fluxo.

    

12. Selecione Salvar.

Gerenciar um fluxo de agente usado em um tópico

Depois de ter um nó de Ação que chama um fluxo, você pode usar as seguintes opções no menu do nó para gerenciar o fluxo:

• Excluir exclui permanentemente o nó e remove o fluxo do tópico.

• Atualizar recarrega o fluxo para obter as alterações feitas no Power Automate e o valida no tópico. Você deve corrigir quaisquer problemas com o fluxo antes de salvar o tópico.

Se você quiser selecionar ou criar um fluxo diferente, use o ícone Alterar fluxo que aparece quando você passa o mouse sobre o fluxo no nó Ação.

Testar seu fluxo e tópico

É uma boa ideia testar o fluxo e o tópico que o chama.

No painel Testar seu agente, digite uma das frases de gatilho do tópico para iniciar uma conversa com o agente. Digite sua cidade e CEP quando o agente solicitar. Verifique se o agente retorna a previsão do tempo de hoje para sua cidade e se a mensagem aparece da forma esperada.

Solucionar problemas do seu agente

Sempre Teste seu agente ao fazer alterações nos seus tópicos e fluxos para garantir que tudo ainda esteja funcionando. Se o agente encontra um problema durante uma conversa, ele responde com uma mensagem de erro.

Encontre a maioria dos problemas relacionados ao fluxo no verificador de fluxo na guia do designer de fluxo . Use o verificador de tópicos para identificar problemas na tela de criação.