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

# Ajouter des suggestions de prompts avec MCP

> Générez des suggestions Prompt Studio depuis un assistant MCP, relisez-les, acceptez celles voulues après un aperçu du coût, et suivez prompt_suggestions.ready.

Prompt Studio propose des prompts à suivre. Ce guide génère un lot de suggestions depuis un assistant MCP, les relit avec vous et accepte celles que vous sélectionnez comme prompts. La génération ne consomme aucun crédit client. Accepter des prompts suivis ajoute une consommation récurrente de crédits, et peut lancer une collecte au prochain passage du planificateur.

## Avant de commencer

* Une offre Business, Agency Business ou Enterprise active.
* Une connexion avec `read:prompts` et `write:prompts`, et un rôle de Manager ou de Propriétaire. Consultez [Accès en écriture MCP](https://docs.qwairy.co/fr/mcp/write/overview.md).
* Un workspace, avec ses Topics déjà créés si vous voulez une génération par Topic.

## Étapes

**1. Lancer une génération**

L’assistant appelle [`generate_prompt_suggestions`](https://docs.qwairy.co/fr/mcp/write/prompt-suggestions#generate_prompt_suggestions). Utilisez `source: manual` pour tout le workspace, ou `source: topic` avec un `keywordId` :

```json theme={null}
{ "brandId": "brand_01", "source": "topic", "keywordId": "topic_01", "requestId": "suggestions-001" }
```

Un workspace peut lancer 3 générations de workspace et 10 générations de Topic sur 24 heures glissantes, avec au plus une génération de workspace et une par Topic en cours simultanément. Réutilisez `requestId` après une réponse perdue ; changez-le pour une nouvelle génération, y compris après `FAILED`.

**2. Attendre la fin**

L’assistant interroge [`get_prompt_suggestion_run`](https://docs.qwairy.co/fr/mcp/tools/responses#get_prompt_suggestion_run) jusqu’à ce que le statut soit `COMPLETED`. Un client qui utilise aussi l’API REST peut s’abonner à [`prompt_suggestions.ready`](https://docs.qwairy.co/fr/developers/integration-webhooks/events#prompt_suggestions-ready) et [`prompt_suggestions.failed`](https://docs.qwairy.co/fr/developers/integration-webhooks/events#prompt_suggestions-failed) au lieu d’interroger. L’événement porte l’identifiant de la génération dans `data.runId`.

**3. Lire les suggestions**

[`get_prompt_suggestions`](https://docs.qwairy.co/fr/mcp/tools/responses#get_prompt_suggestions) renvoie par défaut les 20 recommandations, avec un `score`, une `reason` et un indicateur `tracked`. Passez `limit`, jusqu’à 500, pour lire davantage du lot ; `total` donne sa taille. Utilisez `focus` pour réordonner par étape du tunnel : `DISCOVERY`, `CONSIDERATION`, `PERCEPTION` ou `AUTHORITY`. Ignorez les suggestions déjà suivies, c’est-à-dire actives et suivies. Une suggestion équivalente à un prompt archivé ou en pause donne `false`, et l’accepter réactive ce prompt.

**4. Choisir et prévisualiser**

Choisissez 20 suggestions au plus. L’assistant appelle [`accept_prompt_suggestions`](https://docs.qwairy.co/fr/mcp/write/prompt-suggestions#accept_prompt_suggestions) avec `dryRun` défini sur `true`, ou sans jeton :

```json theme={null}
{
  "brandId": "brand_01",
  "suggestionIds": ["suggestion_01", "suggestion_02"],
  "keywordId": "topic_01",
  "monitoringEnabled": true
}
```

Qwairy renvoie le résultat de chaque suggestion, la consommation récurrente de crédits des prompts suivis dans `credits.dailyChange`, le coût de la collecte que lancerait le prochain passage du planificateur dans `credits.oneOff`, et un `confirmationToken`.

**5. Confirmer**

Si les deux montants sont acceptables, confirmez. L’assistant répète l’appel avec les mêmes arguments et le jeton. Le jeton est à usage unique, valable 10 minutes, et rejeté si les arguments ou le coût ont changé. Votre client MCP peut aussi demander sa propre approbation.

**6. Vérifier les prompts**

Listez les prompts du workspace et vérifiez que les nouveaux y figurent avec le Topic et l’état de suivi attendus.

## Exemple de conversation

```text theme={null}
Vous : Suggère des prompts pour notre Topic logiciel CRM.

Assistant : lance une génération pour le Topic, l’attend, puis affiche les cinq
suggestions les mieux notées qui ne sont pas déjà suivies.

Vous : Prends les trois premières, suivies chaque semaine.

Assistant : prévisualise l’acceptation. Trois prompts seraient créés, avec leur
consommation récurrente de crédits et un jeton de confirmation.

Vous : Confirme.

Assistant : accepte avec le jeton et liste les nouveaux prompts.
```

## Limites

* Les suggestions sont des idées fondées sur votre workspace. Elles ne prédisent pas ce qu’un assistant IA répondra.
* L’acceptation porte sur les suggestions de la dernière génération. Les identifiants sont liés au contenu et à la classification : relisez-les après une régénération et ne les construisez jamais vous-même.
* Une suggestion peut être créée, déjà suivie, introuvable ou invalide : vérifiez chaque élément.
* L’acceptation ne lance elle-même aucune collecte, mais sur un workspace `LIVE` elle peut rendre des prompts nouveaux ou réactivés dus au prochain passage du planificateur. Cette collecte consomme des crédits une fois ; l’aperçu indique le montant dans `credits.oneOff`.

## Voir aussi

* [Outils d’écriture des suggestions de prompts](https://docs.qwairy.co/fr/mcp/write/prompt-suggestions.md)
* [Générer des suggestions de prompts](https://docs.qwairy.co/fr/developers/endpoints/prompt-suggestions/generate.md) pour l’équivalent REST.


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