> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chataigne.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Instructions du commis IA

> Lisez et modifiez les consignes propres au restaurant utilisées dans les conversations clients.

Les instructions du commis IA permettent à un établissement d’ajouter des consignes propres au restaurant pour les conversations clients. Utilisez-les pour des informations ou règles stables que le commis IA doit prendre en compte.

| Action   | Endpoint                                            | Permission |
| -------- | --------------------------------------------------- | ---------- |
| Lire     | `GET /v1/locations/{location_id}/ai_instructions`   | `ai.read`  |
| Modifier | `PATCH /v1/locations/{location_id}/ai_instructions` | `ai.write` |

## Lire les instructions actuelles

```bash theme={null}
curl https://server.chataigne.ai/v1/locations/loc_r8v4n2c6tz/ai_instructions \
  -H "x-api-key: $CHATAIGNE_API_KEY"
```

## Modifier les instructions

<Warning>
  `chatbot_instructions` remplace entièrement les instructions actuellement enregistrées. La
  nouvelle valeur n’est pas fusionnée avec l’ancienne. Lisez d’abord les instructions actuelles et
  envoyez la version complète que le commis IA doit utiliser.
</Warning>

```bash theme={null}
curl https://server.chataigne.ai/v1/locations/loc_r8v4n2c6tz/ai_instructions \
  -X PATCH \
  -H "x-api-key: $CHATAIGNE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chatbot_instructions": "Indiquer aux clients que la terrasse n’est pas réservable. Pour les groupes de huit personnes ou plus, leur demander d’appeler le restaurant."
  }'
```

`PATCH` conserve les champs omis. Envoyez `null` pour effacer `chatbot_instructions`. Une nouvelle valeur doit être une chaîne non vide de 10 000 caractères maximum.

La réponse contient les nouvelles instructions ainsi que celles qui étaient actives juste avant la modification :

```json theme={null}
{
  "object": "ai_instructions",
  "location_id": "loc_r8v4n2c6tz",
  "previous_chatbot_instructions": "Toujours présenter le plat du jour en premier.",
  "chatbot_instructions": "Indiquer aux clients que la terrasse n’est pas réservable. Pour les groupes de huit personnes ou plus, leur demander d’appeler le restaurant."
}
```

Conservez cette réponse si votre intégration doit pouvoir annuler la modification. Pour revenir en arrière, envoyez la valeur de `previous_chatbot_instructions` dans un nouveau `PATCH`.