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.
  • Un workspace, avec ses Topics déjà créés si vous voulez une génération par Topic.

Étapes

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 jusqu’à ce que le statut soit COMPLETED. 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.
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 et le jeton. 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

Listez les prompts du workspace et vérifiez que les nouveaux y figurent avec le Topic et l’état de suivi attendus.

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