> ## 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 suggestions de prompts

> Générez des suggestions Prompt Studio pour un workspace et acceptez-les comme prompts suivis via MCP. L’acceptation ajoute une consommation de crédits.

Prompt Studio propose des prompts à suivre. Ces outils lancent une génération et transforment des suggestions choisies en prompts. 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 deux outils exigent le scope `write:prompts` et le rôle Manager. Les exemples utilisent des données synthétiques.

| Outil | Confirmation | Équivalent REST |
| - | - | - |
| `generate_prompt_suggestions` | `never` | [`POST /brands/{brandId}/prompt-suggestions/runs`](https://docs.qwairy.co/fr/developers/endpoints/prompt-suggestions/generate) |
| `accept_prompt_suggestions` | `always` | [`POST /brands/{brandId}/prompt-suggestions/accept`](https://docs.qwairy.co/fr/developers/endpoints/prompt-suggestions/accept) |

Lisez les résultats avec [`get_prompt_suggestions` et `get_prompt_suggestion_run`](https://docs.qwairy.co/fr/mcp/tools/responses#get_prompt_suggestions).

## generate\_prompt\_suggestions

Lance une génération Prompt Studio. Une génération ne consomme aucun crédit client. Elle est limitée par workspace et par jour.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | Identifiant du workspace |
| `source` | string | Non | `manual` ou `topic` |
| `keywordId` | string | Non | Identifiant du Topic. Requis lorsque `source` vaut `topic` |
| `refill` | boolean | Non | Ajoute des suggestions au lot courant au lieu de repartir de zéro |
| `requestId` | string | Non | De 1 à 200 caractères. Réutilisez-le pour une répétition réseau ; choisissez une nouvelle valeur pour une nouvelle génération |
| `dryRun` | boolean | Non | Valide sans lancer |
| `confirmationToken` | string | Non | Jeton renvoyé par l’aperçu |

Sur 24 heures glissantes, un workspace peut lancer 3 générations de workspace et 10 générations de Topic. Une génération de workspace et une génération par Topic peuvent être en cours simultanément. Un appel portant sur le même périmètre déjà en cours est refusé.

Utilisez un nouveau `requestId` pour chaque génération volontaire, y compris après une génération terminée en `FAILED`. Conservez la même valeur pour répéter une requête dont la réponse a été perdue. Sans `requestId`, les appels identiques rejouent le résultat précédent pendant 24 heures.

### Exemple

```text theme={null}
Vous : Suggère de nouveaux prompts pour le Topic « CRM software ».

Assistant : appelle generate_prompt_suggestions avec
  {"brandId": "brand_01", "source": "topic", "keywordId": "topic_01"}

Qwairy : lance la génération et renvoie son identifiant. L’assistant interroge
get_prompt_suggestion_run jusqu’à ce que le statut soit COMPLETED, puis lit
get_prompt_suggestions.
```

***

## accept\_prompt\_suggestions

Crée des prompts à partir de 20 suggestions au plus de la dernière génération. Les prompts suivis ajoutent la consommation récurrente de crédits indiquée dans l’aperçu : chaque exécution exige donc un jeton de confirmation.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | Identifiant du workspace |
| `suggestionIds` | string\[] | Oui | De 1 à 20 identifiants de suggestions issus de `get_prompt_suggestions` |
| `keywordId` | string | Non | Topic de chaque prompt accepté. Par défaut, le Topic suggéré |
| `tagIds` | string\[] | Non | Jusqu’à 20 identifiants de Tags appliqués à chaque prompt accepté |
| `monitoringEnabled` | boolean | Non | Indique si les nouveaux prompts sont suivis. `true` par défaut |
| `dryRun` | boolean | Non | Aperçu du résultat de chaque suggestion et de la consommation récurrente de crédits |
| `confirmationToken` | string | Non | Jeton renvoyé par l’aperçu |

Examinez le résultat de chaque suggestion. Une suggestion peut être créée, déjà suivie, introuvable ou invalide. Déjà suivie signifie qu’un prompt équivalent est actif et suivi. Les identifiants sont opaques et liés au contenu et à la classification de la suggestion. Relisez-les après une régénération ; un ancien identifiant ne peut pas accepter une suggestion différente.

L’acceptation utilise le même import que Prompt Studio. Une suggestion équivalente à un prompt archivé ou en pause réactive ce prompt et renvoie `created`. Son texte, son étape du tunnel et son Topic sont réécrits, ses pays sont effacés, et ses Personas et ses modèles reviennent aux 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, mais sur un workspace `LIVE` elle peut rendre des prompts dus au prochain passage du planificateur : 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 la consommation récurrente. L’aperçu l’indique dans `credits.oneOff` et la variation récurrente dans `credits.dailyChange`. L’exécution refuse la confirmation lorsque l’un de ces montants a changé depuis l’aperçu.

### Exemple

```text theme={null}
Vous : Accepte les trois premières suggestions recommandées, avec suivi.

Assistant : appelle accept_prompt_suggestions avec
  {"brandId": "brand_01", "suggestionIds": ["suggestion_01", "suggestion_02", "suggestion_03"], "monitoringEnabled": true}

Qwairy : renvoie un aperçu des trois prompts et de leur consommation récurrente
de crédits, avec un confirmationToken.

Vous : Confirme.

Assistant : répète l’appel avec le jeton.
```

## Voir aussi

* [Obtenir des suggestions de prompts avec MCP](https://docs.qwairy.co/fr/developers/guides/prompt-suggestions-mcp.md) pour la séquence complète.
* [Outils d’écriture des prompts, Topics et Tags](https://docs.qwairy.co/fr/mcp/write/prompts-topics-tags.md).


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