Passer au contenu principal
Consultez Compatibilité des filtres pour le contrat de filtres de référence et la couverture de chaque outil MCP.
Ces outils lisent l’état des runs et les crédits. Ils ne modifient rien et ne consomment aucun crédit. Lancer un run est une opération d’écriture : consultez Outil d’écriture des runs. Ils suivent l’accès MCP en lecture et sont disponibles à partir de Starter, sans scope d’écriture.

estimate_run

Estime les crédits qu’un run consommerait, sans rien réserver ni débiter.

Paramètres

Résultat

Une estimation est un instantané. Le lancement du run revalide les cibles et le solde : son résultat peut donc différer.

Scope OAuth

Requis : read:prompts

list_runs

Liste les runs récents d’un workspace avec leur statut, du plus récent au plus ancien.

Paramètres

Résultat

Chaque run inclut son objectif, le nombre de prompts et de modèles, les nombres demandés et planifiés, un status calculé, des counts de résultats et progressPercentage. La réponse renvoie aussi nextCursor (null lorsqu’il n’y a plus de page), totalCount et activeCount pour l’ensemble du workspace. Le statut vaut QUEUED, PROCESSING, COMPLETED, COMPLETED_WITH_WARNINGS, FAILED, CANCELLED ou NO_WORK. La progression ne garantit pas que chaque réponse demandée a réussi : lisez le statut et les nombres de résultats.

Scope OAuth

Requis : read:prompts

get_run

Récupère le statut et les compteurs d’un run.

Paramètres

Résultat

Les métadonnées de planification du run : son objectif, le nombre de prompts et de modèles, les nombres demandés et planifiés, le nombre de tentatives enregistrées, si la planification est terminée ou en échec, et les horodatages. La fin de la planification ne signifie pas que chaque réponse est terminée : utilisez list_runs pour le statut et la progression calculés.

Exemples de prompts

Scope OAuth

Requis : read:prompts

get_credits

Récupère le solde de crédits d’une équipe, son utilisation récente et son autonomie. Exige le rôle Manager ou Propriétaire dans cette équipe.

Paramètres

Résultat

Scope OAuth

Requis : read:brands