Partilhar via

Chamar 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 mediante 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 de agente a partir de um agente

Aqui mostramos como adicionar o fluxo de previsão do tempo como uma ferramenta para um agente. Este método permite que o orquestrador do agente chame o fluxo quando precisar de fornecer uma previsão meteorológica.

  1. No painel de navegação esquerdo do Copilot Studio, selecione Agentes e selecione o agente ao qual 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 criou anteriormente.

  5. Selecione Adicionar e configurar.

    O fluxo é adicionado ao seu agente e aparece na lista de ferramentas do agente. O painel de configuração da 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 ajude o orquestrador do agente a entender quando usar o fluxo. Por exemplo, "Obtenha a previsão do tempo de hoje no nome de uma cidade ou código postal fornecido."

  7. Em Entradas, selecione como 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 a partir de um tópico

Aqui demonstramos como usar um nó de Ação num tópico para chamar o fluxo quando um cliente pergunta sobre o tempo.

  1. No Copilot Studio, vá para a página Tópicos do seu agente.

  2. Crie um novo tópico e nomeie-o Get weather.

  3. Adicione as seguintes frases de gatilho:

    • vai chover
    • Previsões de hoje
    • obter previsão
    • Qual é o tempo

    Captura de expressões acionadoras para o tópico 'Obter meteorologia'.

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

  5. No nó Mensagem , digite Eu posso ajudá-lo com isso. na caixa de texto.

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

  7. No nó da Pergunta:

    1. Digite a pergunta "Qual é a sua cidade?" na caixa de texto.
    2. Em Identificar, selecione a 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 o outro elemento de informação para o seu fluxo, o código postal:

    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, "CEP").

  9. Selecione o ícone Adicionar nó sob o nó de Pergunta para o código postal, selecione Adicionar uma ferramenta e, em seguida, selecione o fluxo que criou anteriormente, Obter previsão do tempo.

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

    Captura de ecrã do nó Ação mostrando os parâmetros de entrada e saída do fluxo 'Obter previsão do tempo'.

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

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

    Captura de ecrã do nó de mensagem com uma mensagem que utiliza parâmetros de saída do fluxo.

  12. Selecione Guardar.

Gerenciar um fluxo de agente usado em um tópico

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

  • Eliminar elimina permanentemente o nó e remove o fluxo do tópico.

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

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

Teste seu fluxo e tópico

É uma boa ideia testar o fluxo e o assunto que o invoca.

No painel Testar seu agente , digite uma das frases de gatilho do tópico para iniciar uma conversa com o agente. Introduza a sua cidade e o código postal quando solicitado pelo agente. Verifique se o agente devolve a previsão do tempo de hoje para a sua cidade e se a mensagem tem a aparência esperada.

Captura de tela de um bate-papo de teste mostrando informações da ferramenta 'Obter previsão do tempo'.

Resolver problemas do seu agente

Teste sempre o seu agente quando fizer alterações a tópicos e fluxos, para se certificar de que tudo ainda funciona. Se o agente encontrar um problema durante uma conversa, ele responderá com uma mensagem de erro.

Encontre a maioria dos problemas relacionados com o fluxo no verificador de fluxo no separador Estruturador de fluxos. Utilize o verificador de tópicos para identificar problemas na tela de criação.

  • Last updated on