Requêtes et arguments

Un agent performant a besoin d'une requête qui détermine clairement un plan d'action, intègre les entrées de manière bien structurée et indique quand exécuter des outils, accéder au contexte de l'entreprise ou faire appel à un humain. Pour ce faire, vous devez définir les arguments de l'agent et écrire des requêtes système et utilisateur.

Arguments des requêtes

Les arguments des requêtes 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éer des arguments dans l'onglet Arguments. Cela permet à l'agent de savoir qu'il doit collecter ces valeurs, mais ne les transmet pas dans le cadre de la requête.
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. Reportez-vous aux exemples relatifs aux requêtes système et aux requêtes utilisateur pour savoir comment utiliser les arguments dans une requête réelle.

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 schémas d'entrée/sortie.

Utilisez les onglets Input schema (Schéma d'entrée) et Output schema (Schéma de sortie) pour définir vos arguments d'entrée et de sortie. Vous pouvez configurer le nom, le type et la description de chaque argument, et indiquer s'il est obligatoire ou non.

Appuyez sur le bouton-bascule Modifier le schéma brut pour définir vos arguments au format 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

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.

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.

Utilisez la syntaxe {{exampleInput}} pour remplacer l'argument d'entrée nommé exampleInput dans la requête utilisateur au moment de l'exécution.

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.