Passer au contenu principal
POST
Accepter des suggestions de prompts
Crée des prompts à partir de 20 suggestions au plus de la dernière génération. Les prompts acceptés sont suivis par défaut, ce qui ajoute une consommation récurrente de crédits indiquée dans dailyCredits. Définissez dryRun sur true pour prévisualiser les résultats et cette consommation sans rien créer. Nécessite une offre Business, Agency Business ou Enterprise active, et un jeton d’API dont l’accès en écriture a été activé par un Propriétaire ou un Manager. Consultez Écrire des données pour l’activation, l’idempotence, les requêtes conditionnelles et la gestion des erreurs.
string
requis
Jeton bearer de votre équipe.
string
requis
Clé unique pour cette opération, 255 caractères au maximum. Les réponses terminées sont rejouées pendant 24 heures.
string
requis
Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.
string[]
requis
Entre 1 et 20 identifiants de suggestions issus de Obtenir les suggestions de prompts. Chaque identifiant compte 200 caractères au maximum. Les identifiants sont opaques et liés au contenu et à la classification. Relisez-les après une régénération. Une suggestion remplacée renvoie not_found au lieu d’accepter un contenu différent.
string | null
Topic de chaque prompt accepté. Par défaut, le Topic suggéré.
string[]
20 identifiants de Tags au maximum, appliqués à chaque prompt accepté.
boolean
défaut:"true"
Indique si les prompts acceptés participent au suivi planifié.
boolean
défaut:"false"
Valide la requête et renvoie les résultats sans créer de prompts.

Réponse

Renvoie 200 avec dryRun, dailyCredits et items. Examinez chaque élément : le statut HTTP seul ne signifie pas que toutes les suggestions ont été acceptées. already_tracked signifie qu’un prompt équivalent est déjà actif et suivi, ou qu’une suggestion précédente de la même requête a le même texte. Une suggestion équivalente à un prompt archivé ou en pause réactive ce prompt et renvoie created, comme dans le Studio du dashboard. L’import réécrit son texte, son étape du tunnel et son Topic, efface ses pays, et rétablit ses Personas et ses modèles sur les valeurs par défaut du workspace. Sa fréquence, son Boost et sa dernière collecte sont conservés. L’acceptation ne lance elle-même aucune collecte. Sur un workspace LIVE, elle peut rendre des prompts suivis dus au prochain passage du planificateur, qui s’exécute à l’heure et à la demie (UTC) : un nouveau prompt lorsque les réponses automatiques sont activées, ou un prompt réactivé dont la dernière collecte est plus ancienne que sa fréquence. Cette première collecte consomme des crédits une fois, en plus de dailyCredits. Cette réponse, dryRun compris, n’indique pas ce montant. L’aperçu de l’outil MCP accept_prompt_suggestions l’indique.

Requête et réponse synthétiques

Erreurs

Consultez Codes d’erreur pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Un jeton sans accès en écriture renvoie 403 API_KEY_READ_ONLY. Sur 429, respectez Retry-After. Si le limiteur d’écriture est indisponible ou si les écritures sont suspendues, la requête renvoie 503 SERVICE_UNAVAILABLE et rien ne change.