Crie um agente

Pré-visualização

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

No Gemini Enterprise, os agentes são criados no contexto de uma app. Pode criar um novo agente de duas formas principais:

• Crie um agente com um comando: esta é a forma mais rápida de criar um agente. Descreve a finalidade do agente e o Agent Designer gera a versão inicial para si na sua app. Isto é ideal para agentes básicos ou como ponto de partida para agentes mais complexos.
• Criar um agente através do criador de fluxos: este método dá-lhe um controlo direto e detalhado sobre o design do agente desde o início. É ideal para criar agentes complexos de vários passos que requerem configurações de subagentes e fluxos lógicos específicos.

Estes métodos são flexíveis e pode combiná-los para se adequarem aos seus requisitos. Por exemplo, pode começar com um comando para gerar o agente inicial e, em seguida, mudar para o criador de fluxos para refinar visualmente a respetiva lógica e adicionar complexidade.

Práticas recomendadas para criar agentes

Para garantir que os seus agentes têm um desempenho eficaz e eficiente, considere as seguintes práticas recomendadas:

• Defina objetivos claros: indique claramente o que quer que o seu agente alcance. Um objetivo bem definido ajuda a criar a lógica do agente e a avaliar o respetivo desempenho.
• Comece em pequena escala e, em seguida, expanda: comece com um agente básico que processa as funcionalidades principais. Quando estiver estável, adicione gradualmente mais funcionalidades e complexidade.
• Divida tarefas complexas: para agentes de vários passos, divida tarefas grandes em subtarefas mais pequenas e fáceis de gerir. Cada subagente deve ter uma função específica.
• Teste iterativamente: teste regularmente o seu agente em cada fase do desenvolvimento. Isto ajuda a identificar e corrigir problemas numa fase inicial.
• Dê instruções claras: quando usar comandos, seja específico e conciso. Evite a ambiguidade para garantir que o agente compreende o seu objetivo. Consulte as práticas recomendadas para escrever comandos para criar um agente.

Antes de começar

• Certifique-se de que tem uma app com as origens de dados necessárias associadas. Para mais informações, consulte os artigos Crie uma app, Associe uma origem de dados da Google e Associe uma origem de dados de terceiros.
• Certifique-se de que ativou o botão de ativação/desativação da funcionalidade Agent Designer para a sua app Web. Para mais informações, consulte o artigo Faça a gestão das funcionalidades da app Web.

Crie um agente com um comando

Use este método para gerar rapidamente um agente através da introdução de conversação.

Consola

Para criar um agente através de um comando de linguagem natural, faça o seguinte:

1. Na Google Cloud consola, aceda à página Gemini Enterprise > Apps.

   Gemini Enterprise

2. Selecione a sua app e copie o URL da app Web Gemini Enterprise a partir do painel de controlo.

3. Abra o URL da app Web num novo separador do navegador.

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

   É apresentada a página Agent Designer.

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

   Nota: não pode usar comandos conversacionais para ativar ou estabelecer ligação a repositórios de dados da categoria Origens na nuvem (por exemplo, BigQuery, Cloud Storage, Cloud SQL). Crie o seu agente através do criador de fluxos para estas tarefas.
   Sugestão: consulte as práticas recomendadas para escrever comandos para criar um agente.

6. Opcional: clique em Gerir os seus dados e ative ou desative as origens de dados que quer que o seu agente use.

7. Clique em Enviar.

   A tela do Agent Designer é apresentada com uma pré-visualização em direto do seu agente.

8. No separador Pré-visualização, interaja com o seu agente para testar e avaliar as respetivas respostas.

9. Clique no separador Detalhes e reveja o nome e a descrição do agente.

   • Opcional: na secção Conhecimento, clique em Adicionar ficheiros para carregar materiais de referência adicionais para o seu agente.
   • Opcional: na secção Personalização, adicione comandos iniciais que orientem os utilizadores sobre como interagir com o agente. Pode adicionar quantos comandos iniciais quiser, mas o sistema mostra-lhe uma seleção aleatória de até três comandos de cada vez.

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

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

    Nota: se sair da tela do Agent Designer sem clicar em Criar, o agente fica no estado de rascunho.

Práticas recomendadas para escrever comandos para criar um agente

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

• Forneça contexto suficiente para eliminar a ambiguidade

  Seja específico sobre o que quer que o agente faça. Por exemplo, especifique o nível de detalhe, os tipos de exemplos a usar ou o resultado necessário. Isto ajuda o Gemini Enterprise a gerar um plano de agente mais relevante e específico para as 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 na saída do agente

  Defina o que o agente deve e não deve fazer. Pode definir limites para o comprimento das respostas, o formato, o tom ou elementos específicos a incluir ou excluir. Isto ajuda o agente a manter o foco e a 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 ao Gemini para lhe fazer perguntas

  Dê instruções ao Gemini para lhe fazer perguntas, se necessário. Isto permite ao Gemini recolher detalhes que possa ter perdido e garante que o plano do agente resultante cumpre as suas expetativas.

  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.

Crie um agente com o criador de fluxos

Use este método para ter um controlo detalhado sobre o design do agente, a seleção do modelo e a orquestração de vários passos.

Consola

Para criar um agente através do criador de fluxos, faça o seguinte:

1. Abra a app Web Gemini Enterprise num navegador.

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

   É apresentada a página Agent Designer.

3. Clique em Avançar para o criador para abrir diretamente o criador de fluxos visuais.

4. No separador Fluxo, adicione e configure o nó do agente principal:

   1. Nome: introduza um nome para o agente principal.
   2. Modelo: selecione o modelo GML do Gemini para o agente principal usar.
   3. Descrição: introduza um resumo da finalidade principal do agente.
   4. Instruções: faculte um conjunto detalhado de instruções que definam os objetivos, as tarefas e os comportamentos do agente.
   5. Dados e ferramentas: clique em Adicionar origens de dados e ferramentas para adicionar as origens de dados associadas à sua app.

5. Crie o fluxo de subagente:

   1. No separador Fluxo, mantenha o ponteiro sobre o nó do agente principal e, de seguida, clique em Adicionar subagente.
   2. Configure os detalhes do subagente.

6. Repita o passo 5 conforme necessário para concluir a lógica do fluxo de subagente.

7. Clique no separador Detalhes e reveja o nome e a descrição do seu agente.

   • Opcional: na secção Conhecimento, clique em Adicionar ficheiros para carregar quaisquer materiais de referência adicionais para o seu agente.
   • Opcional: na secção Personalização, adicione comandos iniciais que orientem os utilizadores sobre como interagir com o agente. Pode adicionar quantos comandos iniciais quiser, mas o sistema mostra-lhe uma seleção aleatória de até três comandos de cada vez.

8. Clique no separador Pré-visualizar para interagir com o seu agente para testar e avaliar se a lógica do fluxo do agente está a ter o desempenho esperado.

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

   Nota: se sair da tela do Agent Designer sem clicar em Criar, o agente fica no estado de rascunho.

O que se segue?

• Saiba como usar um agente.
• Saiba como editar um agente.
• Saiba como eliminar um agente.