Criar um fluxo

Saiba como usar um fluxo da nuvem no Copilot Studio, dando a um agente a capacidade 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 trabalhar com os agentes, um fluxo do Power Automate requer o seguinte gatilho de fluxo e ação de resposta:

• Gatilho de fluxo: Executar um fluxo pelo Copilot
• Ação de resposta: Responder ao Copilot

Quando você cria um fluxo do Copilot Studio, o gatilho de 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 ação.

Importante

Para usar fluxos de nuvem em agentes personalizados no Copilot Studio, os fluxos devem:

• Ter o gatilho Executar um fluxo pelo Copilot.
• Estar localizado em uma solução no mesmo ambiente que o agente. Os fluxos existentes podem ser adicionados a uma solução a ser disponibilizada ao adicionar ações ao seu agente.
• Retornar uma resposta de maneira síncrona com a ação Responder ao Copilot, dentro do limite de ação de 100 segundos. Para evitar tempos limite, otimize a lógica de fluxo, as consultas e o volume de dados retornados, de maneira que uma execução típica permaneça abaixo desse limite. As ações que precisarem ser executadas por mais tempo poderão ser colocadas depois da ação Responder ao Copilot para continuar em execução até o limite de duração da execução de fluxo, que normalmente é de 30 dias.

Pré-requisitos

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

Crie um fluxo para usar com um agente

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 ação.

4. Na guia Ações básicas, selecione Novo fluxo do Power Automate.

   O portal Power Automate é aberto em uma nova guia, com um modelo de fluxo inicial aberto para edição. O portal é aberto no mesmo ambiente que o agente e usa as mesmas credenciais do usuário.

   Agora adicione ações ao seu fluxo. Neste exemplo, você adiciona uma ação que busca a previsão atual do MSN Clima.

5. Selecione o nome do fluxo e substitua-o por "Obter previsão do tempo".

6. Selecione o gatilho de fluxo Executar um fluxo do Copilot e adicione os seguintes parâmetros de entrada:

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

   

7. Selecione o ícone Adicionar abaixo do gatilho do fluxo Executar um fluxo do Copilot.

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

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

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

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

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

    

12. Salve e publique o fluxo.

13. Volte para o tópico no Copilot Studio e siga as instruções em Chamar um fluxo de um tópico.

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 com suporte não requer nenhuma configuração especial em seu 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.

Modificar um fluxo existente para usar com um agente

Se tiver um fluxo com um gatilho diferente que deseja usar com o agente, você poderá alterar o fluxo para usar o gatilho Executar um fluxo pelo Copilot e a ação de resposta Responder ao Copilot, além de verificar se ele está em uma solução no mesmo ambiente do agente personalizado.

1. Vá até o portal do Power Automate e use o seletor Ambiente no canto superior direito para escolher o ambiente onde o fluxo é armazenado.

2. Selecione Meus fluxos no painel de navegação esquerdo e procure o fluxo que deseja modificar.

3. Selecione seu fluxo e escolha Editar.

   

Adicionar o gatilho e a ação de resposta do Copilot

Se o fluxo ainda não incluir a ação de gatilho e resposta de fluxo necessária, você deverá adicioná-las antes de poder usar o fluxo com seu agente.

1. Selecione Nova etapa.

2. Procure Copilot e selecione Executar um fluxo pelo Copilot.

3. Selecione Nova etapa.

4. Procure o conector do Copilot e selecione Responder ao Copilot. A ação de resposta pode ser usada em várias ramificações no fluxo, mas deve ter as mesmas saídas em cada uso.

5. Salve e publique o fluxo.

Verifique se a ação de resposta está definida para retornar em tempo real

Os fluxos que você deseja usar em um agente devem retornar valores em tempo real ou de forma síncrona. Os fluxos executados em segundo plano ou de forma assíncrona podem causar um erro quando o agente tenta executá-los. Em vez de executar o fluxo, o agente dirá "Ocorreu algo inesperado. Estamos investigando isso. Código de erro: 3000".

Quando você cria um fluxo do Copilot Studio, as respostas assíncronas são desativadas por padrão. Se você modificou um fluxo existente com respostas assíncronas ativadas, siga estas etapas para verificar a configuração e garantir que ela esteja desativada:

1. Abra seu fluxo e encontre as ações Responder ao Copilot.

2. Selecione a guia Configurações.

3. Defina Resposta Assíncrona como Desativada e, em seguida, selecione Salvar.

   

Adicionar o fluxo a uma solução

Para estarem disponíveis aos agentes, os fluxos devem ser armazenados em uma solução no mesmo ambiente do Power Platform. Se um fluxo estiver em uma solução, um bloco Soluções ficará visível na página de detalhes do fluxo que lista em quais soluções o fluxo está. Os fluxos podem ser adicionados à Solução Padrão para uso com agentes ou movidos para uma solução diferente usando as etapas abaixo:

1. Vá para Power Automate.

2. Vá para Soluções e selecione uma solução existente ou crie uma solução para seu fluxo.

3. Se quiser criar uma nova solução:

   1. Selecione Nova solução.

   2. Dê um nome à sua nova solução, selecione Editor Padrão de CDS no campo Editor e digite um número da Versão.

      

   3. Selecione Criar.

4. Se quiser adicionar seu fluxo a uma solução existente, selecione a solução desejada e escolha Editar.

5. Selecione Adicionar existente>Automação>Fluxo da nuvem.

   

   O painel Adicionar fluxos existentes é exibido.

6. Selecione seu fluxo e escolha Adicionar.

   

Conteúdo relacionado

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