As práticas recomendadas a seguir podem ajudar você a criar apps de agentes robustos.
Nome do agente em linguagem natural
Use linguagem natural com significados claros para os nomes dos agentes. Por exemplo, "Agente da Central de Ajuda do cliente" é mais descritivo do que "company_specialist", o que ajuda a melhorar o desempenho do LLM no momento da 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 simples e especificar os cenários de uso da ferramenta
Pelo menos um exemplo para cada agente
Você precisa ter pelo menos um exemplo para cada agente, mas é recomendável ter pelo menos quatro. Os exemplos devem incluir cenários de caminho 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 das instruções e dos exemplos
Embora seja útil escrever instruções claras e descritivas, a qualidade e a quantidade dos seus exemplos são o que determinam a precisão do comportamento do agente. Em outras palavras, passe mais tempo escrevendo exemplos detalhados do que escrever instruções perfeitamente precisas.
Referências a ferramentas em exemplos
Se o agente foi projetado para fornecer respostas usando ferramentas, faça referência às ferramentas nos exemplos correspondentes a esse tipo de solicitação.
Campo operationId
do esquema da ferramenta
Ao definir esquemas para suas 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
operationId
s descritos no esquema. - Precisa ser um nome significativo que reflita a capacidade fornecida.
Validação do esquema da ferramenta
Valide o esquema da ferramenta. Use o Swagger Editor para verificar a sintaxe do esquema da OpenAPI 3.0.
Processar resultados de ferramentas vazias
Quando seu 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 responder sozinho.
Alguns casos de uso exigem que as respostas do agente sejam bem fundamentadas em 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 dados da ferramenta, responda que não sabe a resposta para a consulta do usuário"
- "Não invente uma resposta se não receber dados da ferramenta"
Gerar um esquema com o Gemini
Gemini pode gerar um esquema para você. Por exemplo, tente "can you create an example openAPI 3.0 schema for Google Calendar".
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.
Evite loops e recursão
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 encaminhar para outro, forneça essas informações nos 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.".
Use as funções JavaScript do Messenger dos Agentes de conversa (Dialogflow CX) para personalização
Ao usar o Messenger, o Dialogflow CX, as funções a seguir são úteis para enviar configurações de informações da interface da Web para o agente: