Criar um agente de chat de fluxo de trabalho

Este documento descreve como criar e configurar um agente de chat de fluxo de trabalho no Workflow Builder.

Visão geral

Um agente de chat de fluxo de trabalho funciona como um orquestrador de fluxo de trabalho multi-nó avançado para gerenciar interações conversacionais.

Enquanto um agente de chat sem fluxo de trabalho é restrito a um único nó raiz com atributos fixos, um agente de chat de fluxo de trabalho permite anexar fluxos de trabalho publicados e agentes remotos do Kit de Desenvolvimento de Aplicativos (ADK) como subagentes. O agente de chat raiz atua como o coordenador, enviando consultas do usuário para o subagente apropriado e retornando respostas.

Os principais benefícios dos agentes de chat de fluxo de trabalho incluem:

  • Orquestração avançada: aninhe vários fluxos de trabalho publicados ou agentes remotos do ADK como subnós para lidar com tarefas complexas do usuário.
  • Suporte ao histórico de versões: os agentes de chat de fluxo de trabalho oferecem suporte ao controle de versões. É possível salvar, comparar, visualizar o histórico e restaurar versões anteriores do agente para acompanhar as modificações.

Antes de começar

Antes de criar um agente de chat de fluxo de trabalho, conclua os seguintes pré-requisitos:

  • Verifique se um administrador do Gemini Enterprise ativou a alternância de recursos do Workflow Builder nas configurações de gerenciamento de recursos do app. Para mais informações, consulte Gerenciar recursos do app da Web.
  • Verifique se você tem um app da Web com as fontes de dados necessárias conectadas. Para mais informações, consulte Criar um app, Conectar uma fonte de dados do Google e Conectar uma fonte de dados de terceiros.
  • Verifique se todos os fluxos de trabalho ou agentes remotos do ADK que você quer anexar como subagentes já estão publicados no repositório do espaço de trabalho, tornando-os visíveis para o orquestrador raiz.

Criar um agente de chat de fluxo de trabalho

App

Para criar um agente de chat de fluxo de trabalho manualmente, faça o seguinte:

  1. Abra o app da Web do Gemini Enterprise em um navegador.
  2. No menu de navegação do app da Web, clique em + Novo agente > Fluxos de trabalho.
  3. No painel de criação de agentes, clique em Criar manualmente.

  4. Selecione o chip de gatilho Chat.

    O editor do Workflow Builder é aberto, direcionando você para as opções de configuração do agente de chat de fluxo de trabalho.

  5. No painel de configuração, você pode opcionalmente configurar o seguinte para seu agente:

    • Comandos sugeridos: insira um comando que descreva a finalidade e o comportamento pretendido do agente.

    • Conhecimento: clique em Adicionar arquivos para fazer o upload de mais materiais de referência para o agente usar.

    • Ferramentas e integrações: abra a caixa de diálogo Ferramentas e integrações para selecionar as ferramentas e os apps do Google permitidos para essa interface conversacional.

    • Subagentes: navegue ou pesquise para selecionar os fluxos de trabalho publicados ou agentes remotos do ADK que você quer que o fluxo de trabalho orquestre. Esses agentes serão configurados como subnós de execução abaixo do agente raiz.

    • Mais: selecione o modelo usado pelo agente de chat de fluxo de trabalho.

  6. Teste a configuração do agente:

    • Clique na guia Visualização.
    • Na interface de chat, envie uma mensagem de teste (por exemplo, hello) para avaliar as respostas do agente.

  7. Salvar ou gerenciar versões do agente (opcional):

    1. Clique na seta suspensa ao lado de Publicar e selecione Salvar versão.
    2. Para revisar ou restaurar uma versão, clique na seta suspensa ao lado de Publicar, clique em Ver histórico de versões e selecione a versão a ser restaurada.

  8. Clique em Publicar para finalizar e publicar o agente de chat de fluxo de trabalho.

    Depois de publicado, o agente de chat de fluxo de trabalho aparece na galeria de agentes, pronto para processar as solicitações de usuários recebidas.

Limitações do recurso

Os agentes de chat de fluxo de trabalho têm as seguintes limitações:

  • Os detalhes de configuração de um subagente anexado não ficam visíveis no painel de configuração do agente de chat raiz. Para inspecionar ou editar o fluxo de trabalho de um subagente (como uma etapa de aprovação), abra o fluxo de trabalho individualmente na página Galeria de agentes.
  • O recurso Programar execução do agente de chat está indisponível para agentes de chat de fluxo de trabalho. As opções de programação só se aplicam a agentes sem fluxo de trabalho.
  • O recurso Compartilhar um agente de chat está indisponível para agentes de chat de fluxo de trabalho nesta versão.