Bonnes pratiques

Les bonnes pratiques suivantes peuvent 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, "Agent du centre d'aide client" est plus descriptif que "company_specialist", ce qui améliore les performances de 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 disposer d'au moins un exemple pour chaque agent, mais nous vous recommandons d'en avoir au moins quatre. Il peut s'agir, par exemple, de scénarios de parcours heureux.

Sans suffisamment 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 de la manière attendue, 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, c'est en fait la qualité et la quantité de vos exemples qui déterminent la précision du comportement de l'agent. En d'autres termes, consacrez plus de temps à écrire des exemples complets que 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 à ces 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 vérifier la syntaxe de votre schéma OpenAPI 3.0 à l'aide de l'éditeur Swagger.

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 hallucinera des informations en réponse à la place du résultat de l'outil. Pour éviter cela, vous pouvez ajouter des instructions spécifiques pour vous assurer que le LLM de l'agent ne tente pas de répondre de lui-même.

Certains cas d'utilisation nécessitent que les réponses de l'agent soient bien ancrées dans les résultats de l'outil ou les données fournies, et doivent limiter les réponses uniquement en fonction des connaissances du LLM de l'agent.

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, indiquez que vous ne connaissez pas la réponse à 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

Gemini peut générer un schéma pour vous. Par exemple, dites "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, envisagez de le décomposer en sous-agents plus petits.

Éviter les boucles et la récursion

Ne créez pas 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, vous devez fournir ces informations aux exemples. Cet exemple est issu du champ Fin de l'exemple avec les informations de sortie de la section Entrée et sortie.

Par exemple, la dernière phrase de ce champ peut être "Réacheminer vers 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 permettent d'envoyer à l'agent des informations de personnalisation utilisateur depuis l'interface Web: