As práticas recomendadas a seguir podem ajudar você a criar agentes robustos.
Nome do playbook em linguagem natural
Use linguagem natural com significados claros para os nomes dos playbooks. Por exemplo, "Customer Help Center Playbook" é 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 playbook.
Fornecer instruções de qualidade
As instruções devem:
- refletem a abordagem detalhada para resolver um problema do usuário final
- ser frases concisas de linguagem natural com instruções de alto nível
- ser simples e especificar os cenários de uso da ferramenta
Pelo menos um exemplo para cada playbook
É preciso ter pelo menos um exemplo para cada manual, mas é recomendável ter pelo menos quatro. Os exemplos devem incluir cenários de caminho ideal.
Sem exemplos suficientes, um playbook provavelmente resultará em um comportamento imprevisível. Se o playbook não estiver respondendo ou se comportando da maneira esperada, é provável que a causa seja a falta de exemplos ou a definição inadequada deles. Tente melhorar seus exemplos ou adicionar outros.
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 playbook. Em outras palavras, gaste mais tempo escrevendo exemplos completos do que instruções perfeitamente precisas.
Referências a ferramentas em exemplos
Se o playbook foi criado 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 playbook vão fazer referência a esse valor.
Confira a seguir as recomendações de nomenclatura para este campo:
- Somente letras, números e sublinhados.
- Precisa ser exclusivo entre todos os
operationIds 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 o playbook depende de uma ferramenta para informar a resposta, um resultado vazio pode levar a um comportamento imprevisível. Às vezes, o LLM do playbook 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 playbook não tente responder sozinho.
Alguns casos de uso exigem que as respostas do playbook sejam bem fundamentadas nos resultados da ferramenta ou nos dados fornecidos e precisam mitigar as respostas com base apenas no conhecimento do LLM do playbook.
Exemplos de instruções para reduzir o número de 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
O Gemini pode gerar um esquema para você. Por exemplo, tente "can you create an example openAPI 3.0 schema for Google Calendar".
Playbooks focados
Evite criar playbooks muito grandes e complexos. Cada playbook precisa realizar uma tarefa específica e clara. Se você tiver um playbook complexo, divida-o em subplaybooks menores.
Evite loops e recursões
Não crie loops ou recursões ao vincular agentes nas suas instruções.
Fornecer informações de roteamento para exemplos
Quando um playbook precisa encaminhar para outro, forneça essas informações aos exemplos. Isso é fornecido como um exemplo do campo Exemplo final com informações de saída da seção de exemplo Entrada e saída.
Por exemplo, a frase final deste campo pode ser "Redirecionar de volta ao playbook padrão para outras consultas".
Usar funções JavaScript do Messenger de agentes de conversação (Dialogflow CX) para personalização
Ao usar o Messenger de agentes de conversação (Dialogflow CX), as seguintes funções são úteis para enviar informações de personalização do usuário da interface da Web para o playbook: