Bonnes pratiques

Les bonnes pratiques suivantes peut vous aider à créer des applications d'agent robustes.

Nom de l'agent en langage naturel

Utilisez un langage naturel avec des significations claires pour les noms des agents. Par exemple, "Client de l'agent du centre d'aide" est plus descriptif que "spécialiste_entreprise", ce qui permet Performances du LLM au moment de l'exécution.

Des objectifs concis

Les objectifs doivent être une description concise de la finalité de l'agent.

Fournir des instructions sur la qualité

Les instructions doivent:

  • refléter l'approche étape par étape de la résolution d'un problème d'utilisateur final
  • être des phrases concises en langage naturel, contenant des instructions de haut niveau
  • être simple et spécifier les scénarios d'utilisation de l'outil

Au moins un exemple pour chaque agent

Vous devez en avoir au moins un exemple pour chaque agent, mais il est recommandé d'en avoir au moins quatre. Il peut s'agir, par exemple, de scénarios de parcours heureux.

Sans assez d'exemples, un agent est susceptible d'entraîner un comportement imprévisible. Si votre agent ne répond pas ou ne se comporte pas comme prévu, des exemples manquants ou mal définis en sont probablement la cause. Essayez d'améliorer vos exemples ou d'en ajouter de nouveaux.

Précision des instructions et des exemples

Bien qu'il soit utile d'écrire des instructions claires et descriptives, la qualité et la quantité des exemples, qui déterminent la précision du comportement de l'agent. Autrement dit, consacrer plus de temps à la rédaction d'exemples complets que d'écrire des instructions parfaitement précises.

Outils de référence dans les exemples

Si l'agent est conçu pour fournir des réponses à l'aide d'outils, reportez-vous à la outils dans les exemples correspondant à ce type de requête.

Champ operationId du schéma d'outil

Lorsque vous définissez des schémas pour vos outils, la valeur operationId est importante. Les instructions de votre agent feront référence à cette valeur. Voici quelques recommandations de dénomination pour ce champ:

  • Lettres, chiffres et traits de soulignement uniquement.
  • Doit être unique parmi tous les éléments operationId décrits dans le schéma.
  • Doit être un nom significatif reflétant la capacité fournie.

Validation du schéma d'outil

Vous devez valider le schéma de votre outil. Vous pouvez utiliser Éditeur Swagger pour vérifier la syntaxe de votre schéma OpenAPI 3.0.

Gérer les résultats d'outil vides

Lorsque votre agent s'appuie sur un outil pour informer sa réponse, un résultat d'outil vide peut entraîner un comportement imprévisible de l'agent. Parfois, le LLM de l'agent halluciner des informations dans une réponse au lieu d'un résultat d'outil. Pour éviter cela, vous pouvez ajouter des instructions spécifiques pour vous assurer que le LLM de l'agent n'essaie pas seule une réponse.

Certains cas d'utilisation nécessitent que les réponses des agents soient bien ancrées dans les résultats de l'outil ou données fournies et la nécessité d'atténuer les réponses uniquement en fonction des LLM de l'agent connaissances.

Exemples d'instructions pour réduire les hallucinations:

  • "Vous devez utiliser l'outil pour répondre à toutes les questions des utilisateurs"
  • « Si vous ne récupérez aucune donnée de l'outil, répondez que vous ne connaissez pas à la requête de l'utilisateur"
  • « N'inventez pas de réponse si vous ne récupérez pas de données de l'outil »

Générer un schéma avec Gemini

Gémeaux peut générer un schéma pour vous. Par exemple : essayez "pouvez-vous créer un exemple de schéma openAPI 3.0 pour Google Agenda".

Agents ciblés

Évitez de créer des agents très volumineux et complexes. Chaque agent doit accomplir une tâche spécifique et claire. Si vous avez un agent complexe, décomposez-la en sous-agents plus petits.

Éviter les boucles et la récursion

Ne pas créer de boucles ni de récursion lorsque vous associez des applications d'agent dans vos instructions.

Fournir des informations de routage aux exemples

Lorsqu'un agent doit acheminer le trafic vers un autre agent, vous devez fournir ces informations aux exemples. Ceci est fourni à un exemple issu de l'exemple final avec les informations de sortie. du champ Entrée et Output de l'exemple.

Par exemple, la dernière phrase de ce champ pourrait être "Reroutez l'agent par défaut pour d'autres requêtes."

Utiliser les fonctions JavaScript de Dialogflow CX Messenger pour la personnalisation

Lorsque vous utilisez Dialogflow CX Messenger, les fonctions suivantes sont utiles pour envoyer des informations de personnalisation les informations de l'interface Web à l'agent: