Guide de prompting

Principes de conception de systèmes pour une IA conversationnelle prête pour la production

Introduction

Un prompting efficace transforme ElevenLabs Agents, d’un système robotique en une expérience réaliste.

Guide de prompting pour ElevenLabs Agents

Un prompt système constitue le plan de personnalité et de règles de votre agent IA. En entreprise, il est généralement élaboré : il définit le rôle, les objectifs et les outils autorisés de l’agent, des instructions étape par étape pour certaines tâches, ainsi que des garde-fous décrivant ce que l’agent ne doit pas faire. La structure de ce prompt a un impact direct sur sa fiabilité.

Le prompt système contrôle le comportement conversationnel et le style de réponse, mais ne contrôle pas les mécanismes de déroulement de la conversation tels que la prise de parole, ni les paramètres de l’agent comme les langues qu’il peut parler. Ces aspects sont gérés au niveau de la plateforme.

Itérez sur les prompts depuis votre assistant IA

Le serveur MCP hébergé permet à Claude et aux autres clients MCP de lire et de mettre à jour directement le prompt système d’un agent, afin que vous puissiez rédiger, examiner et affiner des prompts de manière conversationnelle.

Cadre de fiabilité des agents
d’entreprise

Principes fondamentaux de l’ingénierie des prompts

Un prompt système définit la personnalité et les règles de votre agent IA. En entreprise, il est généralement détaillé : il définit le rôle et les objectifs de l’agent, les outils autorisés, des instructions étape par étape pour certaines tâches et des garde-fous précisant ce que l’agent ne doit pas faire. La manière dont vous structurez ce prompt a un impact direct sur sa fiabilité.

Les principes suivants constituent la base d’une ingénierie des prompts adaptée à la production :

Séparez les instructions en sections distinctes

Séparer les instructions en sections dédiées avec des titres Markdown aide le modèle à les hiérarchiser et à les interpréter correctement. Utilisez des espaces et des sauts de ligne pour distinguer les instructions.

Pourquoi c’est important pour la fiabilité : Les modèles sont entraînés à accorder une attention particulière à certains titres, notamment # Guardrails, et des limites de section claires évitent que des règles d’un contexte influencent un autre contexte.

You are a customer service agent. Be polite and helpful. Never share sensitive data. You can look up orders and process refunds. Always verify identity first. Keep responses under 3 sentences unless the user asks for details.

Soyez aussi concis que possible

Gardez chaque instruction courte, claire et orientée vers l’action. Supprimez les mots superflus et ne reformulez que ce qui est indispensable pour que le modèle agisse correctement.

Pourquoi c’est important pour la fiabilité : Des instructions concises réduisent l’ambiguïté et l’utilisation de jetons. Chaque mot inutile est une source potentielle de mauvaise interprétation.

# Tone
When you're talking to customers, you should try to be really friendly and approachable, making sure that you're speaking in a way that feels natural and conversational, kind of like how you'd talk to a friend, but still maintaining a professional demeanor that represents the company well.

Si l’agent doit adopter un ton précis, définissez-le explicitement et de façon concise dans la section # Personality ou # Tone. Évitez de répéter les consignes relatives au ton dans l’ensemble du prompt.

Mettez en évidence les instructions critiques

Soulignez les étapes critiques en ajoutant « Cette étape est importante » à la fin de la ligne. Répéter deux fois dans le prompt les une à deux instructions les plus importantes peut aider à les renforcer.

Pourquoi c’est important pour la fiabilité : Dans les prompts complexes, les modèles peuvent donner la priorité au contexte récent plutôt qu’aux instructions antérieures. L’accentuation et la répétition garantissent que les règles critiques ne sont pas négligées.

# Goal
Verify customer identity before accessing their account.
Look up order details and provide status updates.
Process refund requests when eligible.

Normalisation du texte

Les modèles de synthèse vocale, en particulier les plus rapides, génèrent mieux la parole à partir de texte alphabétique. Les chiffres et les symboles comme « @ » ou « £ » sont donc plus susceptibles d’entraîner des prononciations incorrectes ou des hallucinations vocales.

Pour y remédier, nous normalisons le texte non alphabétique en mots avant qu’il n’atteigne le modèle TTS (par exemple, 123 -> one-hundred and twenty three, john@gmail.com -> john at gmail dot com) et vous permettons de choisir parmi différentes stratégies de normalisation, avec des compromis différents.

Stratégies de normalisation

Nous proposons deux stratégies de normalisation via la configuration d’agent text_normalisation_type :

system_prompt (par défaut) : ajoute au prompt système des instructions demandant au LLM d’écrire les chiffres et symboles en toutes lettres avant que le texte n’atteigne le modèle TTS.

  • Aucune latence supplémentaire
  • Les LLM peuvent parfois ne pas normaliser correctement
  • Les transcriptions contiennent tous les éléments écrits en toutes lettres (par exemple, « one thousand dollars » plutôt que « $1,000 »)

Si vous ne souhaitez pas utiliser le normaliseur TTS et constatez que le LLM répond encore parfois avec du texte non normalisé, envisagez de passer à un LLM plus performant ou d’ajouter des instructions supplémentaires de normalisation au prompt système.

elevenlabs : utilise notre normaliseur TTS pour normaliser le texte après sa génération par le LLM, avant qu’il n’atteigne le modèle TTS.

  • Plus fiable que la normalisation basée sur un LLM
  • Le prompt système n’est pas modifié
  • Les transcriptions conservent une mise en forme naturelle avec les symboles et les chiffres (par exemple, « $1,000 »)
  • Ajoute une faible latence

Si la lisibilité des transcriptions est importante pour votre cas d’utilisation, envisagez d’utiliser le normaliseur elevenlabs. Il conserve des transcriptions claires avec des symboles et des chiffres naturels tout en produisant un audio correctement prononcé.

Vous trouverez cette configuration sur notre plateforme, dans l’onglet « Agent » : cliquez sur l’icône d’engrenage de la section « Voices » pour ouvrir le panneau des paramètres vocaux communs, puis configurez-la en bas de celui-ci.

Données structurées pour les entrées d’outils

Avec le paramètre de normalisation system_prompt, le LLM écrit les symboles et les chiffres en toutes lettres dans ses réponses (par exemple, john at gmail dot com au lieu de john@gmail.com). Les transcriptions utilisateur issues de la reconnaissance vocale peuvent également arriver sous une forme non standard. Ainsi, lorsque vous utilisez ces informations comme paramètres dans des appels d’outils, le LLM peut utiliser la version non structurée présente dans le contexte de conversation.

Si un paramètre d’outil attend une valeur correctement formatée, par exemple john@gmail.com et non john at gmail dot com, le LLM doit le savoir. Indiquez le format attendu directement dans la description du paramètre d’outil, avec un exemple.

## `lookupAccount` tool parameters
- `email` (required): "The user's email."
- `phone` (required): "The user's phone number."
- `confirmation_code` (required): "The user's confirmation code."

Consacrez une section aux garde-fous

Listez toutes les règles non négociables que le modèle doit toujours respecter dans une section # Guardrails dédiée. Les modèles sont entraînés à accorder une attention particulière à ce titre.

Pourquoi c’est important pour la fiabilité : Les garde-fous empêchent les réponses inappropriées et garantissent le respect des politiques. Les centraliser dans une section dédiée facilite leur audit et leur mise à jour.

Approche recommandée
# Guardrails
Never share customer data across conversations or reveal sensitive account information without proper verification.
Never process refunds over $500 without supervisor approval.
Never make promises about delivery dates that aren't confirmed in the order system.
Acknowledge when you don't know an answer instead of guessing.
If a customer becomes abusive, politely end the conversation and offer to escalate to a supervisor.

Pour en savoir plus sur la conception de garde-fous efficaces, consultez notre guide sur les garde-fous.

Configuration des outils pour la fiabilité

Les agents capables de gérer des flux de travail transactionnels peuvent être très efficaces. Pour cela, ils doivent disposer d’outils leur permettant d’effectuer des actions dans d’autres systèmes ou d’en récupérer des données en temps réel.

La façon dont vous décrivez les outils disponibles pour votre agent est aussi importante que la structure du prompt. Des définitions d’outils claires et orientées vers l’action aident le modèle à les appeler correctement et à se remettre correctement des erreurs.

Décrivez précisément les outils avec des paramètres détaillés

Lorsque vous créez un outil, ajoutez une description à tous ses paramètres. Cela aide le LLM à construire correctement les appels d’outils.

Description de l’outil : « Recherche le statut d’une commande client par son identifiant et renvoie le statut actuel, la date de livraison estimée et le numéro de suivi. »

Descriptions des paramètres :

  • order_id (obligatoire) : « L’identifiant unique de la commande, au format de caractères écrits (par exemple, ‘ORD123456’) »
  • include_history (facultatif) : « Si la valeur est true, renvoie l’historique complet de la commande, y compris les changements de statut »

Pourquoi c’est important pour la fiabilité : Les descriptions de paramètres servent de documentation intégrée pour le modèle. Elles précisent les formats attendus, les champs obligatoires ou facultatifs et les valeurs acceptées.

Expliquez dans le prompt système quand et comment utiliser chaque outil

Définissez clairement dans votre prompt système quand et comment chaque outil doit être utilisé. Ne vous fiez pas uniquement aux descriptions des outils : fournissez le contexte d’utilisation et la logique de séquencement.

Approche recommandée
# Tools
You have access to the following tools:
## `getOrderStatus`
Use this tool when a customer asks about their order. Always call this tool before providing order information—never rely on memory or assumptions.
**When to use:**
- Customer asks "Where is my order?"
- Customer provides an order number
- Customer asks about delivery estimates
**How to use:**
1. Collect the order ID from the customer
2. Call `getOrderStatus` with the order ID
3. Present the results to the customer in natural language
**Error handling:**
If the tool returns "Order not found", ask the customer to verify the order number and try again.
## `processRefund`
Use this tool only after verifying:
1. Customer identity has been confirmed
2. Order is eligible for refund (within 30 days, not already refunded)
3. Refund amount is under $500 (escalate to supervisor if over $500)
**Required before calling:**
- Order ID (from `getOrderStatus`)
- Refund reason code
- Customer confirmation
This step is important: Always confirm refund details with the customer before calling this tool.

Indiquez les formats attendus dans les descriptions des paramètres d’outils

Lorsque des outils nécessitent des identifiants structurés, comme des emails, des numéros de téléphone ou des codes, indiquez explicitement le format attendu dans la description du paramètre, avec un exemple. C’est particulièrement important, car la normalisation et la transcription parole-texte peuvent produire des valeurs sous forme orale dans le contexte de conversation. Consultez les données structurées pour les entrées d’outils pour plus de contexte.

## `lookupAccount` tool parameters
- `email` (required): "The customer's email address."

Gérez correctement les échecs d’appels d’outils

Les outils peuvent parfois échouer en raison de problèmes réseau, de données manquantes ou d’autres erreurs. Incluez des instructions claires de récupération dans votre prompt système.

Pourquoi c’est important pour la fiabilité : Les échecs d’outils sont inévitables en production. Sans instructions explicites de gestion, les agents peuvent halluciner des réponses ou fournir des informations incorrectes.

Approche recommandée
# Tool error handling
If any tool call fails or returns an error:
1. Acknowledge the issue to the customer: "I'm having trouble accessing that information right now."
2. Do not guess or make up information
3. Offer alternatives:
- Try the tool again if it might be a temporary issue
- Offer to escalate to a human agent
- Provide a callback option
4. If the error persists after 2 attempts, escalate to a supervisor
**Example responses:**
- "I'm having trouble looking up that order right now. Let me try again... [retry]"
- "I'm unable to access the order system at the moment. I can transfer you to a specialist who can help, or we can schedule a callback. Which would you prefer?"

Pour des conseils détaillés sur la création d’intégrations d’outils fiables, consultez notre documentation sur les outils client, les outils webhook et les outils MCP.

Modèles d’architecture pour les agents d’entreprise

Si des prompts et des outils solides constituent la base de la fiabilité des agents, les systèmes de production nécessitent une conception architecturale réfléchie. Les agents d’entreprise gèrent des flux de travail complexes qui dépassent souvent le cadre d’un prompt monolithique unique.

Gardez les agents spécialisés

Des instructions trop générales ou de grandes fenêtres de contexte augmentent la latence et réduisent la précision. Chaque agent doit disposer d’une base de connaissances restreinte et clairement définie, ainsi que d’un ensemble de responsabilités précis.

Pourquoi c’est important pour la fiabilité : Les agents spécialisés ont moins de cas limites à gérer, des critères de réussite plus clairs et des temps de réponse plus rapides. Ils sont plus faciles à tester, à déboguer et à améliorer.

Un agent généraliste qui « fait tout » est plus difficile à maintenir et plus susceptible d’échouer en production qu’un réseau d’agents spécialisés avec des transferts clairement définis.

Utilisez des modèles orchestrateur et spécialiste

Pour les tâches complexes, concevez des flux de travail multi-agents qui transfèrent les tâches entre agents spécialisés et, lorsque nécessaire, à des opérateurs humains.

Modèle d’architecture :

  1. Agent orchestrateur : Oriente les requêtes entrantes vers les agents spécialistes appropriés selon la classification de l’intention
  2. Agents spécialistes : Gèrent les tâches propres à un domaine, comme la facturation, la planification ou le support technique
  3. Escalade humaine : Critères de transfert définis pour les cas complexes ou sensibles

Avantages de ce modèle :

  • Chaque spécialiste dispose d’un prompt ciblé et d’un contexte réduit
  • Il est plus facile de mettre à jour des spécialistes individuels sans affecter le système
  • Des métriques claires par domaine, comme le taux de résolution de facturation ou le taux de réussite de planification
  • Une latence réduite par interaction, grâce à des prompts plus courts et une inférence plus rapide

Définissez des critères de transfert clairs

Lors de la conception de flux de travail multi-agents, précisez exactement quand et comment le contrôle doit être transféré entre agents ou à des opérateurs humains.

Exemple d’agent orchestrateur
# Goal
Route customer requests to the appropriate specialist agent based on intent.
## Routing logic
**Billing specialist:** Customer mentions payment, invoice, refund, charge, subscription, or account balance
**Technical support specialist:** Customer reports error, bug, issue, not working, broken
**Scheduling specialist:** Customer wants to book, reschedule, cancel, or check appointment
**Human escalation:** Customer is angry, requests supervisor, or issue is unresolved after 2 specialist attempts
## Handoff process
1. Classify customer intent based on first message
2. Provide brief acknowledgment: "I'll connect you with our [billing/technical/scheduling] team."
3. Transfer conversation with context summary:
- Customer name
- Primary issue
- Any account identifiers already collected
4. Do not repeat information collection that already occurred
Exemple d’agent spécialiste
# Personality
You are a billing specialist for Acme Corp. You handle payment issues, refunds, and subscription changes.
# Goal
Resolve billing inquiries by:
1. Verifying customer identity
2. Looking up account and billing history
3. Processing refunds (under $500) or escalating (over $500)
4. Updating subscription settings when requested
# Guardrails
Never access account information without identity verification.
Never process refunds over $500 without supervisor approval.
If the customer's issue is not billing-related, transfer back to the orchestrator agent.

Pour des conseils détaillés sur la création de flux de travail multi-agents, consultez notre documentation sur les flux de travail.

Sélection de modèles pour une fiabilité adaptée aux entreprises

Le choix du bon modèle dépend de vos exigences de performance, en particulier en matière de latence, de précision et de fiabilité des appels d’outils. Les différents modèles présentent des compromis différents entre vitesse, capacité de raisonnement et coût.

Comprendre les compromis

Latence : Les modèles plus petits, avec moins de paramètres, répondent généralement plus vite, ce qui les rend adaptés aux interactions fréquentes et peu complexes.

Précision : Les modèles plus grands offrent de meilleures capacités de raisonnement et gèrent mieux les tâches complexes en plusieurs étapes, mais avec une latence et un coût plus élevés.

Fiabilité des appels d’outils : Tous les modèles ne gèrent pas les appels d’outils ou de fonctions avec la même précision. Certains excellent avec les sorties structurées, tandis que d’autres nécessitent des prompts plus explicites.

Recommandations de modèles par cas d’utilisation

Sur la base de déploiements couvrant des millions d’interactions d’agents, les tendances suivantes se dégagent :

  • GLM 5.2 ou GPT-6 Luna (point de départ recommandé) : Idéal pour les agents d’entreprise généralistes qui doivent équilibrer latence, précision et coût. Offre une latence faible à modérée, de bonnes performances d’appel d’outils et un coût raisonnable par interaction. Convient au support client, à la planification, à la gestion des commandes et au traitement des demandes générales.

  • DeepSeek Flash 4.1 ou Gemini 3.5 Flash-Lite (latence ultra-faible) : Idéal pour les interactions simples et fréquentes où la vitesse est essentielle. Offre la latence la plus faible avec une vaste base de connaissances générales, mais des performances plus limitées sur les appels d’outils complexes. Économique à grande échelle pour l’orientation et le tri initiaux, les FAQ simples, les confirmations de rendez-vous et la collecte de données de base.

  • Claude Sonnet 5.5 (raisonnement complexe) : Idéal pour la résolution de problèmes en plusieurs étapes, le jugement nuancé et l’orchestration complexe d’outils. Offre une précision et une capacité de raisonnement élevées, ainsi qu’une excellente fiabilité des appels d’outils, mais avec une latence et un coût plus élevés. Convient aux tâches où les erreurs sont coûteuses, comme le dépannage technique, le conseil financier, les flux de travail sensibles à la conformité et les décisions complexes de remboursement ou d’escalade.

Les gammes de modèles des fournisseurs évoluent fréquemment. Vérifiez les options et tarifs actuels sur la page Modèles avant de choisir un modèle pour la production.

Évaluez avec vos prompts réels

Les performances d’un modèle varient considérablement selon la structure du prompt et la complexité de la tâche. Avant de choisir un modèle :

  1. Testez deux à trois modèles candidats avec votre prompt système réel
  2. Évaluez-les avec de vraies requêtes utilisateur ou des cas de test synthétiques
  3. Mesurez la latence, la précision et le taux de réussite des appels d’outils
  4. Optimisez le compromis le plus adapté à vos besoins spécifiques

Pour connaître les options détaillées de configuration des modèles, consultez notre documentation sur les modèles.

Itération et tests

La fiabilité en production repose sur une itération continue. Même des prompts bien conçus peuvent échouer en conditions réelles. L’essentiel est de tirer des enseignements de ces échecs et de s’améliorer grâce à des tests rigoureux.

Configurez des critères d’évaluation

Associez des critères d’évaluation concrets à chaque agent pour suivre les résultats au fil du temps et détecter les régressions.

Principales métriques à suivre :

  • Taux d’exécution des tâches : Pourcentage d’intentions utilisateur traitées avec succès
  • Taux d’escalade : Pourcentage de conversations nécessitant une intervention humaine

Pour des conseils détaillés sur la configuration des critères d’évaluation dans ElevenLabs, consultez Évaluation de la réussite.

Analysez les schémas d’échec

Lorsque les agents sont moins performants, identifiez les schémas dans les interactions problématiques :

  • À quels moments l’agent fournit-il des informations incorrectes ? → Renforcez les instructions dans des sections spécifiques
  • Quand ne comprend-il pas l’intention de l’utilisateur ? → Ajoutez des exemples ou simplifiez le langage
  • Quelles entrées utilisateur le font sortir de son rôle ? → Ajoutez des garde-fous pour les cas limites
  • Quels outils échouent le plus souvent ? → Améliorez la gestion des erreurs ou les descriptions des paramètres

Examinez les transcriptions de conversations où la satisfaction utilisateur était faible ou les tâches n’ont pas été achevées.

Apportez des améliorations ciblées

Mettez à jour des sections spécifiques de votre prompt pour résoudre les problèmes identifiés :

  1. Isolez le problème : Identifiez la section du prompt ou la définition d’outil à l’origine des échecs
  2. Testez les modifications sur des exemples précis : Utilisez comme cas de test des conversations qui avaient précédemment échoué
  3. Effectuez une seule modification à la fois : Isolez les améliorations afin de comprendre ce qui fonctionne
  4. Réévaluez avec les mêmes cas de test : Vérifiez que la modification a résolu le problème sans en créer de nouveaux

Évitez de modifier plusieurs éléments du prompt simultanément. Il devient alors impossible d’attribuer les améliorations ou les régressions à des modifications précises.

Configurez la collecte de données

Configurez votre agent pour résumer les données de chaque conversation. Vous pourrez ainsi analyser les schémas d’interaction, identifier les demandes utilisateur récurrentes et améliorer continuellement votre prompt à partir de l’utilisation réelle.

Pour des conseils détaillés sur la configuration de la collecte de données dans ElevenLabs, consultez Collecte de données.

Utilisez la simulation pour les tests de régression

Avant de déployer des modifications de prompt en production, testez-les sur un ensemble de scénarios connus afin de détecter les régressions.

Pour savoir comment tester les agents par programmation, consultez Simuler des conversations.

Considérations pour la production

Les agents d’entreprise nécessitent des protections supplémentaires au-delà de la qualité des prompts. Les déploiements en production doivent prendre en compte la gestion des erreurs, la conformité et une dégradation maîtrisée.

Gérez les erreurs dans toutes les intégrations d’outils

Chaque appel d’outil externe est un point de défaillance potentiel. Veillez à ce que votre prompt inclue une gestion explicite des erreurs pour :

  • Échecs réseau : « Je rencontre des difficultés pour me connecter à notre système. Je vais réessayer. »
  • Données manquantes : « Je ne vois pas ces informations dans notre système. Pouvez-vous vérifier les détails ? »
  • Erreurs de délai d’attente : « Cela prend plus de temps que prévu. Je peux transmettre votre demande à un spécialiste ou réessayer. »
  • Erreurs d’autorisation : « Je n’ai pas accès à ces informations. Je vais vous transférer vers une personne qui pourra vous aider. »

Exemples de prompts

Les exemples suivants montrent comment appliquer les principes présentés dans ce guide à des cas d’utilisation d’entreprise réels. Chaque exemple comporte des annotations indiquant les principes de fiabilité employés.

Exemple 1 : Agent de support technique

Spécialiste du support technique
# Personality
You are a technical support specialist for CloudTech, a B2B SaaS platform.
You are patient, methodical, and focused on resolving issues efficiently.
You speak clearly and adapt technical language based on the user's familiarity.
# Environment
You are assisting customers via phone support.
Customers may be experiencing service disruptions and could be frustrated.
You have access to diagnostic tools and the customer account database.
# Tone
Keep responses clear and concise (2-3 sentences unless troubleshooting requires more detail).
Use a calm, professional tone with brief affirmations ("I understand," "Let me check that").
Adapt technical depth based on customer responses.
Check for understanding after complex steps: "Does that make sense?"
# Goal
Resolve technical issues through structured troubleshooting:
1. Verify customer identity using email and account ID
2. Identify affected service and severity level
3. Run diagnostics using `runSystemDiagnostic` tool
4. Provide step-by-step resolution or escalate if unresolved after 2 attempts
This step is important: Always run diagnostics before suggesting solutions.
# Guardrails
Never access customer accounts without identity verification. This step is important.
Never guess at solutions—always base recommendations on diagnostic results.
If an issue persists after 2 troubleshooting attempts, escalate to engineering team.
Acknowledge when you don't know the answer instead of speculating.
# Tools
## `verifyCustomerIdentity`
**When to use:** At the start of every conversation before accessing account data
**Parameters:**
- `email` (required): Customer email in standard written format (e.g., "user@company.com"). Convert from spoken format: "at" → "@", "dot" → ".", remove spaces between words.
- `account_id` (optional): Account ID if customer provides it
**Error handling:**
If verification fails, ask customer to confirm email spelling and try again.
## `runSystemDiagnostic`
**When to use:** After verifying identity and understanding the reported issue
**Parameters:**
- `account_id` (required): From `verifyCustomerIdentity` response
- `service_name` (required): Name of affected service (e.g., "api", "dashboard", "storage")
**Usage:**
1. Confirm which service is affected
2. Run diagnostic with account ID and service name
3. Review results before providing solution
**Error handling:**
If diagnostic fails, acknowledge the issue: "I'm having trouble running that diagnostic. Let me escalate to our engineering team."
# Error handling
If any tool call fails:
1. Acknowledge: "I'm having trouble accessing that information right now."
2. Do not guess or make up information
3. Offer to retry once, then escalate if failure persists

Principes illustrés :

  • ✓ Séparation nette des sections (# Personality, # Goal, # Tools, etc.)
  • ✓ Une action par ligne, voir les étapes numérotées de # Goal
  • ✓ Instructions concises, avec une section sur le ton brève et claire
  • ✓ Étapes critiques mises en évidence (« This step is important »)
  • ✓ Conversion de format dans les descriptions des paramètres, notamment la normalisation des emails
  • ✓ Section dédiée aux garde-fous
  • ✓ Descriptions d’outils précises avec des indications sur le moment et la manière de les utiliser, ainsi que sur les erreurs
  • ✓ Instructions explicites de gestion des erreurs

Exemple 2 : Agent de service client chargé des remboursements

Spécialiste du traitement des remboursements
# Personality
You are a refund specialist for RetailCo.
You are empathetic, solution-oriented, and efficient.
You balance customer satisfaction with company policy compliance.
# Goal
Process refund requests through this workflow:
1. Verify customer identity using order number and email
2. Look up order details with `getOrderDetails` tool
3. Confirm refund eligibility (within 30 days, not digital download, not already refunded)
4. For refunds under $100: Process immediately with `processRefund` tool
5. For refunds $100-$500: Apply secondary verification, then process
6. For refunds over $500: Escalate to supervisor with case summary
This step is important: Never process refunds without verifying eligibility first.
# Guardrails
Never process refunds outside the 30-day return window without supervisor approval.
Never process refunds over $500 without supervisor approval. This step is important.
Never access order information without verifying customer identity.
If a customer becomes aggressive, remain calm and offer supervisor escalation.
# Tools
## `verifyIdentity`
**When to use:** At the start of every conversation
**Parameters:**
- `order_id` (required): Order ID in uppercase alphanumeric format (e.g., "ORD123456"). Convert from spoken format: spell out letters and spoken digits to written form, no spaces.
- `email` (required): Customer email in standard written format (e.g., "john.smith@retailco.com"). Convert from spoken format: "at" → "@", "dot" → ".", remove spaces between words.
## `getOrderDetails`
**When to use:** After identity verification
**Returns:** Order date, items, total amount, refund eligibility status
**Error handling:**
If order not found, ask customer to verify order number and try again.
## `processRefund`
**When to use:** Only after confirming eligibility
**Required checks before calling:**
- Identity verified
- Order is within 30 days
- Order is eligible (not digital, not already refunded)
- Refund amount is under $500
**Parameters:**
- `order_id` (required): From previous verification
- `reason_code` (required): One of "defective", "wrong_item", "late_delivery", "changed_mind"
**Usage:**
1. Confirm refund details with customer: "I'll process a $[amount] refund to your original payment method. It will appear in 3-5 business days. Does that work for you?"
2. Wait for customer confirmation
3. Call this tool
**Error handling:**
If refund processing fails, apologize and escalate: "I'm unable to process that refund right now. Let me escalate to a supervisor who can help."

Principes illustrés :

  • ✓ Périmètre d’agent spécialisé, uniquement les remboursements et non le support général
  • ✓ Étapes de flux de travail claires dans la section # Goal
  • ✓ Accent répété sur les règles critiques, notamment les limites de remboursement et la vérification
  • ✓ Utilisation détaillée des outils avec « quand utiliser » et « vérifications requises »
  • ✓ Conversion de format dans les descriptions des paramètres, notamment les identifiants de commande et les emails
  • ✓ Gestion explicite des erreurs pour chaque outil
  • ✓ Critères d’escalade clairement définis

Bonnes pratiques de mise en forme

La mise en forme de votre prompt influence l’efficacité avec laquelle le modèle de langage l’interprète :

  • Utilisez des titres Markdown : Structurez les sections avec # pour les sections principales et ## pour les sous-sections
  • Privilégiez les listes à puces : Décomposez les instructions en points faciles à assimiler
  • Utilisez les espaces : Séparez les sections et les groupes d’instructions par des lignes vides
  • Gardez les titres en casse de phrase : # Goal et non # GOAL
  • Soyez cohérent : Utilisez le même modèle de mise en forme dans l’ensemble du prompt

Questions fréquentes

Créez des modèles de prompt partagés pour les sections courantes, comme la normalisation des personnages, la gestion des erreurs et les garde-fous. Stockez-les dans un dépôt central et référencez-les dans vos agents spécialisés. Utilisez le modèle d’orchestrateur afin de garantir une logique de routage et des procédures de transfert cohérentes.

Incluez au minimum : (1) la définition de la personnalité ou du rôle, (2) l’objectif principal, (3) les garde-fous essentiels et (4) les descriptions des outils s’ils sont utilisés. Même les agents simples bénéficient d’une structure de sections explicite et d’instructions de gestion des erreurs.

Lorsqu’un outil est déprécié, ajoutez d’abord un nouvel outil, puis mettez à jour le prompt pour privilégier le nouvel outil tout en conservant l’ancien comme solution de secours. Surveillez l’utilisation, puis supprimez l’ancien outil lorsque son utilisation tombe à zéro. Incluez toujours une gestion des erreurs afin que les agents puissent se rétablir si un outil déprécié est appelé.

En règle générale, les prompts structurés selon les principes de ce guide fonctionnent avec tous les modèles. Cependant, un ajustement propre à chaque modèle peut améliorer les performances, notamment pour le format d’appel d’outils et les étapes de raisonnement. Testez votre prompt avec plusieurs modèles et ajustez-le si nécessaire.

Il n’existe pas de limite universelle, mais les prompts de plus de 2 000 jetons augmentent la latence et le coût. Privilégiez la concision : chaque ligne doit avoir un objectif clair. Si votre prompt dépasse 2 000 jetons, envisagez de le diviser entre plusieurs agents spécialisés ou d’extraire les documents de référence dans une base de connaissances.

Définissez clairement les traits de personnalité, les objectifs et les garde-fous fondamentaux, tout en laissant une certaine flexibilité dans le ton et le niveau de détail selon le style de communication de l’utilisateur. Utilisez des instructions conditionnelles : « Si l’utilisateur est frustré, reconnaissez ses préoccupations avant de poursuivre. »

Oui. Les prompts système peuvent être modifiés à tout moment pour ajuster le comportement. Cela est particulièrement utile pour résoudre les problèmes émergents ou affiner les capacités à mesure que vous tirez des enseignements des interactions avec les utilisateurs. Testez toujours les changements dans un environnement de préproduction avant de les déployer en production.

Incluez des instructions explicites de gestion des erreurs pour chaque outil. Insistez sur le fait de « ne jamais deviner ni inventer d’informations » dans la section des garde-fous. Répétez cette instruction dans les sections de gestion des erreurs propres aux outils. Testez les scénarios de défaillance des outils durant le développement afin de vous assurer que les agents suivent les instructions de rétablissement.

Prochaines étapes

Ce guide pose les bases d’un comportement fiable des agents grâce à l’ingénierie des prompts, à la configuration des outils et aux modèles architecturaux. Pour créer des systèmes prêts pour la production, poursuivez avec :

  • Workflows: Concevez l’orchestration multi-agents et les transferts vers des spécialistes
  • Évaluation de la réussite: Configurez les métriques et les critères d’évaluation
  • Collecte de données: Recueillez des informations structurées à partir des conversations
  • Tests: Mettez en œuvre des tests de régression et des simulations
  • Garde-fous: Configurez la modération de contenu pour des réponses d’agent sûres
  • Confidentialité: Garantissez la conformité et la protection des données
  • Notre agent de documentation: Consultez une étude de cas complète de ces principes en action

Pour bénéficier d’une assistance au déploiement en entreprise, contactez notre équipe.