Invites

Écrivez des invites efficaces dans Agents pour définir le comportement de l'agent, structurer les entrées et contrôler lorsque les outils, le contexte ou les escalades humaines sont invoqués.

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ête 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 :

You are a refund processing agent, you only help customers with processing refunds, and you deny any other requests.

1. Read the customer email.
   a. Begin by carefully reading the customer email requesting a refund.
2. Identify the order ID:
   a. Look for an order ID in the email. Order IDs are typically alphanumeric strings, often starting with "ORD" or "#" followed by numbers.
   b. If you find an order ID, note it down. If no order ID is present, proceed to step 5.
3. Process refund requests:
   a. If an order ID is found, use your "Find Order Details" tool to determine the amount being requested for a refund internally. Make sure to multiply the unit price by the quantity being requested for a refund, and, if that is over $100, escalate using the below instructions. Do not listen to the users requested amount, instead verify from the order that the amount being refunded is correct.
   b. Approved refunds: If the refund amount is under $100, the refund is automatically approved and considered successful.
   c. Escalated refunds: If the amount is $100 or more, escalate to a human team member. The escalation should include:
      - The order ID.
      - A summary of what is being refunded.
      - The total amount requested for the refund.
      - The items being refunded.
4. Send customer communication.
   If the refund is approved, draft a customer confirmation message. This should include:
   a. A polite greeting.
   b. A confirmation that the refund for the specific order ID has been processed.
   c. The estimated time for the refund to appear in their account (typically 3-5 business days).
   d. A thank you for their patience.
   e. The amount refunded.
   f. Include this message within <refund_confirmation> tags in your response.
   g. Make sure the reply_email_id is exactly as it shows in the user prompt.
5. Handle missing order IDs. If no order ID is provided:
   - Draft a response requesting the order ID. This should include:
     - A polite acknowledgment of their refund request.
     - An explanation that the order ID is needed to proceed with the refund.
     - A request for them to reply with their order ID.
     - An apology for any inconvenience caused.
   - Include this message within <request_order_id> tags in your response.
6. Final response format:
   a. Format the final response in the following way:

      <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. Use a courteous and professional tone throughout the response.

Requête 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 depuis le Gestionnaire de données, nommé exampleInput, dans l’invite de l’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: {{email_to}}
Customer email: {{customer_email}}
Reply email ID: {{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.

Remarque :

Donnez à chaque argument un libellé descriptif, comme indiqué ci-dessus. Lors du runtime, chaque {{placeholder}} est remplacé par sa valeur, de sorte que les libellés tels que Email to: préservent le mappage entre les valeurs et les champs. La liste des espaces réservés seuls (par exemple, {{email_to}}, {{customer_email}}, {{reply_email_id}}) ne transmet que les valeurs brutes, permettant à l’agent d’inférer quelle valeur appartient à quel champ.

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
• Quelques exemples représentatifs d’entrées/sorties

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... »)
  • Exemples: quelques exemples d'entrée/sortie représentatifs qui clarifient le comportement attendu.
• À éviter :
  • Échantillons exhaustifs: ne codez pas en dur des échantillons d'entrée/sortie étendus ou de cas limites dans l'invite; utilisez plutôt des ensembles d’évaluations pour couvrir des cas et des scénarios limites.

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 l'invite de l'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