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:

  • 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 projetar agentes complexos e de várias etapas que exigem configurações e fluxos lógicos específicos de subagentes.

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:diga 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 expanda depois: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 ambiguidades para garantir que o agente entenda o objetivo 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 vai aparecer.

  5. Na caixa de chat, insira um comando que descreva a finalidade e o comportamento esperado do seu agente.

  6. Opcional: clique em Ícone de 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 mais materiais de referência para o agente 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 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 se quiser 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 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 as saídas esperadas. Isso ajuda o Gemini Enterprise a gerar um plano de ação 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 estabelecer limites para o tamanho, o formato ou o tom das respostas ou elementos específicos para incluir ou excluir. Isso ajuda o agente a manter o foco e a gerar 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 talvez tenham 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 vai aparecer.

  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:digite um nome para o agente.
    2. Descrição:escreva um resumo do propósito do agente.
    3. Instruções:conjunto detalhado de diretrizes que definem os objetivos, as tarefas e os comportamentos do agente.
    4. Modelo:escolha 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 se quiser 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 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