# Définir le prompt

> Remplace le prompt du réceptionniste : ce qu'il cherche à obtenir, qui il est et comment il mène l'appel. Un prompt n'est valide qu'entier, et chaque…

`PUT /v2/api/numbers/{number}/agent/prompt`

<Note>
**Scope requis :** `AGENTS_WRITE`
</Note>

## Comportement

Remplace le prompt du réceptionniste : ce qu'il cherche à obtenir, qui il est et comment il mène l'appel. Un prompt n'est valide qu'entier, et chaque écriture régénère ce avec quoi le réceptionniste répond. Lisez donc les sections actuelles avec [Lire la configuration](/fr/docs/agent/get-agent) et renvoyez-les toutes, y compris celles que vous ne modifiez pas.

La réponse renvoie le prompt avec un `title` dérivé côté serveur de chaque clé `section`.

## Sections

| Section | Obligatoire | Corps |
|---|---|---|
| `objective` | Oui | `content` |
| `personality` | Oui | `content` |
| `behaviors` | Oui | `content` |
| `prohibited` | Non | `content` |
| `required_fields` | Non | `fields` |
| `objective_completion` | Non | `content` |

`required_fields` est la seule section qui porte `fields` au lieu de `content`, avec une entrée par information que le réceptionniste doit recueillir. Toutes les autres sections portent un `content` non vide et pas de `fields`. Chaque section apparaît au maximum une fois, et `content` accepte jusqu'à 3000 caractères.

Les trois sections obligatoires sont le minimum imposé par l'API, pas le prompt dont une activité a besoin. Un réceptionniste sans section `prohibited` n'a jamais appris ce qu'il ne doit pas dire.

## Ce qui se place ailleurs

Les informations factuelles sur l'activité vont dans `knowledge` sur [Modifier la configuration](/fr/docs/agent/update-agent), pas ici. Tarifs, horaires, règles et questions fréquentes changent souvent, et le réceptionniste va les y chercher au lieu de les réciter depuis le prompt.

Le message d'accueil et le message de fin ont eux aussi leurs propres champs. Allo gère déjà l'accueil, la clôture, le changement de langue, la confirmation des coordonnées, le transfert et la mécanique de réservation : les répéter dans le prompt dégrade l'appel au lieu de l'améliorer.

## Erreurs

- `400 PROMPT_SECTIONS_REQUIRED` : `sections` est absent ou vide. Il remplace tout le prompt et doit donc porter chaque section à conserver.
- `400 INVALID_AGENT_PROMPT_SECTION` : une clé de section inconnue. Les valeurs acceptées sont listées dans le message.
- `400 DUPLICATE_AGENT_PROMPT_SECTION` : une section apparaît plusieurs fois.
- `400 INVALID_AGENT_PROMPT_SECTION_BODY` : une section porte le mauvais corps, par exemple `fields` sur `objective`.
- `400 MISSING_AGENT_PROMPT_SECTION` : `objective`, `personality` ou `behaviors` est absent ou vide.
- `400 AGENT_PROMPT_SECTION_TOO_LONG` : le `content` d'une section dépasse 3000 caractères.
- `400 AGENT_PROMPT_TOO_LONG` : le prompt généré depuis toutes les sections dépasse 25000 caractères.
- `404 PHONE_NUMBER_NOT_FOUND` : ce numéro n'est pas un numéro auquel vous avez accès.
