Criar um fluxo

  • Artigo

Aprenda a usar um fluxo da nuvem no Copilot Studio, dando a um copiloto a capacidade de produzir uma previsão do tempo mediante solicitação. Neste primeiro exemplo, você criará um fluxo que busca uma previsão do tempo. No próximo exemplo, você vai chamar o fluxo como uma ação a partir de um tópico, de maneira que o copiloto possa responder com a previsão quando um cliente perguntar sobre o clima.

Para trabalhar com copilotos, um fluxo do Power Automate exige um gatilho de fluxo específico e uma ação de resposta.

  • Gatilho de fluxo: Executar um fluxo pelo Copilot

    Captura do gatilho de fluxo Executar um fluxo pelo Copilot.

  • Ação de resposta: Responder ao Copilot

    Captura de tela da ação de resposta Responder ao Copilot.

Quando você cria um fluxo no Copilot Studio, a ação e o gatilho são adicionados para você. Você pode modificar um fluxo existente a ser usado com copilotos alterando-o para usar essas ações.

Importante

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

  • Ter o gatilho Executar um fluxo pelo Copilot.
  • Estar localizados em uma solução dentro do mesmo ambiente do copiloto. Os fluxos existentes podem ser adicionados a uma solução a ser disponibilizada durante a adição de ações ao copiloto.
  • 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 dentro do contexto de criações do Copilot Studio.

Criar um fluxo da nuvem para usar com um copiloto

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

  2. Abra a tela de criação do tópico do qual você deseja chamar um fluxo.

  3. Selecione Adicionar nó (+) abaixo de um nó existente para adicionar um novo nó.

  4. Na janela de seleção de nós, escolha Chamar uma ação, Ação Básica e selecione Criar um fluxo.

    Captura de tela da opção Criar um fluxo no menu Chamar uma ação.

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

    Captura de tela do modelo de fluxo do Power Automate chamado do Copilot Studio.

    Dica

    Renomeie os nós para torná-los mais fáceis de identificar. Select o campo de nome do nó para atualizar o nome diretamente ou selecione o ícone Mais (...) do nó e selecione Renomear no menu. Você também pode renomear nós no editor de código.

    Não é possível renomear os nós de Gatilho e os nós Ir para etapa.

    Os nomes do nó podem ter até 500 caracteres.

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

  1. Selecione o nome do fluxo e renomeie-o como Obter previsão do tempo.

    Captura de tela do nome do fluxo selecionado.

  2. Adicione os seguintes parâmetros de entrada ao gatilho Executar um fluxo pelo Copilot:

    • Cidade (Texto)
    • CEP (Number)

    Captura de tela de parâmetros de entrada para o fluxo do Power Automate.

  3. Selecione Adicionar uma ação para criar uma nova ação abaixo do gatilho de fluxo Executar um fluxo pelo Copilot.

    Captura de tela do botão Adicionar ação de fluxo.

  4. Procure MSN Clima e selecione a ação Obter previsão para hoje.

    Captura de tela da ação Obter previsão para hoje no conector do MSN Clima.

  5. Na ação Obter previsão para hoje, na caixa Localização, selecione Adicionar conteúdo dinâmico e, em seguida, selecione Cidade e CEP.

    Captura de tela de variáveis adicionadas à ação Obter previsão para hoje

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

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

    Captura de tela de variáveis de saída dinâmicas adicionadas à ação de resposta de fluxo.

  7. Selecione Salvar.

Gerenciar quais conexões são usadas pelo fluxo

Em um copiloto autenticado compatível, os fluxos de nuvem podem ser configurados para usar credenciais do usuário final quando eles executam uma ação generativa ou de um tópico. Se você estiver usando o fluxo em um canal compatível, isso não exigirá uma configuração especial na caixa de diálogo do copiloto, e os usuários finais poderão gerenciar as conexões enquanto usarem o copiloto.

Os fluxos de nuvem em ambientes que usem chaves gerenciadas pelo cliente (CMKs) ainda não podem ser executados com credenciais de usuário final como ações generativas ou em 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 copiloto

Se tiver um fluxo com um gatilho diferente que deseja usar com o copiloto, 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 copiloto 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. Navegue até Meus fluxos no lado esquerdo e procure o fluxo.

  3. Selecione o fluxo.

    Captura de tela do fluxo Obter previsão do tempo na Solução Padrão.

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

Se o fluxo ainda não incluir o gatilho e a ação de resposta do Copilot, você deverá adicioná-los para poder usar o fluxo com o copiloto.

  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 copiloto 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 copiloto tenta executá-los. Em vez de executar o fluxo, o copiloto 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ê tiver modificado um fluxo existente que tenha respostas assíncronas ativadas, siga estas etapas para verificar a configuração e garantir que ele esteja desativado:

  1. Abra o 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 Concluído.

    Captura de tela da alternância da opção de Resposta Assíncrona.

Adicionar o fluxo a uma solução

Para estarem disponíveis aos copilotos, 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 permanecerá 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 a serem usados com copilotos ou movidos até uma solução diferente usando as etapas abaixo:

  1. Acesse o portal do Power Automate.

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

    Para criar uma solução, selecione Nova solução.

    Captura de tela do botão Nova solução.

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

    Captura de tela das propriedades da solução.

  3. Na guia Soluções, vá para a solução que deseja usar. Selecione Adicionar existente para adicionar um fluxo.

    Captura de tela do botão Adicionar existente.

  4. Na página Adicionar fluxo existente, selecione a guia De soluções, escolha o fluxo e selecione Adicionar.

    Captura de tela da lista de fluxos existentes nas soluções.

    Para mover um fluxo da guia Meus fluxos para uma solução, selecione Soluções externas e, em seguida, selecione Adicionar para adicionar o fluxo à solução.

    Captura de tela da lista de fluxos existentes fora das soluções.

Conteúdo relacionado