Guide
Rédiger les consignes d'un assistant IA : modèle commenté
Les sept rubriques des consignes d'un assistant qui répond à partir de vos documents, un modèle à adapter et les erreurs à éviter.
Mis à jour le
Les consignes d'un assistant d'intelligence artificielle (IA) sont le texte qui lui dit qui il est, pour qui il répond, avec quelles sources, sur quel ton et ce qu'il doit faire quand il ne sait pas. On les écrit comme on briefe un nouveau collègue : précis, ordonné, avec la raison de chaque règle.
Le bon état d'esprit
La documentation d'Anthropic, l'éditeur des modèles Claude, conseille de considérer le modèle comme un nouvel employé brillant, mais qui ne connaît ni vos habitudes ni vos façons de faire. Plus vous expliquez précisément ce que vous attendez, meilleur est le résultat. Elle propose un test simple : montrez vos consignes à un collègue qui ne connaît pas la tâche. S'il serait perdu, le modèle le sera aussi.
Autre conseil de la même source : donnez la raison de chaque règle. « N'indiquez jamais de délai de livraison, car ils dépendent du transporteur et changent chaque semaine » marche mieux que « Pas de délai de livraison ».
Les sept rubriques
- Rôle : qui est l'assistant et pour qui il travaille. Une phrase suffit souvent ; Anthropic note qu'un rôle, même en une phrase, oriente le comportement et le ton.
- Public : qui pose les questions (équipe interne, clients, partenaires) et ce qu'ils savent déjà.
- Sources : répondre uniquement à partir des documents fournis, pas de ses connaissances générales. C'est l'une des techniques recommandées par Anthropic pour limiter les réponses inventées.
- Périmètre : les sujets traités et la liste écrite des sujets exclus, reprise de votre tableau de périmètre.
- Quand il ne sait pas : l'autoriser explicitement à dire qu'il ne sait pas, et lui dire vers qui orienter. Anthropic présente cette autorisation comme un moyen de réduire fortement les fausses informations.
- Forme : longueur, tutoiement ou vouvoiement, listes ou phrases, citation du document source.
- Exemples : deux ou trois échanges types. Anthropic recommande des exemples proches de l'usage réel et variés, de trois à cinq pour de bons résultats.
Un modèle à adapter
Remplacez tout ce qui est entre crochets. Le texte entre parenthèses explique la règle à l'assistant : gardez-le.
Rôle
Vous êtes l'assistant interne de [nom de l'entreprise], [activité en une ligne].
Vous aidez [les techniciens / l'équipe d'accueil / nos clients] à trouver
rapidement une information dans nos documents.
Sources
Répondez uniquement à partir des documents fournis. N'utilisez pas vos
connaissances générales (nos règles internes diffèrent souvent des usages
courants). Citez à la fin de chaque réponse le titre du document utilisé.
Périmètre
Vous répondez aux questions sur : [procédures, catalogue, garanties, ...].
Vous ne traitez pas : [devis, réclamations, décisions sur un dossier
individuel, ...]. Pour ces sujets, orientez vers [service, adresse, numéro].
Quand l'information manque
Si les documents ne contiennent pas la réponse, dites-le simplement :
« Je ne trouve pas cette information dans nos documents. » Puis proposez
[contact]. N'essayez pas de deviner (une réponse inventée peut entraîner
une erreur chez un client).
Si la question est ambiguë, posez une question pour préciser.
Forme
Vouvoiement. Réponses courtes : la réponse d'abord, puis le détail utile.
Étapes numérotées pour une procédure.
Exemples
Question : « [question réelle] »
Réponse : « [réponse attendue] (Source : [titre du document]) »
Ce qui ne va pas dans les consignes
- Les informations elles-mêmes. Un tarif ou un horaire écrit dans les consignes sera oublié lors de la prochaine mise à jour. Il a sa place dans un document de la base.
- Les interdits sans raison. Une liste de « JAMAIS » en majuscules ne dit pas à l'assistant comment se comporter dans un cas voisin.
- Des règles qui se contredisent. « Soyez exhaustif » et « répondez en deux phrases » : l'assistant choisira au hasard.
Dire que c'est une IA
La CNIL (Commission nationale de l'informatique et des libertés) rappelle que les personnes doivent être informées qu'elles échangent avec un système d'IA. Prévoyez-le dans le message d'accueil de l'assistant, et précisez dans les consignes qu'il ne doit pas se présenter comme une personne.
Après la rédaction
Les consignes ne sont jamais justes du premier coup. Le guide de la Direction générale des entreprises recommande de prévoir un moyen pour les utilisateurs de signaler une réponse, afin d'améliorer le système au fil du temps. Gardez chaque version des consignes datée, et repassez votre liste de questions de test après chaque modification : une phrase ajoutée pour corriger un cas peut en dérégler un autre.
Questions fréquentes
Faut-il mettre les informations de l'entreprise dans les consignes ?
Non, pas le détail. Les consignes disent comment se comporter ; les informations (tarifs, procédures, horaires) restent dans les documents de la base, là où vous les mettez à jour.
Faut-il écrire les consignes en anglais ?
Rien ne l'impose. Écrivez-les dans la langue de vos utilisateurs, avec le vocabulaire de votre métier, et testez le résultat.
Comment savoir si mes consignes sont claires ?
La documentation d'Anthropic propose un test : faire lire les consignes à un collègue qui ne connaît pas le sujet. S'il hésite sur ce qu'il doit faire, l'assistant hésitera aussi.
Sources
Pages consultées pour écrire cet article :
- https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices
- https://platform.claude.com/docs/en/test-and-evaluate/strengthen-guardrails/reduce-hallucinations
- https://cnil.fr/fr/les-questions-reponses-de-la-cnil-sur-lutilisation-dun-systeme-dia-generative
- https://www.entreprises.gouv.fr/files/files/Publications/2024/Guides/20241127-bro-guide-ragv4-interactif.pdf