# Réécrire — fiche produit (`regenerate/fiche-produit`)

**Statut : branché.** Un agent fait ce travail aujourd'hui (réécriture du superviseur (même agent que l'article, nature « produit »)).

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

Le rédacteur réécrit le texte d'une fiche produit sur consigne de l'équipe.

> Une fiche construite avec un constructeur de pages (Divi) est refusée : le réécrire casserait sa mise en page.

## 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

- la consigne de l'équipe
- le texte actuel de la fiche
- les messages de l'équipe

### Ce qu'il doit rendre

JSON `{corps, bloquantes, entete?}`.

## Interface (dans votre espace)

L'agent lit le **prompt actif de votre espace** (relu toutes les 5 minutes au plus). Votre prompt remplace sa consigne **éditoriale** — le ton, l'angle, ce qu'il faut mettre en avant.

Kortex garde **toujours**, à la suite de votre prompt : la demande de l'équipe citée mot pour mot, ses messages et contestations, les règles d'écriture, le format de sortie, le référentiel et la charte. Un prompt ne peut ni casser le format attendu, ni lever une garde.

Sans version active, ou si un placeholder n'a pas de valeur, l'agent suit sa consigne interne et le note dans son journal.

1. Connaissance › **Prompts des agents** (administrateurs), ligne `regenerate / fiche-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/regenerate/fiche-produit` | agents (jeton de service) ou administrateur ; `404 prompt_absent` si aucune version active |
| Lister les versions | `GET /api/seo/prompts/regenerate/fiche-produit/versions` | administrateur ; clé API `lecture` |
| Enregistrer une version (inactive) | `PUT /api/seo/prompts/regenerate/fiche-produit` | administrateur ; clé API `pilotage` |
| Activer une version | `POST /api/seo/prompts/regenerate/fiche-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).

### Placeholders disponibles

| Placeholder | Ce qu'il contient |
|---|---|
| `{{consigne_humaine}}` | la consigne de l'équipe, citée mot pour mot |
| `{{version_actuelle}}` | le corps de la version à réécrire |
| `{{referentiel_faits}}` | les faits du référentiel, tels que le modèle les lit |
| `{{charte_marque}}` | la charte de marque |
| `{{marque}}` | le nom de la marque (lignes FAIT / marque) |
| `{{messages_humains}}` | les messages de l'équipe envoyés depuis la dernière version |

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