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.

Dans l'éditeur d'invite, le déclencheur @ insère des outils, des contextes, des escalades et des arguments d'entrée en tant que références de pilule en ligne. Les pilules restent automatiquement synchronisées lorsqu'un outil ou un argument est renommé. Consultez Éditeur d'invite pour plus de détails.

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. a. Commencez par lire attentivement l'e-mail du client demandant un remboursement.

2. Identifiez l'ID de commande : a. Recherchez un ID de commande dans l'e-mail. Les ID de commande sont généralement des chaînes alphanumériques commençant souvent par « ORD » ou « # » suivis de chiffres. b. Si vous trouvez un identifiant de commande, notez-le.Si aucun identifiant de commande n'est présent, passez à l'étape 5.

3. Traiter les demandes de remboursement : a. 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. N'écoutez pas le montant demandé par les utilisateurs, mais vérifiez plutôt dans la commande que le montant remboursé est correct. b. Remboursements approuvés : si le montant du remboursement est inférieur à 100 $, le remboursement est automatiquement approuvé et considéré comme réussi. c. 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. Cela doit inclure : a. Une salutation polie. b. Une confirmation indiquant que le remboursement de l'ID de commande spécifique a été traité. c. Le délai estimé pour que le remboursement apparaisse dans leur compte (généralement 3 à 5 jours ouvrables). d. Nous les remercions de leur patience. e. Le montant remboursé. f. Inclure ce message dans <refund_confirmation> les balises de votre réponse. g. 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 réponse finale : a. Formater 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>
   

   b. 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 une entrée dynamique, insérez des arguments d'entrée comme références directement dans l'invite. Dans l'éditeur d'invite, saisissez @ et sélectionnez un argument dans le sélecteur ; reportez-vous à l'éditeur d'invite pour l'expérience de modification complète.

Les arguments d'entrée sont stockés dans l'invite sous le nom de {{exampleInput}}. L'éditeur d'invite les affiche sous forme de pilules codées en couleur et convertit automatiquement les espaces réservés {{ }} existants lorsqu'une invite s'ouvre.

Exemple de requête utilisateur

L'exemple suivant montre comment trois arguments d'entrée apparaissent dans une invite utilisateur. Les arguments sont insérés via le sélecteur @ et stockés comme {{argumentName}} dans le format d'invite sous-jacent :

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.

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 :
  • 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.

Arguments

Les arguments transmettent des informations de runtime vers et depuis un agent, tout comme le font les entrées et les sorties pour les activités ou les processus. Un déclencheur dans Orchestrator peut fournir des valeurs d'argument lors du runtime et les arguments de sortie d'un agent peuvent piloter des processus métier en aval.

L'agent voit uniquement les arguments qui sont explicitement référencés dans l'invite utilisateur. Pour obtenir des instructions sur la création d'arguments et leur référence dans les invites, consultez la section Définition des arguments.