Práticas recomendadas

As seguintes práticas recomendadas pode ajudar a criar apps robustos de agentes.

Nome do agente em linguagem natural

Use linguagem natural com significados claros para os nomes dos agentes. Por exemplo, "Cliente Agente da Central de Ajuda" é mais descritivo que "company_specialist", que ajuda Desempenho do LLM no tempo de execução.

Metas concisas

As metas precisam ser uma descrição concisa da finalidade do agente.

Fornecer instruções de qualidade

As instruções devem:

  • refletir a abordagem passo a passo para resolver um problema do usuário final
  • ser frases concisas em linguagem natural e com instruções de alto nível;
  • ser diretos e especificar os cenários de uso da ferramenta

Pelo menos um exemplo para cada agente

É preciso ter pelo menos um exemplo para cada agente, mas o recomendado é ter pelo menos quatro. Os exemplos devem incluir cenários do cenário ideal.

Sem exemplos suficientes, é provável que um agente resulte em um comportamento imprevisível. Se o agente não estiver respondendo ou se comportando da maneira esperada, a causa provavelmente é exemplos ausentes ou mal definidos. Melhore seus exemplos ou adicione novos.

Precisão de instruções e exemplos

Escrever instruções claras e descritivas ajuda é a qualidade e a quantidade dos exemplos que determinam a acurácia do comportamento do agente. Em outras palavras, passe mais tempo escrevendo exemplos detalhados do que escrever instruções perfeitamente precisas.

Ferramentas de referência em exemplos

Se o agente for projetado para fornecer respostas usando ferramentas, consulte nos exemplos que correspondem a esse tipo de solicitação.

Campo operationId do esquema da ferramenta

Ao definir esquemas para as ferramentas, o valor operationId é importante. As instruções do agente vão fazer referência a esse valor. Veja a seguir recomendações de nomenclatura para esse campo:

  • Somente letras, números e sublinhados.
  • Precisa ser único entre todos os operationIds descritos no esquema.
  • Precisa ser um nome significativo que reflita a capacidade fornecida.

Validação do esquema da ferramenta

Validar o esquema da ferramenta. Você pode usar o Editor do Swagger para verificar a sintaxe do esquema da openAPI 3.0.

Gerenciar resultados vazios de ferramentas

Quando o agente depende de uma ferramenta para informar a resposta, uma ferramenta vazia pode causar um comportamento imprevisível do agente. Às vezes, o LLM do agente alucinar informações em uma resposta em vez de um resultado de ferramenta. Para evitar isso, adicione instruções específicas para garantir que o LLM do agente não tente a resposta por conta própria.

Alguns casos de uso exigem que as respostas do agente sejam bem fundamentadas nos resultados da ferramenta ou fornecem dados e precisam reduzir as respostas com base apenas nos LLMs conhecimento.

Exemplos de instruções para mitigar alucinações:

  • "Você precisa usar a ferramenta para responder a todas as perguntas dos usuários"
  • "Se você não receber nenhum dado da ferramenta, responda que não sabe responder à consulta do usuário"
  • "Não invente uma resposta se você não receber nenhum dado da ferramenta"

Gerar um esquema com o Gemini

Gemini (em inglês) pode gerar um esquema para você. Por exemplo: tente "você pode criar um exemplo de esquema openAPI 3.0 para o Google Agenda".

Agentes focados

Evite criar agentes muito grandes e complexos. Cada agente precisa realizar uma tarefa clara e específica. Se você tiver um agente complexo, considere dividi-lo em subagentes menores.

Evitar repetições e recursões

Não crie loops ou recursão ao vincular aplicativos de agente nas suas instruções.

Forneça informações de roteamento para exemplos

Quando um agente precisa rotear para outro, você deve fornecer essas informações aos exemplos. Isso é fornecido para um exemplo do Exemplo final com informações de saída da tabela Entrada e Output.

Por exemplo: A frase final desse campo pode ser "Redirecionar de volta ao agente padrão para mais consultas.".

Usar as funções JavaScript do Dialogflow CX Messenger para personalização

Ao usar o Dialogflow CX Messenger, as funções a seguir são úteis para enviar configurações de informações da interface da Web para o agente: