Essas práticas recomendadas podem ajudar você a criar agentes robustos.
Nome do playbook em linguagem natural
Os nomes dos playbooks precisam ser claros, descritivos e em inglês natural. Isso ajuda o desempenho do gerador de IA no ambiente de execução. Por exemplo, "Manual da Central de Ajuda do cliente" é melhor do que "especialista_da_empresa".
Mantenha todos os nomes com menos de 64 caracteres, incluindo letras em inglês e espaços.
Metas concisas
Os objetivos precisam descrever de forma concisa a finalidade do playbook.
Fornecer instruções de qualidade
Use as instruções para:
- Refletir a abordagem detalhada para resolver um problema do usuário final.
- Forneça frases concisas em linguagem natural, com instruções de alto nível.
- Especificar os cenários para o uso das ferramentas de forma direta.
Pelo menos um exemplo para cada playbook
Inclua pelo menos um exemplo para cada playbook e tente incluir pelo menos quatro exemplos. Inclua cenários ideais.
Sem exemplos suficientes, um playbook pode apresentar um comportamento imprevisível. Se o playbook não estiver respondendo ou se comportando como esperado, é provável que a causa seja a falta de exemplos ou exemplos mal definidos. Melhore os exemplos ou adicione novos.
Precisão das instruções e dos exemplos
Embora seja útil escrever instruções claras e descritivas, são a qualidade e a quantidade dos seus exemplos que determinam a precisão do comportamento do playbook. Em outras palavras, dedique mais tempo a escrever exemplos completos do que instruções perfeitamente precisas.
Ferramentas de referência em exemplos
Se o playbook 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 de ferramentas
Ao definir esquemas para suas ferramentas, o valor operationId é importante.
As instruções do manual vão fazer referência a esse valor.
Use estas recomendações de nomenclatura para esse campo:
- Use apenas letras, números e sublinhados.
- Verifique se o nome é exclusivo entre todos os
operationIds descritos no esquema. - Escolha um nome significativo que reflita o recurso fornecido.
Validação do esquema de ferramentas
Valide o esquema da ferramenta. Use o Swagger Editor para verificar a sintaxe do esquema da OpenAPI 3.0.
Processar resultados de ferramentas vazios
Quando o playbook depende de uma ferramenta para informar a resposta, um resultado vazio pode levar a um comportamento imprevisível. Às vezes, o gerador de IA do playbook vai alucinar informações em uma resposta em vez de um resultado de ferramenta. Para evitar comportamentos imprevisíveis, adicione instruções específicas para garantir que o gerador de IA do playbook não tente responder por conta própria.
Alguns casos de uso exigem que você baseie as respostas do playbook nos resultados da ferramenta ou nos dados fornecidos e mitigue as respostas com base apenas no conhecimento do gerador de IA do playbook.
Confira alguns exemplos de instruções para reduzir as alucinações:
- "Você precisa usar a ferramenta para responder a todas as perguntas do usuário."
- "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 você não receber dados da ferramenta. Em vez disso, peça para o usuário reformular a consulta ou esclarecer o que ele quer."
Gerar um esquema com o Gemini
O Gemini pode gerar um esquema para você. Por exemplo, peça para ele criar um exemplo de esquema OpenAPI 3.0 para o Google Agenda.
Playbooks focados
Não crie playbooks muito grandes e complexos. Cada playbook deve realizar uma tarefa específica e clara. Se você tiver um playbook complexo, divida-o em subplaybooks menores.
Evitar loops e recursão
Não crie loops ou recursão ao vincular agentes nas suas instruções. Um loop pode ocorrer se você tentar rotear para um playbook ancestral que, direta ou indiretamente, chamou o atual.
Fornecer informações de roteamento para exemplos
Quando um playbook encaminha para outro, forneça essas informações aos exemplos. Forneça essas informações a um exemplo do campo Concluir o exemplo com informações de saída da seção de exemplo Entrada e saída.
Por exemplo, a frase final desse campo pode ser "Retorne ao playbook padrão para outras consultas".
Usar funções JavaScript do Dialogflow CX Messenger para personalização
Ao usar o Dialogflow CX Messenger, as seguintes funções JavaScript permitem enviar informações de personalização do usuário da interface da Web para o playbook:
Planejamento de performance
Os recursos generativos geralmente levam vários segundos ou até dezenas de segundos para gerar uma resposta. Embora os playbooks melhorem a naturalidade da conversa, é importante gerenciar os tempos de resposta para manter uma experiência positiva para o usuário final.
Para otimizar o desempenho, use estas estratégias:
- Equilibre o uso de recursos generativos: considere cuidadosamente a relação entre o tempo necessário para executar vários recursos generativos e o valor que eles trazem para a conversa. Evite o uso excessivo desses recursos se eles não contribuírem significativamente para o objetivo do usuário.
- Minimizar a entrada de recursos generativos: procure coletar e processar a quantidade mínima de informações necessárias para que um gerador de IA gere uma resposta útil. Isso pode reduzir significativamente o tempo de processamento.
- Use o cache de contexto:se você estiver usando o Gemini por uma ferramenta e tiver um contexto inicial grande, use o cache de contexto da Vertex AI para evitar solicitações repetitivas para os mesmos dados.
- Implemente respostas fixas para aumentar a velocidade: se o aplicativo não exigir conteúdo dinâmico e exclusivo, considere armazenar as respostas usadas com frequência em um banco de dados tradicional, como o Firebase. Como são predefinidas e estão prontamente disponíveis, essas respostas fixas oferecem tempos de resposta muito mais rápidos do que um recurso generativo que precisa calcular uma resposta em tempo real.
- Instrua o gerador de IA a produzir respostas concisas do playbook: para entrada e saída de texto, o tempo de resposta do gerador de IA depende muito do modelo usado e do tamanho da saída. Respostas curtas podem melhorar significativamente o desempenho. Embora o tamanho da entrada também seja um fator, o tamanho da saída tem um impacto maior.