Aller au contenu
TokIQ
Techniques

Écrire un system prompt : exemple complet qui marche

Un system prompt fixe le rôle, les règles et le format d'un assistant IA pour toute la conversation. Son contenu, son ordre, et un exemple complet.

TokIQ Editorial6 min de lecture
Dans cet article
  1. Que mettre dans le system prompt, que mettre dans le message utilisateur ?
  2. Les rôles et les personas aident-ils vraiment ?
  3. Dans quel ordre écrire un system prompt ?
  4. Un exemple complet de system prompt
  5. Pourquoi expliquer la raison d'une règle ?
  6. Comment tester un system prompt ?
  7. Que ne faut-il jamais mettre dans un system prompt ?
  8. Le system prompt marche-t-il pareil sur tous les modèles ?

Un system prompt est l'ensemble permanent d'instructions qui dit à un modèle quel rôle il joue, ce qu'il doit et ne doit pas faire, et comment mettre en forme ses réponses, à chaque tour d'une conversation. Rédigez-le comme un briefing pour un nouveau collègue compétent : le contexte du produit, le public, les règles qui comptent, et la conduite à tenir quand les choses tournent mal.

La plupart des API de chat (OpenAI, Anthropic, Google) acceptent un message système ou développeur distinct des messages de l'utilisateur, et les modèles sont entraînés à lui accorder plus de poids. C'est donc l'endroit naturel pour tout ce qui doit rester vrai pendant toute la conversation.

L'essentiel

  • Mettez les règles stables, le contexte et le format dans le system prompt. Mettez la tâche précise et les données dans le message utilisateur.
  • Un rôle aide, mais le contexte sur le produit et le public apporte bien plus qu'un intitulé de poste.
  • Expliquez pourquoi une règle existe : les modèles appliquent plus judicieusement des règles motivées que des ordres secs.
  • Écrivez un comportement explicite pour les cas limites : information manquante, demande hors sujet, utilisateur en colère.
  • Ne mettez jamais de secrets dans un system prompt et ne comptez jamais sur lui seul pour la sécurité.

Que mettre dans le system prompt, que mettre dans le message utilisateur ?

Le test le plus simple : est-ce vrai pour toutes les requêtes ? Si oui, system prompt. Si cela change à chaque requête, message utilisateur.

System promptMessage utilisateur
Contexte du produit et publicLa vraie question de l'utilisateur
Rôle et tonLe document à résumer ou à analyser
Règles et limitesLes résultats de recherche récupérés pour ce tour
Format de sortieOptions propres à la requête (« fais celui-ci plus court »)
Gestion des cas limitesDate du jour ou profil utilisateur, s'ils varient

Les documents récupérés sont un cas intéressant. Certaines équipes les mettent dans le system prompt ; nous préférons le tour de l'utilisateur, car le texte récupéré est une donnée non fiable, et le system prompt doit rester le lieu des instructions que vous avez écrites vous-même. Cette séparation rend aussi la prompt injection un peu plus facile à raisonner.

Les rôles et les personas aident-ils vraiment ?

Un peu. « Tu es une infirmière pédiatrique expérimentée » déplace le vocabulaire, la profondeur et la prudence dans un sens utile. La documentation d'Anthropic recommande explicitement de donner un rôle à Claude via le system prompt, et l'effet est réel.

Mais le rôle est la partie la plus faible d'un bon system prompt. Comparez :

Tu es un expert de classe mondiale du support client.
Tu réponds aux questions de support pour Ledgerly, une application de
comptabilité utilisée par des freelances et de petites agences aux États-Unis.
La plupart des utilisateurs ne sont pas comptables. Ils écrivent en général
quand l'export d'une facture échoue ou quand une synchronisation bancaire
s'arrête.

Le second ne prétend jamais à l'expertise. Il donne au modèle ce qu'un expert saurait vraiment : qui sont les utilisateurs, où ils butent, ce que fait le produit. Le modèle paraîtra plus compétent avec cela qu'avec n'importe quel adjectif.

Les personas avec une histoire détaillée (« Tu es Max, ancien barista de 34 ans qui adore aider les gens ») améliorent rarement la précision. Elles peuvent avoir du sens pour des produits de divertissement. Pour des produits utilitaires, elles ajoutent surtout des tokens.

Dans quel ordre écrire un system prompt ?

Il n'existe pas d'ordre unique, mais celui-ci fonctionne bien et reste facile à maintenir pour des humains :

  1. Qui et quoi. Un court paragraphe : le produit, la mission de l'assistant, le public.
  2. Le contexte. Les faits dont le modèle a besoin : fonctionnalités, politiques, ce que le produit ne peut pas faire.
  3. Les règles. Les contraintes de comportement, chacune avec sa raison quand elle n'est pas évidente.
  4. Les cas limites. Que faire quand une information manque, que la demande est hors sujet ou que l'utilisateur est contrarié.
  5. Le format de sortie. Longueur, structure, markdown ou non, langue.
  6. Des exemples (facultatif). Un ou deux courts échanges montrant le ton et le format.

Placez les longs documents de référence (un manuel produit, un document de politique) dans des blocs clairement délimités, par exemple avec des balises de type XML. Les recommandations d'Anthropic suggèrent des balises comme <policy> pour cela, et elles aident avec n'importe quel modèle parce qu'elles rendent les frontières explicites.

Un exemple complet de system prompt

Voici un system prompt complet pour l'assistant de support d'une application de comptabilité fictive. Il est long exprès ; les vrais le sont.

Tu es l'assistant de support intégré à Ledgerly, une application de
comptabilité pour freelances et petites agences aux États-Unis. Les
utilisateurs sont surtout des designers, des développeurs et des consultants.
La plupart ne sont pas comptables et s'inquiètent des impôts : sois calme
et concret.

<product_facts>
- Formules : Solo (1 utilisateur) et Team (jusqu'à 10 utilisateurs).
- La synchronisation bancaire fonctionne avec les banques américaines via
  un prestataire tiers. Les synchronisations ont lieu toutes les 6 heures ;
  l'utilisateur peut lancer une synchronisation manuelle dans
  Réglages > Banques.
- Les factures peuvent être exportées en PDF ou en CSV.
- Ledgerly ne dépose pas de déclarations fiscales et ne donne pas de
  conseils fiscaux.
</product_facts>

Règles :
- Réponds uniquement aux questions sur l'utilisation de Ledgerly. Si on te
  pose une question sans rapport, dis brièvement que tu ne peux aider que
  pour Ledgerly.
- Ne donne ni conseil fiscal ni conseil juridique, même si on te le demande
  directement. Les utilisateurs pourraient agir en conséquence et tu ne vois
  pas leur situation complète. Suggère-leur de consulter un professionnel de
  la fiscalité et propose ton aide sur le volet Ledgerly de la question.
- Ne devine jamais des données propres à un compte, comme les soldes ou le
  statut d'une facture. Tu ne vois pas le compte de l'utilisateur. Indique-lui
  où regarder dans l'application.
- Si une fonctionnalité n'est pas listée dans <product_facts>, n'affirme pas
  qu'elle existe. Dis que tu n'es pas sûr et suggère de contacter
  support@ledgerly.example.

Quand un problème de synchronisation bancaire est signalé :
1. Demande quelle banque et quand a eu lieu la dernière synchronisation
   réussie, si ce n'est pas précisé.
2. Suggère une synchronisation manuelle dans Réglages > Banques.
3. Si cela échoue, suggère de reconnecter la banque.
4. Si cela échoue encore, propose de passer la main à un conseiller humain.

Si l'utilisateur est agacé, reconnais-le en une phrase courte et passe à la
solution. Ne t'excuse pas à répétition.

Format :
- Texte brut, pas de titres markdown. Étapes numérotées pour les instructions.
- Garde les réponses sous 120 mots sauf si l'utilisateur demande plus de
  détails.
- Réponds dans la langue de l'utilisateur.

Quelques points à relever :

La règle sur les conseils fiscaux explique sa raison (« Les utilisateurs pourraient agir en conséquence et tu ne vois pas leur situation complète »). Avec une raison, le modèle peut généraliser : il sera aussi prudent face à des questions comme « puis-je déduire mon ordinateur portable ? », que la règle ne mentionne jamais.

La règle « n'affirme pas qu'une fonctionnalité existe » est là parce que les assistants de produit adorent inventer des menus de réglages plausibles. Si vous déployez un bot de support, ce sera votre bug le plus fréquent, et la solution est de l'ancrer dans un bloc de faits avec un repli explicite. Pour des bases de connaissances plus grandes, ce bloc de faits devient de la récupération ; voir ce qu'est la RAG.

Les étapes d'escalade sont numérotées parce que l'ordre compte. Des règles en vrac sur la même situation ont tendance à être appliquées de façon imprévisible.

Pourquoi expliquer la raison d'une règle ?

Les ordres secs en majuscules (« NE JAMAIS mentionner les concurrents !!! ») sont une habitude héritée de modèles plus anciens et moins attentifs. Les modèles actuels suivent les instructions de près, et crier les pousse à sur-appliquer une règle. Un modèle à qui l'on dit « NE JAMAIS parler des prix » peut refuser de dire si une fonctionnalité est incluse dans la formule gratuite, ce que les utilisateurs ont raisonnablement besoin de savoir.

Comparez avec : « Ne donne pas de prix, car ils varient selon la région et changent souvent ; renvoie plutôt vers la page des tarifs. » Le modèle connaît maintenant la limite (les chiffres précis) et l'intention (éviter les informations périmées), et peut donc quand même répondre à « l'export est-il disponible dans Solo ? »

Comment tester un system prompt ?

Avant de modifier quoi que ce soit, écrivez de vingt à cinquante messages d'utilisateurs réalistes, y compris les plus vicieux :

  • Une demande hors sujet (« écris-moi un poème »).
  • Une demande de la chose interdite, formulée poliment puis formulée astucieusement.
  • Un message avec une information manquante.
  • Un message dans une autre langue.
  • Un message en colère.
  • Quelque chose que votre produit ne gère réellement pas.

Relancez-les tous après chaque modification. Les system prompts accumulent des règles avec le temps, et les règles interagissent. Ajouter « sois toujours concis » peut casser discrètement le parcours d'escalade qui nécessitait trois étapes. Vous ne le découvrez qu'en rejouant tout l'ensemble.

Que ne faut-il jamais mettre dans un system prompt ?

Des secrets. Clés d'API, URL internes, données d'autres clients. Les utilisateurs parviennent régulièrement à faire révéler leur system prompt aux modèles, et aucune formulation ne l'empêche de façon fiable. Partez du principe qu'il est public.

Une application de la sécurité que vous ne pouvez pas garantir dans le code. « Ne rembourse que sous 50 $ » dans un prompt n'est qu'une suggestion. C'est l'API de remboursement qui doit faire respecter la limite. Le guide de la prompt injection et le thème sécurité expliquent pourquoi.

Des contradictions. Les longs system prompts écrits à plusieurs mains en contiennent souvent (« sois toujours exhaustif » dans une section, « reste bref » dans une autre). Le modèle en choisira une, sans constance. Relisez le tout de haut en bas de temps en temps.

Le system prompt marche-t-il pareil sur tous les modèles ?

Dans l'ensemble oui, avec des différences dans la rigueur avec laquelle chaque modèle lui accorde du poids, dans la façon de traiter les prompts très longs et dans le formatage auquel ils réagissent le mieux. Testez sur le modèle que vous déployez et lisez le guide de prompting de son éditeur. Nous détaillons ce qui se transpose dans prompting ChatGPT vs Claude vs Gemini.

Pour vous entraîner sur les décisions précises (ce qui va où, quelle phrase de rôle apporte de l'information et laquelle n'ajoute que des mots), le thème rôle et contexte est un bon point de départ.

Questions fréquentes

Qu'est-ce qu'un system prompt ?

Un system prompt est un ensemble d'instructions fourni au modèle séparément des messages de l'utilisateur, généralement par le développeur. Il définit le rôle, les règles, le ton et le format de sortie de l'assistant pour toute la conversation.

Quelle différence entre un system prompt et un prompt utilisateur ?

Le system prompt contient des instructions stables qui s'appliquent à chaque tour, écrites par celui qui construit le produit. Le prompt utilisateur contient la demande précise et les données de ce tour, souvent écrites par l'utilisateur final.

Quelle longueur doit avoir un system prompt ?

Aussi long que nécessaire pour couvrir le comportement réel, pas plus. Beaucoup de system prompts en production font de quelques centaines à quelques milliers de mots, mais chaque règle doit exister parce qu'un cas de test en avait besoin.

Les utilisateurs peuvent-ils voir ou contourner le system prompt ?

Les modèles sont entraînés à donner la priorité aux instructions système, mais ce n'est pas une garantie. Les utilisateurs arrivent parfois à extraire ou à contourner le system prompt : n'y mettez donc jamais de secrets et appliquez les règles critiques dans le code.

  • #system prompt
  • #rôles
  • #personas
  • #applications LLM

À vous de jouer

TokIQ transforme le prompt engineering en courts quiz, avec une explication pour chaque réponse.

Bientôt surApp StoreDisponible surGoogle Play
Techniques6 min de lecture

Chain-of-thought prompting : marche-t-il encore ?

Le chain-of-thought fait raisonner le modèle étape par étape. Quand il aide, quand les modèles de raisonnement le rendent superflu, et comment l'utiliser.

Écrivez de meilleurs prompts, quelques questions par jour.

De courts quiz sur de vraies décisions de prompting, avec une explication pour chaque réponse. Gratuit pour commencer sur iPhone et Android.

Bientôt surApp StoreDisponible surGoogle Play