Open in
Guide de style des prompts
Comment rédiger et modifier le prompt d
Ce guide s’adresse à toute personne qui écrit ou modifie le prompt d’un agent vocal : une personne dans le builder, Copilot ou un agent de développement utilisant l’API. L’outil de révision de prompt l’utilise comme grille d’évaluation et cite ses identifiants de consignes (P1, W2, etc.).
Un appelant entend l’agent une seule fois, à vitesse de parole, et ne peut pas revenir en arrière. L’agent lit le prompt à chaque tour et en reprend fidèlement la formulation. Ces deux éléments déterminent tout ce qui suit.
Structure
P1. Rédigez-le comme une personne présenterait le poste à une nouvelle réceptionniste. Une courte introduction indique qui est l’agent et pour qui il travaille. L’appel suit ensuite son déroulement : comment il commence, ce qu’il faut découvrir, ce qu’il faut confirmer, comment il se termine. Chaque règle se trouve dans la partie de l’appel où elle s’applique. Le lecteur doit pouvoir se demander, pour chaque paragraphe : « une personne qui gère cette entreprise aurait-elle pu écrire ceci ? » Ce qu’il faut découvrir couvre ce dont l’entreprise a besoin pour traiter la demande, et pas seulement l’identité de l’appelant et la manière de le joindre.
P2. Des titres simples, suivis de prose. Des titres comme « Qui vous êtes », « L’appel », « Informations » et « Passer le relais » sont utiles. Une structure de type machine ne l’est pas : manuels de règles numérotées, titres en camelCase ou semblables à du code, longues listes de règles avec des tirets, référence des outils au début et renvois comme « voir la section 4 ci-dessous ». Les listes conviennent pour les données que l’agent consulte (horaires, prix, adresse).
P3. Manière de parler, une seule fois et brièvement. La façon dont l’agent s’exprime pendant tout l’appel (interventions courtes à la première personne, ton chaleureux, mots simples ; voir S2) tient dans un court paragraphe près du début. Tout ce qui est propre à une étape se trouve dans cette étape.
P4. Séparez les informations du comportement. Les horaires, prix, lieux, politiques et autres informations figurent dans une partie dédiée du prompt ou dans une base de connaissances, et non dispersés dans le déroulement de l’appel. Les longs catalogues et FAQ appartiennent à une base de connaissances. L’agent ne peut énoncer que les informations qui lui ont été fournies.
Contenu
C1. Des principes et des faits, pas des scripts. Décrivez ce que l'agent cherche à accomplir et ce qu'il doit savoir. Omettez les branches « si l'appelant dit X, dites Y », les réponses scénarisées aux questions anticipées et les répliques toutes faites. La salutation d'ouverture configurée est le seul élément rédigé à l'avance.
C2. Une correction énonce le principe général. Lorsqu'une modification du prompt répond à une défaillance observée, elle ajoute un principe général ou un fait manquant, et non un correctif pour ce seul cas. Les détails de l'appel défaillant (ses noms, ses numéros, ses mots exacts) ne doivent pas figurer dans le prompt.
C3. Préférez retirer plutôt qu'ajouter. Lorsqu'une défaillance provient d'une règle existante trop spécifique, trop large ou mal placée, modifiez ou supprimez cette règle plutôt que d'ajouter une règle contraire à côté.
C4. Les paramètres décident de certaines choses, pas le prompt. Il s'agit de paramètres de l'agent, et le texte du prompt à leur sujet est ignoré ou entre en conflit avec eux : ce qui est dit pendant l'exécution d'un outil (phrase de démarrage de l'outil, phrases de remplissage), les relances en cas de silence et l'action finale après un silence, le rythme d'une lecture de confirmation, le style de changement de langue, l'avis d'enregistrement, et si l'agent ou l'appelant parle en premier. Orientez le prompt vers le résultat (« confirmez l'adresse e-mail avant de l'enregistrer »), puis définissez le paramètre. La salutation d'ouverture elle-même est écrite dans le prompt.
C5. Les exemples sont des phrases que l'agent dira. L'agent reprend la formulation des exemples presque mot pour mot, donc chaque exemple est une phrase complète et naturelle à l'oral, et quelques exemples variés valent mieux qu'un seul. Présentez-les comme des exemples (« Par exemple, vous pourriez dire... »), et non comme la phrase obligatoire. Des étiquettes tronquées comme « Toujours correct ? » semblent abruptes une fois prononcées.
C6. Aucun exemple issu des appels de nos propres clients. Les exemples décrivent le type de situation en termes généraux ou utilisent une entreprise fictive.
C7. Le prompt s’adresse aux appelants, pas à la conception. Les appelants entendent tout ce que dit le prompt une fois qu’il est en production ; il exclut donc les notes sur la conception, les tests ou le statut de conformité (« cette version est destinée aux tests », « TEST » dans le nom d’une réservation, « jusqu’à la signature des accords »). Il exclut également les avertissements, les réserves de responsabilité et les récapitulatifs de fin que l’entreprise n’a pas demandés, par exemple ce que l’acceptation d’un forfait n’établit pas ou un résumé de ce qui reste à confirmer. L’agent répond à ce que l’appelant a demandé, puis s’arrête ; l’entreprise ajoute une réserve lorsqu’elle le souhaite. Une information manquante ou une limite du système s’écrit sous la forme de ce que fait l’agent (« pour les tarifs, proposez un rappel du bureau »), et non comme une note indiquant qu’elle n’a pas été fournie ou expliquant comment les demandes sont enregistrées ; rien ne doit rester de la rédaction, comme un nom ou un titre parasite.
Formulation
W1. Indiquez clairement quoi faire, une seule fois. Formulez le comportement attendu comme une instruction en termes simples : « Relisez le numéro de commande chiffre par chiffre afin que l’appelant puisse le corriger. » Dites-le une seule fois, là où cela s’applique.
W2. Pas d'emphase. Aucune étiquette « IMPORTANT », « NOTE » ou « CRITIQUE », aucun mot en majuscules pour insister, aucun point d'exclamation, aucune paire « Mauvais : » et « Bon : », aucune section expliquant ce qu'il ne faut pas faire. Les mots comme « jamais », « toujours » et « doit », employés pour insister, entrent également dans cette catégorie. L'emphase attire l'attention du modèle sur une règle et le rend moins efficace pour le reste de l'appel. Lorsque l'agent ignore une instruction, rendez l'instruction plus claire, plus spécifique ou mieux placée, et non plus insistante.
W3. Corrigez la structure qui provoque un comportement. Avant d'ajouter une règle contre un comportement de l'agent, identifiez la formulation ou la structure qui l'y conduit : un modèle que le modèle remplit littéralement, un terme qui a deux sens, une branche if-else qu'un modèle rapide interprète de manière souple. Modifiez cela.
W4. Le spécifique vaut mieux que le général. « Proposez les deux premiers créneaux disponibles, puis demandez lequel convient » vaut mieux que « aider à la planification ». Les instructions vagues produisent un comportement vague.
W5. Effectuez la recherche avant de poser des questions à ce sujet. Lorsque l’appelant mentionne un élément qu’un outil de recherche en lecture seule peut vérifier (un produit, une commande, une réservation existante), l’agent effectue la recherche avec les mots fournis par l’appelant, puis ne pose une question de suivi que si le résultat l’exige. « Vérifiez le stock du produit mentionné par l’appelant et indiquez-lui ce que vous trouvez » est préférable à « précisez la marque, la taille et la variante, puis vérifiez le stock » : un agent à qui l’on demande d’abord de préciser continue de poser des questions et la recherche ne s’exécute jamais. Cela concerne uniquement les recherches. Avant d’utiliser un outil qui réserve, modifie, annule ou enregistre quelque chose, l’agent confirme toujours les détails avec l’appelant.
Parole
S1. Une question par prise de parole, et la question termine la prise de parole. Tout ce qui est dit après une question couvre la réponse de l'appelant. Placez toute explication avant la question.
S2. Tours courts, en phrases complètes à l’oral. Une ou deux phrases courtes, sauf si l’appelant demande des précisions. Les options énoncées se limitent à quelques-unes. Court signifie peu de mots, pas des phrases tronquées : l’agent parle comme une bonne réceptionniste au téléphone, avec des phrases complètes à la première personne, par exemple « Je vais vous le réserver maintenant » ou « Je vous ai inscrit pour lundi à dix heures. » Des fragments de type note (« Je vous le réserve. », « C’est fait. », « Noté. ») paraissent abrupts une fois prononcés, et les formulations d’e-mail (« Veuillez noter que… », « Merci de… », « J’espère que cela vous aide ») donnent l’impression d’être lues plutôt que dites. Le paragraphe du prompt sur la manière de parler le demande clairement, par exemple : « Limitez chaque tour à une ou deux phrases et parlez à la première personne, comme le ferait une réceptionniste au téléphone. »
S3. Écrivez pour l'oreille. Dans ce que dit l'agent, évitez le markdown, les symboles et les notations que la voix lira de façon étrange (barres obliques, esperluettes, « @ », « .com », séparateurs de milliers, numéros de téléphone sans espaces). Les faits et valeurs que l'agent transmet à un outil, comme une adresse e-mail ou un numéro de compte, conservent leur forme écrite exacte ; lorsqu'une information doit aussi être dite à voix haute, ajoutez à côté la façon de la prononcer plutôt que de la réécrire. Indiquez comment prononcer les noms inhabituels ou les acronymes, et écoutez les nouveaux termes avec la voix de l'agent avant de les conserver.
S4. Confirmez ce qu’il serait coûteux de mal comprendre. Les numéros, e-mails, adresses et codes sont relus dans la forme où ils ont été fournis, une fois, dans la réponse qui suit immédiatement leur communication par l’appelant et avant la question suivante, avec une valeur par relecture. Par défaut, un nom est retenu tel qu’il a été dit, sans relecture, et l’agent ne demande son orthographe que s’il est inhabituel ou peu clair, et ne la demande qu’une fois. Lorsque l’entreprise a besoin que le nom soit exact, par exemple pour faire correspondre ses dossiers ou pour une réservation à ce nom, le prompt le précise et l’agent épelle le nom en retour. Une relecture donne à l’appelant la possibilité de corriger une valeur, ce n’est pas un contrôle obligatoire : un appelant qui répond avec le détail suivant ou continue sans la corriger l’a acceptée, et une valeur acceptée n’est pas redemandée. Un numéro de téléphone que l’entreprise rappellera ou auquel elle enverra un SMS est l’exception : sa relecture termine le tour et attend la réponse de l’appelant. Un prompt qui demande une lecture chiffre par chiffre ne nomme que les valeurs lues de cette manière (un numéro de téléphone, un code) ; un numéro de rue, un prix, une heure ou une date se disent comme les gens les disent. Le prompt indique ce qu’il faut confirmer ; la plateforme rythme la relecture.
Itération
I1. Testez avant de conserver une modification. Rejouez le jeu de développement de l'agent sur le brouillon modifié et comparez-le à la version actuelle : quels exemples une modification a corrigés, lesquels elle a dégradés. Lisez les réponses comme un appelant les entendrait. Tout ce qu'un appelant remarquerait est un problème, pas un détail.
I2. Le jeu réservé est vérifié une seule fois. Ajustez uniquement sur le jeu de développement. Exécutez le jeu de test lorsqu'une modification est prête, et rapportez son résultat tel quel. Une modification effectuée après avoir vu les résultats de test nécessite de nouveaux exemples de test.
I3. Refactorisez lorsque les correctifs s'accumulent. Un prompt qui a accumulé de nombreuses petites corrections s'éloigne de P1 : les règles se répètent, entrent en conflit ou se trouvent loin de l'étape qu'elles régissent. Réécrivez-le alors selon cette structure, en conservant chaque comportement qu'il demande. Indiquez chaque comportement comme conservé, fusionné, reformulé ou supprimé, et ne supprimez rien sans le signaler. Rejouez le jeu de développement avant et après ; un refactoring doit modifier la formulation, pas le comportement.
I4. Vérifiez la configuration avant le prompt. Certains échecs ne viennent pas du prompt : mal entendre des lettres épelées relève d’une limite de reconnaissance (essayez l’écoute Plus), une réponse lente peut être due au niveau d’intelligence ou de reconnaissance, ou au réglage de détection de fin de parole. Écartez les problèmes de configuration avant de réécrire le texte.