As seguintes práticas recomendadas podem ajudar a criar agentes robustos.
Nome do guia interativo em linguagem natural
Os nomes dos manuais de soluções devem ser claros, descritivos e em inglês natural. Isto ajuda a melhorar o desempenho do gerador de IA em tempo de execução. Por exemplo, "Manual do Centro de Ajuda ao Cliente" é melhor do que "especialista_empresa".
Mantenha todos os nomes com menos de 64 carateres, incluindo o alfabeto inglês e espaços.
Objetivos concisos
Os objetivos devem ser uma descrição concisa da finalidade do manual de estratégias.
Forneça instruções de qualidade
As instruções devem:
- Refletir a abordagem passo a passo para resolver um problema do utilizador final
- Ser frases de linguagem natural concisas de instruções de alto nível
- Ser direto e especificar os cenários de utilização das ferramentas
Pelo menos um exemplo para cada manual
Deve ter, pelo menos, um exemplo para cada manual, mas é recomendável ter, pelo menos, quatro. Os exemplos devem incluir cenários de caminho feliz.
Sem exemplos suficientes, é provável que um guia interativo resulte num comportamento imprevisível. Se o seu manual não estiver a responder ou a comportar-se da forma esperada, é provável que a causa sejam exemplos em falta ou mal definidos. Experimente melhorar os exemplos ou adicionar novos.
Precisão das instruções e exemplos
Embora seja útil escrever instruções claras e descritivas, é realmente a qualidade e a quantidade dos seus exemplos que determinam a precisão do comportamento do manual. Por outras palavras, é melhor dedicar mais tempo a escrever exemplos detalhados do que instruções perfeitamente precisas.
Ferramentas de referência em exemplos
Se o livro de regras for concebido para fornecer respostas através da utilização de ferramentas, consulte as ferramentas nos exemplos correspondentes a este tipo de pedido.
Campo operationId
do esquema de ferramentas
Quando define esquemas para as suas ferramentas,
o valor operationId
é importante.
As instruções do guia interativo vão fazer referência a este valor.
Seguem-se recomendações de nomenclatura para este campo:
- Apenas letras, números e sublinhados.
- Tem de ser único entre todos os
operationId
s descritos no esquema. - Tem de ser um nome significativo que reflita a capacidade fornecida.
Validação do esquema da ferramenta
Deve validar o esquema da ferramenta. Pode usar o Swagger Editor para verificar a sintaxe do esquema OpenAPI 3.0.
Processar resultados de ferramentas vazios
Quando o seu livro de jogadas depende de uma ferramenta para informar a respetiva resposta, um resultado da ferramenta vazio pode levar a um comportamento imprevisível do livro de jogadas. Por vezes, o gerador de IA do manual de estratégias alucina informações numa resposta em vez de apresentar o resultado de uma ferramenta. Para evitar esta situação, pode adicionar instruções específicas para garantir que o gerador de IA do manual de estratégias não tenta responder sozinho.
Alguns exemplos de utilização requerem que as respostas do manual de instruções estejam bem fundamentadas nos resultados das ferramentas ou nos dados fornecidos e que mitiguem as respostas baseadas apenas nos conhecimentos do gerador de IA do manual de instruções.
Exemplos de instruções para mitigar alucinações:
- "Tem de usar a ferramenta para responder a todas as perguntas dos utilizadores"
- "Se não receber dados da ferramenta, responda que não sabe a resposta à consulta do utilizador"
- "Não invente uma resposta se não receber dados da ferramenta"
Gere um esquema com o Gemini
O Gemini pode gerar um esquema para si. Por exemplo, experimente "podes criar um exemplo de esquema OpenAPI 3.0 para o Calendário Google".
Guias interativos focados
Evite criar manuais de estratégias muito grandes e complexos. Cada manual deve realizar uma tarefa específica e clara. Se tiver um manual de estratégias complexo, considere dividi-lo em submanuais de estratégias mais pequenos.
Evite ciclos e recursão
Não crie ciclos nem recursão quando associar agentes nas suas instruções. Pode ocorrer um ciclo se tentar encaminhar para um manual de estratégias antecessor que, direta ou indiretamente, chamou o atual.
Forneça informações de encaminhamento para exemplos
Quando um manual de soluções deve encaminhar para outro manual de soluções, deve fornecer estas informações aos exemplos. Isto é fornecido num exemplo do campo End example with output information da secção de exemplo Input & Output.
Por exemplo, a frase final deste campo pode ser "Redirecione para o manual de procedimentos predefinido para mais consultas".
Use funções JavaScript do Messenger de agentes conversacionais (Dialogflow CX) para personalização
Quando usa o Messenger de agentes conversacionais (Dialogflow CX), as seguintes funções são úteis para enviar informações de personalização do utilizador da interface Web para o playbook:
Planeamento do desempenho
Normalmente, as funcionalidades generativas requerem vários segundos ou até dezenas de segundos para gerar uma resposta. Embora os guias de procedimentos melhorem a naturalidade da conversa, é fundamental gerir os tempos de resposta para manter uma experiência positiva do utilizador final. Seguem-se algumas estratégias para otimizar o desempenho:
Equilibre a utilização das funcionalidades generativas
Considere cuidadosamente a contrapartida entre o tempo necessário para executar várias funcionalidades generativas e o valor que trazem para a conversa. Evite usar estas funcionalidades em excesso se não contribuírem significativamente para o objetivo do utilizador.
Minimize a entrada de funcionalidades generativas
Procure recolher e processar a quantidade mínima de informações necessárias para um gerador de IA gerar uma resposta útil. Isto pode reduzir significativamente o tempo de processamento.
Use a cache de contexto
Se estiver a usar o Gemini através de uma ferramenta e tiver um contexto inicial grande, explore as informações de colocação em cache através da cache de contexto da Vertex AI para evitar pedidos repetitivos dos mesmos dados. Implemente respostas fixas para aumentar a velocidade:
Se a sua aplicação não exigir conteúdo dinâmico exclusivo, considere armazenar respostas usadas com frequência numa base de dados tradicional, como o Firebase. Como são predefinidas e estão prontamente disponíveis, estas respostas fixas oferecem tempos de resposta muito mais rápidos do que uma funcionalidade generativa que precisa de calcular uma resposta em tempo real.
Dê instruções ao gerador de IA para produzir respostas concisas do manual
Para a entrada e saída de texto, o tempo de resposta do gerador de IA depende muito do modelo usado e do comprimento da saída. As respostas curtas podem melhorar significativamente o desempenho. Embora o comprimento da entrada também seja um fator, o comprimento da saída tem um impacto maior.