> ## 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.

# Outils d’écriture des audits de prospection

> Créez un audit de prospection, relisez et enregistrez ses prompts, puis confirmez-le via MCP. Nécessite une équipe agence avec écritures MCP.

Ces outils exécutent depuis un client MCP le cycle de vie relisible d’un audit de prospection : créer l’audit, relire les prompts, puis confirmer pour lancer la collecte des réponses, qui consomme des crédits. Lisez d’abord [Accès en écriture MCP](https://docs.qwairy.co/fr/mcp/write/overview.md). Les exemples utilisent des données synthétiques.

> [!NOTE]
>
> Les outils d’écriture des audits de prospection exigent une équipe agence sur une offre Business, Agency Business ou Enterprise active. Les trois exigent le scope `write:pitch-audits` et le rôle Manager. La lecture des audits avec [`list_pitch_audits` et `get_pitch_audit`](https://docs.qwairy.co/fr/mcp/tools/pitch-audits) utilise le scope distinct `read:pitch-audits`.

| Outil | Confirmation | Équivalent REST |
| - | - | - |
| `create_pitch_audit` | `cost_increase` | [`POST /pitch-audits`](https://docs.qwairy.co/fr/developers/endpoints/pitch-audits/create) |
| `save_pitch_audit_prompts` | `always` | [`PATCH /pitch-audits/{auditId}/prompts`](https://docs.qwairy.co/fr/developers/endpoints/pitch-audits/save-prompts) |
| `confirm_pitch_audit` | `always` | [`POST /pitch-audits/{auditId}/confirm`](https://docs.qwairy.co/fr/developers/endpoints/pitch-audits/confirm) |

## create\_pitch\_audit

Crée un audit de prospection pour un prospect. Par défaut, les prompts sont préparés pour relecture avant toute consommation de crédits et l’appel n’exige aucune confirmation. Lorsque `autoStartResponses` vaut `true`, la collecte des réponses démarre aussitôt et consomme des crédits : l’appel exige alors un jeton de confirmation.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `teamId` | string | Oui | Équipe agence propriétaire de l’audit |
| `url` | string | Oui | URL ou domaine du site du prospect, jusqu’à 2048 caractères |
| `name` | string | Non | Nom affiché du prospect, jusqu’à 120 caractères |
| `countryCode` | string | Non | Code de marché sur deux lettres pris en charge. Le marché détermine les modèles disponibles |
| `promptCount` | integer | Non | Nombre de prompts à préparer, de 20 à 100. 30 par défaut |
| `customPrompts` | string\[] | Non | De 20 à 100 textes de prompts distincts importés à la place des prompts générés, chacun jusqu’à 1000 caractères |
| `modelIds` | string\[] | Non | Jusqu’à 20 modèles |
| `autoStartResponses` | boolean | Non | Ignore la relecture des prompts et lance la collecte des réponses, ce qui consomme des crédits et exige un jeton de confirmation. Laissez-le non défini pour relire d’abord |
| `dryRun` | boolean | Non | Aperçu sans création |
| `confirmationToken` | string | Non | Jeton renvoyé par l’aperçu |

### Exemple

```text theme={null}
Vous : Prépare un audit de prospection pour prospect.example aux États-Unis avec 20 prompts.

Assistant : appelle create_pitch_audit avec
  {"teamId": "team_agency_01", "url": "prospect.example", "countryCode": "US", "promptCount": 20}

Qwairy : crée l’audit et met en file d’attente la préparation des prompts. Aucun
crédit n’est encore consommé. L’audit attend la relecture.
```

***

## save\_pitch\_audit\_prompts

Remplace les prompts d’un audit de prospection en attente de relecture. Chaque appel exige un jeton de confirmation issu d’un aperçu, car il remplace les prompts enregistrés.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `auditId` | string | Oui | Identifiant de l’audit de prospection |
| `prompts` | object\[] | Oui | De 20 à 100 prompts. Chacun a `id` (jusqu’à 50 caractères), `text` (jusqu’à 1000), `category` (`TOFU`, `MOFU` ou `BOFU`) et `topic` (jusqu’à 120) |
| `expectedVersion` | integer | Oui | La `version` de l’audit que vous avez lue en dernier avec `get_pitch_audit` |
| `dryRun` | boolean | Non | Aperçu sans enregistrement |
| `confirmationToken` | string | Non | Jeton renvoyé par l’aperçu |

L’appel remplace l’ensemble des prompts. Envoyez tous les prompts que vous voulez conserver.

### Exemple

```text theme={null}
Vous : Retire les deux prompts sur les tarifs et garde le reste.

Assistant : lit l’audit (30 prompts), puis appelle save_pitch_audit_prompts
avec les 28 prompts restants et la version de l’audit qu’il a lue.
```

***

## confirm\_pitch\_audit

Confirme les prompts et lance la collecte des réponses. Cela consomme les crédits indiqués dans l’aperçu : chaque exécution exige donc un jeton de confirmation.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `auditId` | string | Oui | Identifiant de l’audit de prospection |
| `prompts` | object\[] | Non | De 20 à 100 prompts à utiliser, avec les mêmes champs que `save_pitch_audit_prompts` |
| `modelIds` | string\[] | Non | Jusqu’à 20 modèles |
| `dryRun` | boolean | Non | Aperçu du coût sans lancer |
| `confirmationToken` | string | Non | Jeton renvoyé par l’aperçu |

### Exemple

```text theme={null}
Vous : Confirme l’audit.

Assistant : appelle confirm_pitch_audit avec {"auditId": "audit_01"}

Qwairy : renvoie un aperçu avec les crédits que l’audit consommera et un
confirmationToken. Rien n’a démarré.

Vous : Confirme.

Assistant : répète l’appel avec le jeton. La collecte des réponses démarre, et
l’assistant lit ensuite get_pitch_audit pour vérifier le statut.
```

La relance d’un audit en échec et l’export d’un rapport restent des actions du tableau de bord.

## Voir aussi

* [Lancer un audit de prospection pour un prospect avec MCP](https://docs.qwairy.co/fr/developers/guides/pitch-audit-prospect-mcp.md) pour la séquence complète.
* [Outils de lecture des audits de prospection](https://docs.qwairy.co/fr/mcp/tools/pitch-audits.md).


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