Prompts

L'écran Prompts permet de stocker des modèles de prompts versionnés avec des variables, de lire leurs versions et de les rendre avec des valeurs. Chemin du portail : /data/prompts. Les développeurs et les administrateurs du tenant l'utilisent pour partager des prompts entre agents et applications.

Ce que montre l'écran

La table Prompts liste les prompts du tenant par nom : Nom, Dernière version, Description, Mis à jour.

Le formulaire Nouveau prompt contient Nom (obligatoire), Modèle (obligatoire, exemple Summarize {{document}} in {{language}}.), Variables (séparées par des virgules, par exemple document, language), Description et Modèle suggéré. Chaque variable est envoyée comme obligatoire.

Le menu de ligne propose Versions et Rendu ; leurs réponses s'ouvrent dans un panneau latéral en JSON.

Actions

Bouton ou action	Ce qu'il fait	Appel API	Rôles
Icône d'actualisation	Recharge la liste	`GET /v1/prompts`	tout utilisateur du tenant
Nouveau prompt > Créer	Crée le prompt, ou publie une nouvelle version quand le nom existe (un modèle identique n'est pas dupliqué)	`POST /v1/prompts`	`tenant_admin`, `developer`
Versions (menu de ligne)	Affiche chaque version avec son modèle, ses variables, son modèle suggéré et son empreinte	`GET /v1/prompts/{name}/versions`	tout utilisateur du tenant
Rendu (menu de ligne)	Ouvre une boîte de dialogue avec Variables (JSON, obligatoire), puis rend la dernière version	`POST /v1/prompts/{name}/render`	tout utilisateur du tenant

Rôles

Le portail affiche tous les boutons. Dans services/control-plane/src/eai/domains/prompts/__init__.py la publication exige tenant_admin ou developer ; la lecture et le rendu exigent un utilisateur du tenant.

Tâches courantes

Publier un prompt et une nouvelle version

Créer le prompt. Le nom est la clé stable que les agents référencent. Cliquez sur Nouveau prompt, remplissez Nom (minuscules, chiffres, ., _, -), Modèle et Variables, puis Créer.

Résultat attendu : le message « Créé » et la ligne avec Dernière version à 1.

En cas d'échec : template_error signifie qu'un espace réservé est mal fermé ou non déclaré dans Variables.
Publier une modification. Créez de nouveau le prompt avec le même Nom et le nouveau Modèle.

Résultat attendu : Dernière version passe à 2 ; le même modèle à l'identique ne change rien.

En cas d'échec : forbidden signifie que vous n'êtes ni tenant_admin ni developer.

Vérifier le texte envoyé au modèle

Rendre le prompt. Le rendu applique les valeurs à la dernière version. Ouvrez le menu de la ligne, choisissez Rendu et saisissez les valeurs :
```
{"document": "le rapport joint", "language": "français"}
```
Résultat attendu : le panneau affiche text, chars, estimated_tokens, version et digest.

En cas d'échec : missing_variables liste les variables obligatoires sans valeur.

Dépannage

Symptôme	Cause	Correction
`forbidden` (403) sur Créer	Vous n'êtes ni `tenant_admin` ni `developer`	Demandez le rôle `developer`
`invalid_request` (400) avec `name`	Le nom contient des majuscules, des espaces ou d'autres caractères	Utilisez des minuscules, des chiffres, `.`, `_` et `-`
`template_error` (422)	Espace réservé mal fermé, type de variable invalide ou variable non déclarée	Déclarez chaque `{{variable}}` dans Variables
`missing_variables` (422) sur Rendu	Une variable obligatoire n'a pas de valeur	Ajoutez-la au JSON de Variables
`not_found` (404) avec `prompt_version`	La version demandée n'existe pas	Lisez d'abord Versions

Ce que montre l'écran​

Actions​

Rôles​

Tâches courantes​

Publier un prompt et une nouvelle version​

Vérifier le texte envoyé au modèle​

Dépannage​

Pages liées​