# Prompt système et révisions

> Rédigez les instructions permanentes qu'un agent lit avant chaque conversation, conservez chaque version, et revenez en arrière quand un changement dégrade l'agent.

Le **prompt système** est l'instruction permanente qu'un agent lit avant chaque conversation : ce qu'il fait, comment il doit décider, ce qu'il ne doit jamais faire. Chaque version que vous enregistrez est conservée, donc toute modification est réversible.

## Quand l'utiliser

Tournez-vous vers le prompt quand c'est le *comportement* de l'agent qui ne va pas : il fait la mauvaise chose, dans le mauvais format, ou vous demande ce qu'il devrait déjà savoir. Tournez-vous vers un [connecteur](/fr/docs/connect/overview/) ou une [compétence](/fr/docs/capabilities/skills/) quand il lui manque une *capacité*. Le prompt ne peut pas remplacer un accès.

## Le rédiger

<Steps>

1. **Ouvrez la section du prompt dans [Agent Builder](/fr/docs/build/agent-builder/).**

   Vous y voyez le texte actuel et l'historique des révisions précédentes.

2. **Énoncez la mission en un paragraphe.**

   Pour qui l'agent travaille, de quoi il est responsable, et ce qui sort de son périmètre. Un agent qui connaît ses limites pose moins de questions inutiles.

3. **Dites à quoi ressemble un bon résultat.**

   C'est la partie que la plupart des prompts omettent, et celle qui change le plus les résultats. L'agent choisit lui-même ses étapes ; ce qu'il ne peut pas deviner, c'est votre critère pour dire « c'est terminé ».

   *« Résume mes e-mails non lus »* laisse tout au hasard. *« Résume mes e-mails non lus, regroupés par expéditeur ; pour tout message qui me pose une question directe, cite la question mot pour mot afin que je puisse répondre sans l'ouvrir »*, non.

4. **Listez les règles strictes.**

   Ce qui doit toujours ou ne doit jamais arriver : ne jamais écrire à quelqu'un d'extérieur à l'entreprise, toujours citer le document source, ne jamais deviner un chiffre.

5. **Enregistrez-le comme nouvelle révision.**

   Le texte précédent n'est pas écrasé ; il devient une révision à laquelle vous pouvez revenir.

</Steps>

<Screenshot
  name="studio-prompt"
  alt="La section du prompt : un éditeur Markdown contenant les instructions de l'agent, avec un compteur de caractères et, en dessous, la liste des révisions enregistrées."
/>

## Révisions et retour en arrière

Chaque enregistrement crée une révision. L'historique montre ce qu'était le prompt à chaque étape, et vous pouvez restaurer une version antérieure.

C'est ce qui rend l'itération sur le prompt sûre plutôt que hasardeuse. Changez quelque chose, utilisez l'agent pendant une journée, et si le changement l'a dégradé, revenez à la révision qui fonctionnait. Inutile de vous souvenir de ce que disait l'ancien texte.

<Aside type="note" title="Une exécution utilise la révision avec laquelle elle a démarré">
  Restaurer une révision affecte la prochaine exécution de l'agent. Une exécution déjà en cours
  se termine avec le prompt de son démarrage : c'est pourquoi un agent peut sembler ignorer une
  modification que vous venez de faire.
</Aside>

## Que mettre où

| À placer dans | Quand |
| --- | --- |
| **Prompt système** | Cela s'applique à chaque conversation : votre rôle, les règles permanentes, le format de sortie |
| **Un message** | Cela ne concerne que cette tâche |
| **[Caractère](/fr/docs/build/identity/)** | Il s'agit du ton, pas de la mission |
| **[Mémoire](/fr/docs/capabilities/memory/)** | C'est un fait que l'agent doit apprendre une fois et réutiliser : une préférence, un nom, une habitude |
| **Une [compétence](/fr/docs/capabilities/skills/)** | C'est une procédure répétable avec des étapes, pas une instruction permanente |

Un prompt qui a grossi au point de couvrir quatre missions sans rapport est le signe qu'il vous faut un deuxième agent, et non un prompt plus long.

## Limites

- Un prompt ne peut pas accorder d'accès. Si l'agent a besoin de votre agenda, il lui faut une connexion associée : écrire « tu as accès à mon agenda » ne change rien.
- Restaurer une révision remplace l'intégralité du prompt. Il n'y a pas de fusion entre révisions.
- Le prompt est propre à chaque agent. Si deux agents doivent partager des règles permanentes, le texte doit figurer dans les deux.

## Voir aussi

<CardGrid>
  <LinkCard
    title="Tester et itérer"
    href="/fr/docs/build/iterating/"
    description="Comment savoir si une modification du prompt a vraiment aidé."
  />
  <LinkCard
    title="Mémoire"
    href="/fr/docs/capabilities/memory/"
    description="Les informations que l'agent apprend une fois pour toutes au lieu qu'on les lui répète à chaque fois."
  />
  <LinkCard
    title="Compétences"
    href="/fr/docs/capabilities/skills/"
    description="Les procédures répétables qui n'ont pas leur place dans un prompt."
  />
</CardGrid>