> ## 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 prompts, Topics et Tags

> Créez, modifiez, archivez et éditez en masse des prompts, et créez ou renommez Topics et Tags via MCP, avec confirmation des prompts existants.

Ces outils gèrent les prompts qu’un workspace suit, ainsi que les Topics et les Tags qui les organisent. Lisez d’abord [Accès en écriture MCP](https://docs.qwairy.co/fr/mcp/write/overview.md) pour les offres, scopes, rôles, `dryRun`, `expectedVersion` et jetons de confirmation. Tous les outils exigent le scope `write:prompts` et le rôle Manager. Les exemples utilisent des données synthétiques.

| Outil | Confirmation | Équivalent REST |
| - | - | - |
| `create_prompts` | `cost_increase` | [`POST /brands/{brandId}/prompts`](https://docs.qwairy.co/fr/developers/endpoints/prompts/manage) |
| `update_prompt` | `always` | [`PATCH /brands/{brandId}/prompts/{promptId}`](https://docs.qwairy.co/fr/developers/endpoints/prompts/update) |
| `bulk_update_prompts` | `except_restore` | [`POST /brands/{brandId}/prompts/bulk`](https://docs.qwairy.co/fr/developers/endpoints/prompts/bulk) |
| `create_topic` | `never` | [`POST /brands/{brandId}/keywords`](https://docs.qwairy.co/fr/developers/endpoints/keywords/manage) |
| `update_topic` | `never` | [`PATCH /brands/{brandId}/keywords/{keywordId}`](https://docs.qwairy.co/fr/developers/endpoints/keywords/update) |
| `create_tag` | `never` | [`POST /brands/{brandId}/tags`](https://docs.qwairy.co/fr/developers/endpoints/tags/create) |
| `update_tag` | `never` | [`PATCH /brands/{brandId}/tags/{tagId}`](https://docs.qwairy.co/fr/developers/endpoints/tags/update) |

`create_prompts` n’exige un jeton de confirmation que lorsqu’il met des prompts sous suivi, car cela ajoute une consommation récurrente de crédits. L’aperçu indique le montant. `update_prompt` en exige toujours un, car il modifie ou archive un prompt existant. `bulk_update_prompts` en exige un aussi, sauf pour une simple restauration de prompts archivés qui n’augmente pas la consommation de crédits. Les Topics et les Tags ne peuvent pas être supprimés via MCP : supprimez-les depuis le tableau de bord ou avec l’API REST.

`Branded` et `Non-branded` sont des Tags système que Qwairy pose sur chaque prompt d’après son texte, dans un workspace créé à partir de la v1.21. Leurs noms sont réservés, quelle que soit la casse : `create_tag` avec l’un de ces noms, `update_tag` qui renomme un Tag avec l’un de ces noms, et `update_tag` sur l’un des deux Tags système sont refusés avec `INVALID_REQUEST`, y compris dans un aperçu `dryRun`. Dans `create_prompts`, `update_prompt` et `bulk_update_prompts`, les identifiants de ces deux Tags dans `tagIds` sont ignorés, et un remplacement de Tags conserve le Tag système que porte le prompt. Lorsque `update_prompt` modifie le texte, Qwairy pose de nouveau le Tag système d’après le nouveau texte.

## create\_prompts

Crée de 1 à 20 prompts. Les prompts suivis ajoutent une consommation récurrente de crédits indiquée dans l’aperçu.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | Identifiant du workspace |
| `prompts` | object\[] | Oui | De 1 à 20 prompts |
| `prompts[].text` | string | Oui | Texte du prompt, jusqu’à 500 caractères |
| `prompts[].frequency` | string | Non | `NONE`, `DAILY`, `WEEKLY` ou `MONTHLY`. Omettez-le pour hériter du calendrier du workspace |
| `prompts[].keywordId` | string | Non | Identifiant de Topic issu de `list_topics` |
| `prompts[].tagIds` | string\[] | Non | Identifiants de Tags issus de `list_tags` |
| `prompts[].countryCodes` | string\[] | Non | Jusqu’à 50 pays du catalogue du workspace. Vide signifie le pays par défaut |
| `prompts[].modelIds` | string\[] | Non | Jusqu’à 30 modèles pour ce prompt uniquement. Vide signifie les modèles du workspace |
| `dryRun` | boolean | Non | Aperçu sans création |
| `confirmationToken` | string | Non | Jeton renvoyé par l’aperçu |

### Exemple

```text theme={null}
Vous : Ajoute ces deux prompts à Acme Analytics sous le Topic « CRM software »,
en hebdomadaire.

Assistant : appelle create_prompts avec
  {"brandId": "brand_01", "prompts": [
    {"text": "Which CRM tools support small sales teams?", "frequency": "WEEKLY", "keywordId": "topic_01"},
    {"text": "How do I compare CRM pricing for a ten-person team?", "frequency": "WEEKLY", "keywordId": "topic_01"}
  ]}

Qwairy : renvoie un aperçu. Deux prompts seraient créés et suivis chaque semaine.
La consommation récurrente de crédits est indiquée, et un confirmationToken est renvoyé.

Vous : Confirme.

Assistant : répète l’appel avec le jeton. Les deux prompts sont créés.
```

***

## update\_prompt

Modifie le texte, le Topic, les Tags, la fréquence, les pays ou les modèles d’un prompt, l’archive ou le restaure. N’envoyez que les champs à modifier. Chaque appel exige un jeton de confirmation issu d’un aperçu.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | Identifiant du workspace |
| `promptId` | string | Oui | Identifiant du prompt |
| `expectedVersion` | integer | Oui | `version` du prompt que vous avez lue en dernier |
| `text` | string | Non | Nouveau texte du prompt |
| `status` | string | Non | `ACTIVE` ou `ARCHIVED`. L’archivage conserve les réponses et l’historique |
| `frequency` | string | Non | `NONE`, `DAILY`, `WEEKLY` ou `MONTHLY` |
| `monitoringEnabled` | boolean | Non | Indique si le prompt est suivi |
| `keywordId` | string | Non | Identifiant du Topic |
| `tagIds` | string\[] | Non | Liste de remplacement complète. Un tableau vide retire tous les Tags |
| `countryCodes` | string\[] | Non | Liste de remplacement complète d’au plus 50 pays |
| `modelIds` | string\[] | Non | Liste de remplacement complète d’au plus 30 modèles |
| `dryRun` | boolean | Non | Aperçu sans modification |
| `confirmationToken` | string | Non | Jeton renvoyé par l’aperçu |

### Exemple

```text theme={null}
Vous : Archive le prompt sur le prix des CRM.

Assistant : lit le prompt, puis appelle update_prompt avec
  {"brandId": "brand_01", "promptId": "prompt_02", "expectedVersion": 1, "status": "ARCHIVED"}

Qwairy : renvoie un aperçu avec un confirmationToken et n’exécute rien.

Vous : Confirme.

Assistant : rappelle update_prompt avec les mêmes arguments et le jeton.

Qwairy : archive le prompt. Ses réponses passées restent disponibles.
```

***

## bulk\_update\_prompts

Applique une même opération à 20 prompts au plus. Chaque prompt a besoin de sa version attendue, et les écarts de version sont signalés élément par élément. Un jeton de confirmation est exigé, sauf pour une simple restauration de prompts archivés qui n’augmente pas la consommation de crédits.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | Identifiant du workspace |
| `operation` | string | Oui | `archive`, `restore`, `frequency`, `topic` ou `tags` |
| `promptIds` | string\[] | Oui | Jusqu’à 20 identifiants de prompts |
| `expectedVersions` | object | Oui | Table associant chaque identifiant de prompt à la `version` que vous avez lue en dernier |
| `frequency` | string | Non | Utilisé par l’opération `frequency` |
| `keywordId` | string | Non | Utilisé par l’opération `topic` |
| `tagIds` | string\[] | Non | Utilisé par l’opération `tags` |
| `dryRun` | boolean | Non | Aperçu du résultat de chaque élément sans modification |
| `confirmationToken` | string | Non | Jeton renvoyé par l’aperçu |

Examinez le résultat de chaque élément. Un appel en masse peut mettre à jour certains prompts et signaler d’autres comme inchangés ou introuvables.

### Exemple

```text theme={null}
Vous : Archive les prompts sur notre ancienne gamme de produits.

Assistant : appelle bulk_update_prompts avec
  {"brandId": "brand_01", "operation": "archive",
   "promptIds": ["prompt_03", "prompt_04"],
   "expectedVersions": {"prompt_03": 2, "prompt_04": 5}, "dryRun": true}

Qwairy : prévisualise chaque élément. prompt_03 serait archivé, et prompt_04
resterait inchangé car il est déjà archivé.
```

***

## create\_topic et update\_topic

`create_topic` crée un Topic dans un workspace. `update_topic` le renomme.

### Paramètres

| Paramètre | Outil | Requis | Description |
| - | - | - | - |
| `brandId` | les deux | Oui | Identifiant du workspace |
| `text` | les deux | Oui | Libellé du Topic. Jusqu’à 255 caractères à la création |
| `keywordId` | `update_topic` | Oui | Identifiant du Topic |
| `expectedVersion` | `update_topic` | Oui | `version` du Topic que vous avez lue en dernier |
| `dryRun`, `confirmationToken` | les deux | Non | Aperçu et confirmation |

### Exemple

```text theme={null}
Vous : Crée un Topic « CRM software » pour Acme Analytics.

Assistant : appelle create_topic avec {"brandId": "brand_01", "text": "CRM software"}

Qwairy : crée le Topic et renvoie son identifiant, que vous pouvez utiliser dans create_prompts.
```

***

## create\_tag et update\_tag

`create_tag` crée un Tag. `update_tag` le renomme ou en change la couleur.

| Paramètre | Outil | Requis | Description |
| - | - | - | - |
| `brandId` | les deux | Oui | Identifiant du workspace |
| `name` | `create_tag` | Oui | Libellé du Tag, jusqu’à 120 caractères |
| `tagId` | `update_tag` | Oui | Identifiant du Tag |
| `name` | `update_tag` | Non | Nouveau libellé |
| `color` | les deux | Non | Valeur de couleur au format hexadécimal |
| `expectedVersion` | `update_tag` | Oui | `version` du Tag que vous avez lue en dernier |
| `dryRun`, `confirmationToken` | les deux | Non | Aperçu et confirmation |

### Exemple

```text theme={null}
Vous : Crée un Tag « Pricing » en bleu.

Assistant : appelle create_tag avec {"brandId": "brand_01", "name": "Pricing", "color": "#2563EB"}
```

## Voir aussi

* [Outils de découverte](https://docs.qwairy.co/fr/mcp/tools/discovery.md) pour résoudre les identifiants de Topics et de Tags.
* [Suggestions de prompts](https://docs.qwairy.co/fr/mcp/write/prompt-suggestions.md) pour créer des prompts à partir d’idées générées.


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