Studio de prompts

L'écran Studio de prompts vous permet d'écrire un modèle de prompt avec ses variables typées, de le publier comme nouvelle version, de lire ses versions et de rendre la dernière avec des valeurs de test. Chemin dans le portail : /studio/prompts. Il sert aux développeurs et aux administrateurs du tenant qui maintiennent les prompts de leurs agents.

Ce que montre l'écran

• À gauche, la liste des prompts du tenant (GET /v1/prompts), paginée, avec le bouton Nouveau en haut. Une liste vide affiche Aucun prompt pour l'instant et une action Nouveau.
• Nom : le nom du prompt (par exemple support-triage). Saisir un nom existant ouvre ses versions.
• Trois onglets :
  • Éditeur : Modèle (éditeur Markdown ; un emplacement est un nom de variable entre doubles accolades et doit être déclaré), Variables (JSON) (une liste JSON vérifiée en direct selon un schéma : name, type, required, default, description, max_length, enum), les problèmes de l'éditeur (« Ligne n : message » ou Aucun problème détecté par l'éditeur.) et les problèmes du modèle : Le modèle est vide., Un emplacement est déséquilibré ou invalide., La variable x est utilisée sans être déclarée.
  • Rendu : un éditeur JSON avec les valeurs des variables et le texte rendu.
  • Versions (avec leur nombre) : un tableau avec les colonnes Version, Empreinte, Auteur, Date, la plus récente en premier (GET /v1/prompts/{name}/versions).
• Sous le bouton, l'indication L'enregistrement nécessite le rôle tenant_admin ou developer. quand vos rôles ne permettent pas d'enregistrer.

Actions

Bouton ou action	Ce qu'il fait	Appel API	Rôles
Nouveau	Vide le nom et charge le modèle de départ avec ses deux variables.	Aucun	Tout le monde
Clic sur un prompt de la liste	Le sélectionne et charge ses versions.	GET /v1/prompts/{name}/versions	Tout utilisateur connecté
Enregistrer comme nouvelle version	Publie le modèle et les variables ; un nom existant reçoit une nouvelle version. Actif seulement quand le nom est renseigné et qu'il n'y a aucun problème.	POST /v1/prompts	tenant_admin, developer
Clic sur une ligne de Versions	Charge le modèle et les variables de cette version dans Éditeur.	Aucun	Tout utilisateur connecté
Rendre la dernière version	Rend la dernière version avec les valeurs (mode strict). Actif une fois les versions chargées.	POST /v1/prompts/{name}/render	Tout utilisateur connecté
Réessayer (état d'erreur de la liste)	Relit la liste.	GET /v1/prompts	Tout utilisateur connecté

Rôles

Le portail active Enregistrer comme nouvelle version pour STUDIO_WRITERS (tenant_admin, developer, dans portal/src/screens/studio.tsx). Le Control Plane contrôle les mêmes rôles sur POST /v1/prompts (services/control-plane/src/eai/domains/prompts/__init__.py) et répond forbidden sinon. Lire la liste, les versions et faire un rendu demande seulement un utilisateur connecté du tenant.

Tâches courantes

Publier un nouveau prompt

1. Partir du modèle de départ. Il montre la forme attendue. Cliquez sur Nouveau. Résultat attendu : le modèle de départ et deux variables team et language. En cas d'échec : rechargez la page.
2. Nommer le prompt. Le nom identifie le prompt dans les agents. Saisissez-le dans Nom (lettres minuscules, chiffres, point, tiret ou tiret bas). Résultat attendu : le bouton d'enregistrement devient actif dès qu'il n'y a plus de problème. En cas d'échec : le serveur répond invalid_request pour un nom invalide.
3. Écrire le modèle et les variables. Chaque emplacement doit être déclaré. Modifiez Modèle et Variables (JSON). Résultat attendu : Aucun problème détecté par l'éditeur. et aucun message rouge. En cas d'échec : déclarez la variable nommée par le message ou fermez les accolades.
4. Enregistrer. Cliquez sur Enregistrer comme nouvelle version. Résultat attendu : le message Enregistré en version n et le prompt dans la liste. En cas d'échec : lisez l'erreur sous le bouton (voir Dépannage).

Rendre la dernière version

1. Sélectionner le prompt. Cliquez dessus dans la liste. Résultat attendu : l'onglet Versions affiche un nombre. En cas d'échec : un nom jamais publié n'a aucune version.
2. Renseigner les valeurs. Ouvrez Rendu et modifiez le JSON (par exemple {"team": "support", "language": "Français"}). Résultat attendu : un JSON valide. En cas d'échec : corrigez la syntaxe JSON.
3. Rendre. Cliquez sur Rendre la dernière version. Résultat attendu : le texte rendu sous le bouton. En cas d'échec : missing_variables signifie qu'une variable obligatoire n'a pas de valeur.

Restaurer une ancienne version

1. Ouvrir les versions. Ouvrez Versions et cliquez sur la ligne de la version. Résultat attendu : Éditeur s'ouvre avec ce modèle. En cas d'échec : Aucune version pour l'instant signifie que le prompt n'a jamais été publié.
2. La republier. Cliquez sur Enregistrer comme nouvelle version. Résultat attendu : une nouvelle version avec l'ancien contenu. En cas d'échec : vérifiez votre rôle.

Dépannage

Symptôme	Cause	Correction
L'enregistrement nécessite le rôle tenant_admin ou developer.	Vos rôles ne permettent pas de publier.	Demandez le rôle developer à un administrateur du tenant.
Erreur forbidden (403) à l'enregistrement	Le serveur a refusé le rôle.	Comme ci-dessus.
Erreur invalid_request (400) à l'enregistrement	Le nom ne respecte pas la règle de nommage.	Utilisez des lettres minuscules, chiffres, point, tiret ou tiret bas.
Erreur template_error (422)	Emplacement déséquilibré, type de variable faux ou variable non déclarée.	Corrigez le modèle ou déclarez la variable.
Erreur missing_variables (422) au rendu	Une variable obligatoire n'a pas de valeur.	Ajoutez-la au JSON de Rendu.
Erreur not_found (404) au rendu	Le prompt ou la version n'existe pas.	Publiez d'abord le prompt.

Pages liées

• Développement de prompts
• Prompts (données)
• Studio de skills
• Studio de politiques
• Guide du portail développeur