Criar um agente

No Gemini Enterprise, os agentes são criados no contexto de um app. É possível criar um novo agente de duas maneiras principais:

  • Criar um agente usando um comando: essa é a maneira mais rápida de criar um agente. Você descreve a finalidade do agente, e o Agent Designer gera a versão inicial no seu app. Isso é ideal para 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 projetar agentes complexos e de várias etapas que exigem configurações e fluxos de lógica de subagentes 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 uma performance eficaz e eficiente, considere as seguintes práticas recomendadas:

  • Defina objetivos claros:indique claramente o que você quer que o agente alcance. Um objetivo bem definido ajuda a criar a lógica do agente e avaliar o desempenho dele.
  • Comece aos poucos e depois expanda:comece com um agente básico que lida com as funcionalidades principais. Assim 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 uma função específica.
  • Teste de forma iterativa:teste seu agente regularmente em cada etapa do desenvolvimento. Isso ajuda a identificar e corrigir problemas com antecedência.
  • Dê instruções claras:ao usar comandos, seja específico e conciso. Evite ambiguidade 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 entrada de conversa.

Console

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

  1. No console Google Cloud , 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 é exibida.

  5. Na caixa de chat, insira um comando que descreva a finalidade e o comportamento esperado do seu 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 upload de outros materiais de referência que o agente pode usar.

  8. Clique em Enviar.

    A tela do Agent Designer aparece, mostrando uma prévia em tempo real do seu agente.

  9. Na guia Prévia, interaja com o agente para testar e avaliar as respostas dele.

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

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

    • Opcional: na seção Conhecimento, clique em Adicionar arquivos para fazer upload de materiais de referência adicionais para seu agente.
    • Opcional: na seção Personalização, adicione comandos iniciais que orientam os usuários sobre como 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 as programações de execução do seu agente. Para mais informações sobre 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ê envia 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

    Defina especificamente 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 esperada. Isso ajuda o Gemini Enterprise a gerar um plano de agente 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. É possível definir limites para o tamanho, o formato, o tom ou elementos específicos que devem ser incluídos ou excluídos das respostas. Isso ajuda o agente a manter o foco 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.

  • Pedir para o Gemini fazer perguntas

    Peça ao Gemini para fazer perguntas, se necessário. Isso permite que o Gemini colete detalhes que podem ter sido perdidos e garante que o plano do agente 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 é exibida.

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

    Um agente padrão chamado Meu agente é criado no canvas 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:escreva um resumo da finalidade 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 de LLM do Gemini 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 upload de materiais de referência adicionais para seu agente.
    7. Opcional: na seção Personalização, adicione comandos iniciais que orientam os usuários sobre como 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 subagente:

    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 de fluxo do subagente.

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

  8. Clique na guia Prévia 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 o agente.

A seguir