Criar um agente

No Gemini Enterprise, os agentes são criados no contexto de um app. Você pode criar um novo agente de duas maneiras principais:

  • Crie um agente usando um comando: o jeito mais rápido de criar um agente. Você descreve o propósito dele e o Agent Designer gera a versão inicial para você dentro do seu app. Ideal para usar com agentes básicos ou como ponto de partida para agentes mais complexos.
  • Crie um agente usando o criador de fluxos: esse método oferece controle direto e granular sobre o design do agente desde o início. É ideal para criar agentes complexos de várias etapas que exigem configurações de subagentes e fluxos lógicos específicos.

Esses métodos são flexíveis e podem ser combinados para atender aos seus requisitos. Por exemplo, você pode começar com um comando para gerar o agente inicial e depois mudar para o criador de fluxos para refinar visualmente a lógica e adicionar complexidade.

Práticas recomendadas para criar agentes

Para garantir que seus agentes tenham um desempenho eficaz e eficiente, considere as seguintes práticas recomendadas:

  • Defina objetivos claros: declare claramente o que você quer que seu agente alcance. Um objetivo bem definido ajuda a criar a lógica do agente e avaliar a performance dele.
  • Comece pequeno, expanda depois:comece com um agente básico que lida com funcionalidades principais. Depois que ele estiver estável, adicione gradualmente mais recursos e complexidade.
  • Divida tarefas complexas: para agentes com várias etapas, divida tarefas grandes em subtarefas menores e mais fáceis de administrar. Cada subagente precisa ter um papel específico.
  • Teste de forma iterativa: teste seu agente regularmente em cada etapa de desenvolvimento. Isso ajuda a identificar e corrigir problemas mais cedo.
  • Forneça instruções claras: ao usar comandos, seja específico e conciso. Evite ambiguidades para garantir que o agente entenda o propósito dele. Consulte Práticas recomendadas para escrever comandos e criar um agente.

Antes de começar

Criar um agente usando um comando

Use esse método para gerar rapidamente um agente usando a entrada de conversação.

Console

Para criar um agente usando um comando de linguagem natural, faça o seguinte:

  1. No Google Cloud console, acesse a página Gemini Enterprise > Apps.

    Gemini Enterprise

  2. Selecione seu app e copie o URL do app da Web do Gemini Enterprise no painel.

  3. Abra o URL do app da Web em uma nova guia do navegador.

  4. No menu de navegação do app da Web, clique em + Criar agente.

    A página Agent Designer será exibida.

  5. Na caixa de chat, insira um comando que descreva o propósito e o comportamento pretendido do agente.

  6. Opcional: clique em Ícone Agentes Gerenciar seus dados e ative ou desative as fontes de dados que você quer que seu agente use.

  7. Opcional: clique em Adicionar arquivos para fazer o upload de mais materiais de referência para o seu agente.

  8. Clique em Enviar.

    A tela do Agent Designer aparece, mostrando uma visualização em tempo real do seu agente.

  9. Na guia Visualização, interaja com seu agente para testar e avaliar as respostas dele.

  10. Opcional: refine a função e o comportamento do agente fornecendo instruções adicionais no painel de chat à esquerda.

  11. Para conferir os detalhes gerais do agente, acesse a guia Fluxo e clique no nó do agente principal.

    • Opcional: na seção Conhecimento, clique em Adicionar arquivos para fazer o upload de mais materiais de referência para o seu agente.
    • Opcional: na seção Personalização, adicione comandos iniciais que orientem os usuários a interagir com o agente. É possível adicionar quantos comandos iniciais você quiser, mas o sistema mostra uma seleção aleatória de até três sugestões por vez.

  12. Opcional: clique na guia Programação para configurar programações de execução para seu agente. Para mais informações sobre as programações de agentes, consulte Programar execuções de agentes.

  13. Clique em Criar para iniciar e começar a usar seu agente.

Práticas recomendadas para escrever comandos e criar um agente

O comando que você fornece ajuda o Gemini a entender seus objetivos e gerar o melhor agente possível. Para receber respostas claras e relevantes, siga estas diretrizes e práticas recomendadas:

  • Ofereça contexto suficiente para eliminar a ambiguidade

    Seja específico sobre o que você quer que o agente faça. Por exemplo, especifique o nível de detalhes, os tipos de exemplos a serem usados ou a saída necessária. Isso ajuda o Gemini Enterprise a gerar um plano de ação que é mais relevante e específico para suas necessidades.

    Não recomendado: Create an agent for sales emails.

    Recomendado: Create an agent that drafts follow-up emails for new sales leads from my CRM. It should search for the contact's company, summarize their business, and suggest how our product can help them.

  • Defina limites ou restrições para as saídas do agente

    Defina o que o agente pode e não pode fazer. Você pode definir limites para o tamanho das respostas, o formato, o tom ou elementos específicos a serem incluídos ou excluídos. Isso ajuda o agente a se manter focado e produzir resultados mais previsíveis.

    Não recomendado: Create a sales email agent.

    Recomendado: Create an agent that drafts follow-up emails for sales leads. The drafts should always use a professional tone, be no more than three paragraphs, and never include personal information about the client.

  • Peça para o Gemini fazer perguntas

    Instrua o Gemini a fazer perguntas, se necessário. Isso permite que o Gemini colete detalhes que ele possa ter perdido e garante que o plano de ação resultante atenda às suas expectativas.

    Não recomendado: Create an agent to handle sales emails.

    Recomendado: I need an agent that can help me draft sales emails. First, ask me what information you need to effectively qualify a lead and draft a personalized message.

Exemplos de comandos eficazes

  • Exemplo simples: Create a sales email agent that drafts concise follow-up emails to new leads. The tone should be professional, and the email should be no more than three paragraphs.

  • Exemplo avançado: Create an agent that automatically drafts sales emails to leads. Use my Gmail and access emails with the 'leads' label. First, ask me to confirm which leads you should prioritize and what the main selling points are for each. Once you have this information, your drafts should be no more than three paragraphs and use a professional tone. Don't include any technical jargon or slang and never include any personal information about the client.

Criar um agente usando o criador de fluxos

Use esse método para ter controle granular sobre o design do agente, a seleção de modelos e a orquestração de várias etapas.

Console

Para criar um agente usando o criador de fluxos, 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 + Criar agente.

    A página Agent Designer será exibida.

  3. Clique em Acessar o criador para abrir diretamente a guia Agent Designer > Fluxo.

    Um agente padrão chamado Meu agente é criado na tela do Agent Designer.

  4. Para conferir e configurar os detalhes gerais do agente, clique no nó Meu agente e faça o seguinte:

    1. Nome: insira um nome para o agente.
    2. Descrição: insira um resumo do propósito do agente
    3. Instruções: forneça um conjunto detalhado de instruções que definam os objetivos, as tarefas e os comportamentos do agente.
    4. Modelo: selecione o modelo Gemini LLM que o agente vai usar.
    5. Dados e ferramentas: clique em Adicionar fontes de dados e ferramentas para adicionar as fontes de dados conectadas ao seu app.
    6. Opcional: na seção Conhecimento, clique em Adicionar arquivos para fazer o upload de mais materiais de referência para o seu agente.
    7. Opcional: na seção Personalização, adicione comandos iniciais que orientem os usuários a interagir com o agente. É possível adicionar quantos comandos iniciais você quiser, mas o sistema mostra uma seleção aleatória de até três sugestões por vez.

  5. Crie seu fluxo de subagentes:

    1. Na guia Fluxo, mantenha o ponteiro sobre o nó do agente principal e clique em Adicionar subagente.
    2. Configure os detalhes do subagente.

  6. Repita a etapa 5 conforme necessário para concluir a lógica do fluxo de subagentes.

  7. Opcional: clique na guia Programação para configurar programações de execução para seu agente.

  8. Clique na guia Visualização para interagir com seu agente e testar e avaliar se a lógica do fluxo do seu agente está funcionando como esperado.

  9. Clique em Criar para iniciar e começar a usar seu agente.

A seguir