Criar um fluxo de agente como uma ferramenta

Aprenda a usar um fluxo da nuvem no Copilot Studio dando a um agente a possibilidade de produzir uma previsão do tempo mediante solicitação. Neste primeiro exemplo, você cria um fluxo que busca uma previsão do tempo. No próximo exemplo, você configura um tópico para chamará o fluxo como uma ação para que o agente possa responder com a previsão quando um cliente perguntar sobre a previsão do tempo.

Para funcionar como uma ferramenta com agentes, um fluxo do agente exige o seguinte:

• Ter o gatilho Quando um agente chama o fluxo e uma ação de resposta Responder ao agente.
• Ser configurado para responder em tempo real, não de forma assíncrona. A alternância Resposta assíncrona deve ser definida como Desativada em Rede nas configurações de ação Responder ao agente.
• Responda ao agente dentro do limite de ação de 100 segundos. Otimize a lógica do fluxo, as consultas e a quantidade de dados retornados para que uma execução típica fique abaixo desse limite de 100 segundos. As ações no fluxo que precisam ser executadas por mais tempo podem ser colocadas após a ação Responder a Copilot para continuarem sendo executadas até o limite de duração de execução do fluxo de 30 dias. Para orientação sobre como agilizar os fluxos, consulte Agilizar a execução do fluxo do agente com o modo expresso.

Quando você cria um fluxo do agente no Copilot Studio como uma nova ferramenta adicionada a um agente, o gatilho do fluxo necessário e a ação de resposta são adicionados para você. Você pode modificar um fluxo existente para uso com agentes atualizando-o para usar esse gatilho e esta ação de resposta.

Pré-requisitos

• Acesso ao Copilot Studio com uma licença que inclui o uso de fluxos no Copilot Studio.

Crie um fluxo que você possa usar com um agente

Neste exemplo, você cria um fluxo que busca a previsão do tempo atual do MSN Weather. Você adiciona o fluxo como uma ferramenta a um tópico do agente existente.

Adicionar um fluxo do agente novo vazio a um tópico e salvá-lo

1. Acesse a página Tópicos do seu agente.

2. Abra o tópico do qual você deseja chamar um fluxo.

3. Selecione o ícone Adicionar nó abaixo de qualquer nó e selecione Adicionar uma ferramenta.

4. Na guia Ferramentas básicas, selecione Novo Fluxo do agente.

   A página Fluxos do agente abre, com um modelo de fluxo inicial aberto no designer de fluxos do agente para edição. O fluxo inclui o gatilho necessário Quando um agente chama o fluxo e a ação Responder ao agente.

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

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

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

Adicionar ações e configurar o fluxo

Com um modelo básico criado para o fluxo, e o fluxo adicionado ao tópico do agente, agora você pode retornar para adicionar ações ao fluxo. Neste exemplo, você adiciona uma ação que busca a previsão atual do MSN Clima.

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

2. Na página Visão Geral, em Detalhes, edite o nome do fluxo para algo significativo, como "Obter previsão do tempo".

3. Vá até o designer, selecione gatilho de fluxo Quando um agente chama o fluxo e adicione os seguintes parâmetros de entrada:

   • Cidade (Texto)
   • CEP (Número)

4. Selecione o ícone Adicionar abaixo do gatilho do fluxo Quando um agente chama o fluxo.

5. Em Adicionar uma ação, procure por "Previsão do tempo do MSN" e selecione a ação Obter previsão para hoje.

6. No painel Obter previsão para hoje, na caixa Local, insira uma barra (/), selecione Inserir conteúdo dinâmico e selecione o parâmetro de entrada Cidade.

7. Proceda da mesma forma para adicionar seu parâmetro de entrada de CEP.

8. Na ação Responder ao agente, adicione os seguintes parâmetros e variáveis de saída:

   Parâmetro de saída	Tipo	Variável
   day_summary	Texto	Resumo do Dia
   location	Texto	Localização
   chance_of_rain	Número	Possibilidade de Chuva do Dia

   

9. Selecione Publicar. Uma notificação é exibida quando o fluxo é criado com êxito.

Para continuar, siga as instruções em Chamar um fluxo do agente de um agente.

Gerenciar quais conexões são usadas pelo fluxo

Em um agente autenticado com suporte, os fluxos da nuvem podem ser configurados para usar credenciais de usuário quando são executados como parte de um plano de orquestração generativa ou chamados a partir de um tópico. O uso do fluxo em um canal compatível não exige nenhuma configuração especial no agente. Os clientes podem gerenciar suas conexões enquanto usam o agente.

Os fluxos da nuvem em ambientes que usam chaves gerenciadas pelo cliente (CMK) ainda não podem ser executados com credenciais do cliente como parte de planos de orquestração generativa ou de tópicos. Verifique se as configurações somente de execução dos fluxos de nuvem em ambientes CMK estão definidas como conexões específicas, em vez de Fornecidas pelo usuário somente de execução.

Conteúdo relacionado

• Chamar um fluxo como uma ação
• Usar variáveis de entrada e saída para passar informações
• Adicionar autenticação do usuário a tópicos