Invites

Un agent performant nécessite des instructions qui déterminent clairement un plan d'action, intègrent les entrées de manière bien structurée et indiquent quand exécuter des outils, accéder au contexte d'entreprise ou faire appel à une intervention humaine. Pour ce faire, vous devez écrire des requêtes et définir les arguments de l'agent.

Requêtes système

Les requêtes système vous permettent de décrire en langage naturel le rôle, l'objectif et les contraintes d'un agent. Vous spécifiez les règles qu'il doit suivre et ajoutez des informations précisant quand il peut utiliser certains outils, escalades ou contextes.

La requête système aide l'agent à élaborer un plan qu'il utilise et adapte au fil du temps en fonction des interactions avec les outils, les robots et les humains. Une bonne requête système suggère une séquence d'étapes, présente certains cas et indique à un agent quand il doit faire appel à des outils ou processus d'escalade.

Exemple de requête système

Voici un exemple de requête bien structurée :

Vous êtes un agent de traitement des remboursements, vous aidez uniquement les clients à traiter les remboursements et vous refusez toute autre demande.

1. Lisez l'e-mail du client.
   1. Commencez par lire attentivement l'e-mail du client demandant un remboursement.
2. Identifiez l'identifiant de la commande :
   1. Recherchez un identifiant de commande dans l'e-mail. Les identifiants de commande sont généralement des chaînes alphanumériques qui commencent souvent par les caractères « ORD » ou « # » suivis de chiffres.
   2. Si vous trouvez un identifiant de commande, notez-le.Si aucun identifiant de commande n'est présent, passez à l'étape 5.
3. Requêtes de demande de remboursement :
   1. Si un numéro de commande est trouvé, utilisez votre outil « Trouver les détails de la commande » pour déterminer le montant demandé pour un remboursement en interne. Veillez à multiplier le prix unitaire par la quantité demandée pour un remboursement et, si ce montant est supérieur à 100 $, escaladez la demande en suivant les instructions ci-dessous. Ne tenez pas compte du montant demandé par l'utilisateur, mais vérifiez la commande pour vous assurer que le montant remboursé est correct.
   2. Remboursements approuvés : si le montant du remboursement est inférieur à 100 $, le remboursement est automatiquement approuvé et considéré comme réussi.
   3. Remboursements escaladés : si le montant est égal ou supérieur à 100 $, transférez le cas à un membre humain de l'équipe. Le processus d'escalade doit inclure :
      • L'identifiant de la commande.
      • Un résumé de ce qui est remboursé.
      • Le montant total du remboursement demandé.
      • Les articles remboursés.
4. Envoyez une communication au client. Si le remboursement est approuvé, écrivez un message de confirmation au client. Il doit inclure :
   1. Une salutation polie.
   2. Une confirmation indiquant que le remboursement de l'identifiant de commande spécifique a été traité.
   3. Le délai estimé pour que le remboursement apparaisse sur leur compte (généralement de 3 à 5 jours ouvrables).
   4. Un remerciement pour leur patience.
   5. Le montant remboursé.
   6. Incluez ce message au sein de balises <refund_confirmation> dans votre réponse.
   7. Assurez-vous que le texte Reply_Email_ID est exactement tel qu'il apparaît dans la requête utilisateur.
5. Gérez les identifiants de commande manquants. Si aucun identifiant de commande n'est fourni :
   • Rédigez une réponse demandant l'identifiant de la commande. Il doit inclure :
     • Une confirmation polie de la réception de leur demande de remboursement.
     • Une explication indiquant que l'identifiant de la commande est nécessaire pour procéder au remboursement.
     • Une demande leur indiquant de répondre avec l'identifiant de leur commande.
     • Nous vous prions de nous excuser pour tout inconvénient que cela a pu vous causer.
   • Incluez ce message au sein de balises <request_order_id> dans votre réponse.
6. Format de la réponse finale :
   1. Formatez la réponse finale de la manière suivante :

      <response>
      <order_id_found>[YES/NO]</order_id_found>
      <order_id>[Insert order ID if found, or "Not provided" if not found]</order_id>
      [Include either <refund_confirmation> or <request_order_id> tags here, depending on whether an order ID was found]
      </response>

   2. Utilisez un ton courtois et professionnel tout au long de la réponse.

Requêtes utilisateur

Les requêtes utilisateur vous permettent de structurer la façon dont les entrées et les arguments sont transmis à l'agent. Vous pouvez également indiquer dans la requête utilisateur comment vous faites référence à certaines entrées dans la requête système.

Pour intégrer des entrées dynamiques dans vos requêtes utilisateur au moment de l'exécution, utilisez la syntaxe suivante : {{exampleInput}}. Ce format vous permet d'intégrer votre argument d'entrée, défini dans Data Manager (Gestionnaire de données), nommé exampleInput, dans la requête utilisateur.

Exemple de requête utilisateur

Voici un exemple de requête utilisateur utilisant la syntaxe correcte :

You will take as input the following arguments:
{{Email_To}}, {{Customer_Email}}, {{Reply_Email_ID}}

Où :

• EMAIL_TO est l'adresse e-mail du client à laquelle l'e-mail doit répondre afin de confirmer ou de rejeter le remboursement.
• CUSTOMER_EMAIL est le contenu réel de l'email envoyé par le client.
• REPLY_EMAIL_ID est l'ID que l'agent doit inclure dans sa réponse au client.

Utilisez la syntaxe {{}} pour vous assurer que les arguments d'entrée sont transmis correctement.

Rédiger des invites efficaces

Les requêtes agentiques ne fonctionnent pas comme les interactions LLM traditionnelles. Elles intègrent des jeux d'instructions qui guident l'agent dans un raisonnement en plusieurs étapes et dans la décomposition des tâches. Contrairement aux requêtes de base qui demandent une sortie directe, les requêtes agentiques fournissent un cadre complet permettant de résoudre des problèmes. Cela inclut la mise en contexte, la définition du rôle, des instructions étape par étape et des exigences de raisonnement explicites.

Voici quelques éléments à garder à l'esprit lorsque vous rédigez des requêtes.

But et objectif clairs

Avant de développer un agent, vous devez définir son objectif et les résultats escomptés. Cela signifie :

• Formuler des objectifs spécifiques et mesurables.
• Comprendre l'environnement dans lequel l'agent opérera.
• Identifier les indicateurs clés de performance.
• Définir des critères de réussite clairs.

Structure

Les requêtes doivent inclure :

• Définition claire du rôle et du persona
• Décomposition explicite des tâches
• Instructions méthodologiques de raisonnement
• Mécanismes de gestion des erreurs et d'autocorrection
• Exigences relatives au format de sortie
• Informations générales contextuelles

Par exemple, utilisez la liste suivante des pratiques à utiliser et à éviter pour apprendre à structurer des requêtes efficaces :

• À faire :
  • Définition du rôle : quel rôle joue l'IA ? (« Vous êtes un agent du service clientèle... »)
  • Spécification de l'objectif : que doit-il faire ? (« Répondez aux questions liées au prix et aux fonctionnalités des produits... »)
  • Instructions et contraintes : choses à faire ou à éviter ?(« Utilisez des réponses de moins de 200 mots, évitez le jargon technique... »)
• À éviter :
  • Exigences de format : ne mentionnez pas de structure de sortie spécifique (par exemple, « Répondez sous forme de liste numérotée… »), car cela est déjà couvert dans la sortie.
  • Exemples : ne donnez pas d'exemples d'entrées et de sorties attendues, car cela est déjà couvert dans les arguments d'entrée et de sortie.

Itérations

Une itération efficace implique une modification systématique des composants de la requête :

• Ajustez les instructions du rôle.
• Modifiez les stratégies de décomposition des tâches.
• Expérimentez avec des cadres de raisonnement.
• Testez différentes exigences de formatage de sortie.
• Introduisez des détails contextuels supplémentaires.

L'objectif est de découvrir l'ensemble de requêtes minimal permettant à l'agent de produire systématiquement des comportements fiables de haute qualité. Documentez les résultats de chaque itération en suivant à la fois les performances qualitatives et les mesures quantitatives, telles que la précision et l'exhaustivité des réponses, et le respect des contraintes spécifiées.

Définir les arguments

Les arguments permettent à un agent de recueillir des informations sur un cas métier et de fournir un résultat, tout comme le font les activités ou les processus. Cela signifie que vous pouvez transmettre des informations provenant d'un déclencheur d'Orchestrator ou utiliser la sortie d'un agent pour lancer un autre processus métier.

Pour qu'un agent puisse voir les arguments d'entrée, vous devez :

1. Créez des arguments dans le panneau Data Manager (Gestionnaire de données).
2. Référencez les arguments de la requête utilisateur en utilisant la syntaxe {{argumentName}}. Cela permet de remplacer la valeur de l'argument dans la requête afin de la présenter à l'agent dans sa fenêtre contextuelle.

L'agent utilise toujours la requête utilisateur, mais ne voit les arguments que s'ils sont explicitement mentionnés.

Vous devez fournir la description des arguments d'entrée et de sortie. La description doit être précise afin que l'agent puisse utiliser l'argument efficacement.

Remarque : pour que les arguments soient correctement substitués dans la requête utilisateur, les noms doivent correspondre exactement. Si un argument est appelé EXAMPLE_ARG, il doit être remplacé en utilisant la syntaxe suivante : {{EXAMPLE_ARG}}.

Définir les arguments d'entrée et de sortie

Dans le panneau Data manager (Gestionnaire de données), définissez vos arguments d'entrée et de sortie dans les onglets Input (Entrée) et Output (Sortie). Vous pouvez configurer le nom, le type et la description de chaque argument, et indiquer s'il est obligatoire ou non.

Sélectionnez le bouton Generate from payload (Générer à partir de la charge utile) pour générer vos arguments au format JSON.

Utilisez le bouton d'icône crochets en chevron pour basculer entre les vues du générateur de propriétés et de l'éditeur JSON.

Types d'arguments pris en charge

Les types d'argument suivants sont pris en charge :

• Chaîne de caractères (string)
• Numérique
• Entier
• Booléen
• Objet
• Tableau