Criar um agente de chat de fluxo de trabalho

Neste documento, descrevemos 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 poderoso orquestrador de fluxo de trabalho de vários nós para gerenciar interações de conversação.

Enquanto um agente de chat sem fluxo de trabalho é restrito a um único nó raiz com atributos fixos, um agente de chat com 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 coordenador, enviando as consultas do usuário ao subagente apropriado e retornando as respostas.

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

  • Orquestração avançada: aninhe vários agentes de fluxo de trabalho publicados ou ADK remotos como subnós para lidar com tarefas complexas do usuário.
  • Suporte ao histórico de versões: os agentes de chat do fluxo de trabalho são compatíveis com o 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:

  • Confirme se um administrador do Gemini Enterprise ativou o recurso 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 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 manualmente um agente de chat de fluxo de trabalho, 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 ícone de comando Chat.

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

  5. No painel de configuração, é possível definir o seguinte para o agente:

    • Comandos sugeridos: insira um comando que descreva o propósito e o comportamento esperado do agente.

    • Conhecimento: clique em Adicionar arquivos para fazer upload de outros 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 conectores do Google permitidos para essa interface de conversação.

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

    • Mais: selecione o modelo usado pelo agente de chat do 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 que você quer restaurar.
  8. Clique em Publicar para finalizar e publicar seu agente de chat de fluxo de trabalho.

    Depois de publicado, o agente de chat de fluxo de trabalho aparece na sua Galeria de agentes, pronto para lidar com as solicitações dos usuários.

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 não é compatível com agentes de chat de fluxo de trabalho. As opções de programação se aplicam apenas a agentes que não são de fluxo de trabalho.
  • O recurso Compartilhar um agente de chat não é compatível com agentes de chat de fluxo de trabalho nesta versão.