> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Outil d’écriture des runs

> Lancez un run via MCP pour collecter dès maintenant les réponses de prompts et de modèles choisis. L’outil réserve des crédits et exige une confirmation.

Un run collecte immédiatement les réponses des prompts et des modèles choisis, au lieu d’attendre le calendrier de suivi. Lisez d’abord [Accès en écriture MCP](https://docs.qwairy.co/fr/mcp/write/overview.md) pour les offres, scopes, rôles et jetons de confirmation. Les exemples utilisent des données synthétiques.

| Outil | Scope | Rôle minimal | Confirmation | Équivalent REST |
| - | - | - | - | - |
| `start_run` | `write:monitoring` | Manager | `always` | [`POST /brands/{brandId}/runs`](https://docs.qwairy.co/fr/developers/endpoints/runs/manage) |

## start\_run

Collecte dès maintenant les réponses des prompts et des modèles choisis. L’outil réserve les crédits indiqués dans l’aperçu : il exige donc un jeton de confirmation à chaque exécution.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | Identifiant d’un workspace `LIVE` |
| `promptIds` | string\[] | Non | Prompts à exécuter. Par défaut, tous les prompts actifs du workspace |
| `modelIds` | string\[] | Non | Modèles à exécuter. Par défaut, les modèles de suivi du workspace |
| `dryRun` | boolean | Non | Aperçu des cibles et du coût sans réserver de crédits |
| `confirmationToken` | string | Non | Jeton renvoyé par l’aperçu |

### Avant de commencer

1. Appelez [`estimate_run`](https://docs.qwairy.co/fr/mcp/tools/runs#estimate_run) pour voir les prompts et les modèles utilisables, ainsi que les crédits estimés.
2. Appelez [`get_credits`](https://docs.qwairy.co/fr/mcp/tools/runs#get_credits) si vous devez vérifier que le solde couvre le coût.
3. Appelez `start_run` sans jeton pour recevoir l’aperçu et le jeton, puis répétez l’appel avec le jeton.

### Après le lancement

La collecte est asynchrone. Suivez la progression avec [`get_run` et `list_runs`](https://docs.qwairy.co/fr/mcp/tools/runs). Il n’existe pas d’outil MCP pour annuler ou relancer un run. Pour être averti par vos propres systèmes à la fin d’un run, abonnez-vous à l’[événement `run.completed`](https://docs.qwairy.co/fr/developers/integration-webhooks/events#run-completed) avec l’API REST.

> [!NOTE]
>
> L’aperçu indique les crédits qui seraient réservés. Le transfert de crédits entre équipes et l’achat de crédits restent des actions du tableau de bord.

### Exemple

```text theme={null}
Vous : Lance maintenant les cinq prompts CRM d’Acme Analytics sur ChatGPT et Gemini.

Assistant : appelle estimate_run, qui indique 10 réponses et les crédits nécessaires,
puis appelle start_run avec
  {"brandId": "brand_01", "promptIds": ["prompt_01", "prompt_02", "prompt_03", "prompt_04", "prompt_05"],
   "modelIds": ["openai-gpt", "google-gemini"]}

Qwairy : renvoie un aperçu des cibles et des crédits à réserver, ainsi qu’un
confirmationToken. Rien n’a démarré.

Vous : Confirme.

Assistant : appelle de nouveau start_run avec les mêmes arguments et le jeton,
puis lit get_run pour suivre la progression.
```

## Voir aussi

* [Outils de runs et de crédits](https://docs.qwairy.co/fr/mcp/tools/runs.md) pour les estimations, l’état et le solde de crédits.
* [Intégrer un client avec l’API](https://docs.qwairy.co/fr/developers/guides/onboard-client-api.md) pour un workflow REST qui se termine par un premier run.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.