Partilhar via

Criar um fluxo de agente como ferramenta

Aprenda a utilizar um fluxo de cloud no Copilot Studio, dando a um agente a capacidade de gerar uma previsão meteorológica a pedido. Neste primeiro exemplo, cria um fluxo que procura uma previsão meteorológica. No exemplo seguinte, 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 o tempo.

Para funcionar como uma ferramenta com agentes, um fluxo de agente requer o seguinte:

  • Tenha o acionador Quando um agente chama o fluxo e uma ação de resposta de Responder ao agente.
  • Estar configurado para responder em tempo real, não de forma assíncrona. A opção Resposta assíncrona deve estar definida como Desligada em Funcionamento em rede nas definições de ação Responder ao agente.
  • Responda ao agente dentro do limite de ação de 100 segundos. Otimize a lógica de fluxo, as consultas e a quantidade de dados devolvidos para que uma execução típica fique abaixo deste limite de 100 segundos. As ações no fluxo que precisam de ser executadas durante mais tempo podem ser colocadas após a ação Responder ao Copilot para continuarem a ser executadas até ao limite de duração de execução de fluxo de 30 dias. Para obter orientações sobre como acelerar os seus fluxos, consulte Acelerar a execução do fluxo de agente com o modo expresso.

Ao criar um fluxo de agente no Copilot Studio como uma nova ferramenta adicionada a um agente, o acionador de fluxo e a ação de resposta necessários são adicionados automaticamente. Pode modificar um fluxo existente para utilização com agentes atualizando-o para utilizar este acionador e esta ação de resposta.

Pré-requisitos

Criar um fluxo que possa utilizar com um agente

Neste exemplo, cria um fluxo que recolhe a previsão meteorológica atual do MSN Weather. Adiciona o fluxo como uma ferramenta a um tópico de agente existente.

Adicionar um novo fluxo de agente vazio a um tópico e guardá-lo

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

  2. Abra o tópico a partir do qual pretende chamar um fluxo.

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

  4. No separador Ferramentas básicas, selecione Novo fluxo de agente.

    A página Fluxos de agentes abre-se, com um modelo de fluxo inicial aberto no estruturador de fluxos de agentes para edição. Tenha o acionador Quando um agente chama o fluxo e uma ação Responder ao agente.

  5. Selecione Publicar para guardar o fluxo antes de fazer qualquer alteração. Uma notificação aparece quando o fluxo é criado com sucesso.

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

  7. Selecione Guardar para terminar de adicionar o fluxo como uma ferramenta ao seu 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 seu agente, pode agora voltar para adicionar ações ao seu fluxo. Neste exemplo, adiciona uma ação que procura a previsão atual do MSN Weather.

  1. No nó Ação com o fluxo, selecione a ligação Ver detalhes do fluxo para voltar ao fluxo de agente.

  2. Na página Descrição geral, em Detalhes, edite o nome do fluxo para algo significativo, como "Obter previsão meteorológica".

  3. Vá para o estruturador, selecione o acionador de fluxo Quando um agente chama o fluxo e adicione os seguintes parâmetros de entrada:

    • Cidade (Texto)
    • Código postal (Número)

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

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

  6. No painel Obter previsão para hoje, na caixa Localização , introduza uma barra (/), selecione Inserir conteúdo dinâmico e, em seguida, selecione o parâmetro de entrada da sua Cidade.

  7. Proceda da mesma forma para adicionar o parâmetro de entrada do seu Código postal.

  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 durante o Dia

    Captura de ecrã das variáveis dinâmicas como parâmetros de saída para a ação de resposta.

  9. Selecione Publicar. Uma notificação aparece quando o fluxo é criado com sucesso.

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

Gerir quais as ligações utilizadas pelo fluxo

Num agente autenticado suportado, os fluxos de cloud podem ser configurados para utilizar as credenciais de utilizador quando são executados como parte de um plano de orquestração generativa ou chamados a partir de um tópico. Utilizar o fluxo num canal compatível não requer qualquer configuração especial no seu agente. Os clientes conseguem gerir as suas ligações enquanto utilizam o agente.

Os fluxos de cloud em ambientes que utilizam chaves geridas pelo cliente (CMK) ainda não podem ser executados com credenciais do cliente como parte de planos de orquestração generativa ou a partir de tópicos. Certifique-se de que as definições de execução apenas para fluxos de cloud em ambientes CMK estão definidas para ligações específicas em vez de Fornecidas pelo utilizador apenas de execução.

Conteúdos relacionados

  • Last updated on