Passer au contenu principal
Prompt Studio propose des prompts à suivre. Ce guide génère un lot de suggestions depuis un assistant MCP, les relit avec vous et accepte celles que vous sélectionnez comme prompts. La génération ne consomme aucun crédit client. Accepter des prompts suivis ajoute une consommation récurrente de crédits, et peut lancer une collecte au prochain passage du planificateur.

Avant de commencer

  • Une offre Business, Agency Business ou Enterprise active.
  • Une connexion avec read:prompts et write:prompts, et un rôle de Manager ou de Propriétaire. Consultez Accès en écriture MCP.
  • Pour une génération par Topic, utilisez l’UUID d’un Topic existant. Sa recherche avec list_topics exige read:topics. Une génération pour tout le workspace se lance sans identifiant de Topic.

Étapes

Dans les exemples ci-dessous, utilisez l’UUID de votre Topic et les identifiants de suggestions renvoyés par get_prompt_suggestions.
1

Lancer une génération

L’assistant appelle generate_prompt_suggestions. Utilisez source: manual pour tout le workspace, ou source: topic avec un keywordId :
Un workspace peut lancer 3 générations de workspace et 10 générations de Topic sur 24 heures glissantes, avec au plus une génération de workspace et une par Topic en cours simultanément. Réutilisez requestId après une réponse perdue ; changez-le pour une nouvelle génération, y compris après FAILED.
2

Attendre la fin

L’assistant interroge get_prompt_suggestion_run avec l’identifiant reçu sous la clé suggestionRunId. Sur FAILED, arrêtez-vous et signalez l’échec. Relancez avec un nouveau requestId uniquement si une nouvelle génération est souhaitée. Sur COMPLETED, poursuivez. Un client qui utilise aussi l’API REST peut s’abonner à prompt_suggestions.ready et prompt_suggestions.failed au lieu d’interroger. L’événement porte l’identifiant de la génération dans data.runId.
3

Lire les suggestions

get_prompt_suggestions renvoie par défaut les 20 recommandations, avec un score, une reason et un indicateur tracked. Passez limit, jusqu’à 500, pour lire davantage du lot ; total donne sa taille. Utilisez focus pour réordonner par étape du tunnel : DISCOVERY, CONSIDERATION, PERCEPTION ou AUTHORITY. Ignorez les suggestions déjà suivies, c’est-à-dire actives et suivies. Une suggestion équivalente à un prompt archivé ou en pause donne false, et l’accepter réactive ce prompt. Avant de choisir des identifiants, comparez le run.id renvoyé à celui de la génération suivie. Si une génération plus récente a remplacé la précédente, relisez ce nouveau lot séparément.
4

Choisir et prévisualiser

Choisissez 20 suggestions au plus. L’assistant appelle accept_prompt_suggestions avec dryRun défini sur true, ou sans jeton :
Qwairy renvoie le résultat de chaque suggestion, la consommation récurrente de crédits des prompts suivis dans credits.dailyChange, le coût de la collecte que lancerait le prochain passage du planificateur dans credits.oneOff, et un confirmationToken.
5

Confirmer

Si les deux montants sont acceptables, confirmez. L’assistant répète l’appel avec les mêmes arguments métier et le jeton, en omettant dryRun ou en le passant à false. Le jeton est à usage unique, valable 10 minutes, et rejeté si les arguments ou le coût ont changé. Votre client MCP peut aussi demander sa propre approbation.
6

Vérifier les prompts

Lisez les prompts acceptés avec get_prompts et vérifiez le topic, le suivi et la fréquence effective. L’acceptation n’a pas de paramètre de fréquence. Pour un suivi hebdomadaire, utilisez update_prompt avec frequency: WEEKLY et la version actuelle du prompt dans expectedVersion. Vérifiez l’éventuel aperçu de coût puis relisez le résultat.

Exemple de conversation

Limites

  • Les suggestions sont des idées fondées sur votre workspace. Elles ne prédisent pas ce qu’un assistant IA répondra.
  • L’acceptation porte sur les suggestions de la dernière génération. Les identifiants sont liés au contenu et à la classification : relisez-les après une régénération et ne les construisez jamais vous-même.
  • Une suggestion peut être créée, déjà suivie, introuvable ou invalide : vérifiez chaque élément.
  • L’acceptation ne lance elle-même aucune collecte, mais sur un workspace LIVE elle peut rendre des prompts nouveaux ou réactivés dus au prochain passage du planificateur. Cette collecte consomme des crédits une fois ; l’aperçu indique le montant dans credits.oneOff.

Voir aussi