# Rédiger — questions-réponses de produit (`rediger/qa-produit`)

**Statut : prévu.** Aucun agent ne fait encore ce travail.

Ce couple n'apparaît dans votre espace que si le site a le module **E-commerce**.

Rédiger un questions-réponses de produit seul — écrire un contenu neuf à partir d'un brief.

> Aujourd'hui, les questions-réponses ne sont pas rédigées : elles sont reprises de la page existante pour le balisage FAQ.

## Ce que reçoit l'agent

### Venant du référentiel

- les **faits** du référentiel (tout ce qui n'est pas charte : FAIT, PRODUIT…)
- la **charte de marque** (DOCTRINE, INTERDIT, ALLEGATION, CADRE_JURIDIQUE)
- le **nom et l'identité de la marque** (lignes `FAIT / marque` : nom, site, baseline)

Le référentiel est la seule source de vérité de l'agent : ce qui n'y figure pas n'est pas affirmé. Voir [Le référentiel](/modules/guide-espace/#le-referentiel) et [Ce que le modèle lit](/modules/guide-espace/#ce-que-le-modele-lit).

### Venant du contexte

- le brief ou la page concernée

### Ce qu'il doit rendre

liste de questions et réponses courtes, fondées sur le référentiel et la fiche

## Interface (dans votre espace)

⚠ Aujourd'hui, l'agent suit **sa consigne interne** : il ne lit pas encore le prompt de votre espace. Une version enregistrée ici sera prise en compte quand l'agent sera branché, sans autre geste de votre part.

1. Connaissance › **Prompts des agents** (administrateurs), ligne `rediger / qa-produit`.
2. Écrivez une version : **préfixe** (rôle, règles), **gabarit** (la demande, avec ses `{{placeholders}}`), **suffixe**, et la liste des placeholders exigés.
3. Une version enregistrée est **inactive** : relisez-la, puis **activez-la**. Une seule version est active à la fois ; les précédentes restent dans l'historique.
4. Le format de sortie ci-dessus est un **contrat** : quand l'agent lit votre prompt, Kortex ajoute toujours ce format à la suite. Vous n'avez pas à le réécrire, et un prompt ne peut pas le casser.

## API (pour les agents et les scripts)

Sur l'espace du site, `https://<site>.kortex.center` :

| Geste | Route | Accès |
|---|---|---|
| Lire le prompt actif | `GET /api/seo/prompts/rediger/qa-produit` | agents (jeton de service) ou administrateur ; `404 prompt_absent` si aucune version active |
| Lister les versions | `GET /api/seo/prompts/rediger/qa-produit/versions` | administrateur ; clé API `lecture` |
| Enregistrer une version (inactive) | `PUT /api/seo/prompts/rediger/qa-produit` | administrateur ; clé API `pilotage` |
| Activer une version | `POST /api/seo/prompts/rediger/qa-produit/versions/:v/activer` | administrateur ; clé API `pilotage` |

Corps d'une version : `{titre, description?, prefix, user_template, postfix, placeholders_requis[], modele?, effort?, commentaire_version?}`. Chaque placeholder déclaré doit apparaître dans le texte (`400 placeholder_absent` sinon).

Voir aussi : [tous les prompts](/modules/prompts/) · [l'API des espaces](/modules/dashboard-api/) · [le guide de l'espace](/modules/guide-espace/).