Meilleures pratiques pour la rédaction de guides

Les interactions des agents d'intelligence artificielle ne sont pas déterministes, ce qui signifie qu'ils peuvent répondre différemment à la même requête au cours de différentes sessions, même s'ils utilisent le même guide. Cependant, vous pouvez modeler leur comportement et améliorer la cohérence en suivant les meilleures pratiques lorsque vous rédigez les instructions d'un guide.

Planifiez vos guides

Lorsque vous planifiez votre guide, veillez à respecter l'objectif fixé et à faire en sorte que vos guides ne soient pas trop longs.

Faire en sorte que le guide se concentre sur une seule tâche

Il est recommandé de concevoir chaque guide de manière à ce qu'il réponde à une intention unique et bien définie du client, telle que "modifier la date de livraison" ou "vérifier le solde du compte". Le fait de limiter chaque guide à une seule intention réduit le champ d'application du LLM afin de garantir la prévisibilité et la précision. Pour les conversations impliquant plusieurs intentions, connectez plusieurs blocs de guidage au sein d'un même flux d'architecte.

Le guide doit être court

Pour élaborer un guide efficace, commencez par les étapes essentielles, validez avec des utilisateurs réels et des données, et étendez progressivement les capacités pour obtenir le résultat souhaité. Avec les bonnes bases et une approche itérative, les agents d'IA peuvent apporter une réelle valeur ajoutée à l'entreprise, en automatisant non seulement des tâches, mais aussi des flux de travail entiers, avec intelligence et adaptabilité. 

Maintenir un ton professionnel et conversationnel

Si les instructions de votre guide peuvent être techniques, l'interaction avec l'agent IA doit être naturelle. Formulez vos instructions de manière à créer un ton professionnel, utile et conversationnel.

Construisez vos guides

Suivez ces lignes directrices pour structurer, formater et créer des tâches simples et gérables.

Structurer et mettre en forme votre guide 

  • Numéroter manuellement la première étape. L'éditeur poursuit la numérotation au fur et à mesure que vous appuyez sur Entrée. 
  • Utilisez l'indentation pour représenter une forme de hiérarchie afin que votre agent d'intelligence artificielle puisse bien interpréter la structure. 
  • Utilisez des guillemets lorsque vous souhaitez que votre agent d'intelligence artificielle prononce une phrase ou un message spécifique. Par exemple, "Pouvez-vous décrire les voyants d'état de votre routeur ?".
  • Mentionner les unités ou les devises qui font partie du guide. Par exemple, "Toutes les valeurs des produits sont exprimées en euros € ".
  • Utiliser des formats spécifiques pour les dates. Par exemple, "jj/mm/aaaa".

Décomposez votre tâche en étapes simples

Diviser une tâche complexe en étapes plus simples et plus faciles à gérer. Ce processus permet à votre agent virtuel de suivre les instructions avec précision sans se laisser déborder.

  • Numérotez chaque étape dans l'ordre dans lequel vous souhaitez que votre agent d'intelligence artificielle exécute la tâche. La numérotation des étapes vous permet également de demander à votre agent IA d'interrompre l'exécution séquentielle et de passer à n'importe quelle étape du guide.
  • En outre, vous pouvez diviser votre guide en étapes principales et en sous-étapes. Grâce à cette approche, vous pouvez attribuer un nom unique à vos principales étapes, ce qui permet à votre agent d'IA de passer à l'une d'entre elles si nécessaire.
1. Basic checks
   ...
2. AB Refund
   ...
3. Refund
   ...
4. Troubleshooting
  - If customer has a model type A or B:
    - Go to: [AB Refund]
  - else if customer has any other type:
    - Go to: [Refund]

Déclencher une action ou une invite à la fin de chaque étape

  • Veillez à ce que chaque étape du guide permette à votre agent IA d'anticiper une action ou une réponse du client.
  • Si l'étape en cours ne comporte pas de demande de ce type, elle est combinée à l'étape suivante qui nécessite une réponse du client. 
  • Utilisez un message unique lorsque vous souhaitez que votre agent d'intelligence artificielle émette plusieurs messages de manière séquentielle, sans attendre de réponse de la part du client. 

Bon exemple

Mauvais exemple
  1. Recueillir les informations relatives à la commande et à l'adresse électronique du client

 - L'agent demande au client son {{Variable.orderID}}

 - Le client fournit {{Variable.orderID}}

 - L'agent demande au client son {{Variable.email}}

 - Le client fournit {{Variable.email}}

 - Appeler {{Action.getOrderStatus}} en utilisant {{Variable.orderID}} et {{Variable.email}}
  1. Recueillir les informations relatives à la commande et à l'adresse électronique du client

 - L'agent demande au client son {{Variable.orderID}}

 - L'agent demande au client son {{Variable.email}}

 - Appeler {{Action.getOrderStatus}} en utilisant {{Variable.orderID}} et {{Variable.email}}

Utilisez des crochets pour passer d'une étape à l'autre

  • Les renvois à d'autres étapes sont indiqués entre crochets. 
  • Indiquer clairement les étapes de la destination.

Bon exemple

Mauvais exemple

Passez à l'étape [Recueillir les informations sur le patient].

Passez à l'étape 2.

Réduire l'ambiguïté

  • Lors de la définition des étapes, soyez précis et spécifique quant au résultat ou à la réponse que vous attendez de l'agent d'intelligence artificielle.
  • S'abstenir d'utiliser des instructions ambiguës, vagues ou générales. Des instructions claires aident vos agents d'intelligence artificielle à produire de meilleurs résultats.
  • Fournissez autant de contexte que possible en incluant des variables, des actions de données et des conseils spécifiques sur le traitement des différents scénarios. Préparez vos agents à faire face à des scénarios inattendus grâce à un plan d'urgence. Par exemple, si un utilisateur dit "Je ne sais pas", votre agent doit reconnaître l'incertitude de l'utilisateur et répondre par "Je suis désolé, je ne suis pas en mesure de répondre à votre demande". Voulez-vous entrer en contact avec un agent humain ?". Vous pouvez ajouter une sous-étape à votre étape principale pour gérer ces scénarios inattendus.

    Prévisualiser et répéter

    • Testez votre guide en le connectant à un flux de robots architectes et affinez vos instructions jusqu'à ce que vous soyez satisfait des performances de votre agent IA. Pour plus d'informations, voir Guides de test et de dépannage.