> ## 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 de prompts et de réponses

> Outils pour parcourir les prompts suivis et analyser les réponses IA en détail.

<Note>
  Consultez [Compatibilité des filtres](/fr/mcp/tools/filters) pour le contrat de référence des filtres globaux. Ces paramètres communs (période, dates personnalisées, fournisseurs, Topics, Tags et étapes du tunnel) s’appliquent à `get_prompts`, `get_prompt_answers` et `get_answers` en plus des paramètres présentés ci-dessous. Ces trois outils utilisent par défaut les 30 derniers jours.
</Note>

## get\_prompts

Liste les prompts suivis avec leur configuration et le nombre de réponses dans le périmètre d’analyse sélectionné.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `status` | string | Non | `PENDING`, `IN_PROGRESS` ou `COMPLETED` |
| `personaIds` | string\[] | Non | Conserve les prompts ayant des réponses historiques pour ces UUID de Personas ; `"default"` correspond aux réponses générées sans Persona |
| `countries` | string\[] | Non | Conserve les prompts ayant des réponses historiques dans ces pays (codes ISO 3166-1 alpha-2, 50 au maximum) |
| `limit` | number | Non | Nombre maximal de prompts (par défaut : 50) |
| `offset` | number | Non | Décalage de pagination (par défaut : 0) |

Les filtres de fournisseur, de Persona et de pays doivent correspondre à une même réponse historique, sur tout l’historique du prompt. Ils ne filtrent jamais les Personas ni les modèles actuellement rattachés au prompt. `answersCount` utilise la période sélectionnée et les mêmes filtres.

### Résultat

| Champ | Type | Description |
| - | - | - |
| `id` | string | Identifiant du prompt |
| `text` | string | Le texte du prompt |
| `type` | string | Étape du tunnel : `TOFU`, `MOFU`, `BOFU` ou `POST_PURCHASE` |
| `topic` | object | Topic rattaché (`id`, `text`), ou `null` |
| `tags` | array | Identifiants, libellés et couleurs des Tags rattachés |
| `personas` | array | Personas actuellement rattachées au prompt (`id`, `name`, `description`) |
| `modelIds` | string\[] | Identifiants des modèles actuellement configurés sur le prompt |
| `monitoringEnabled` | boolean | Indique si le suivi planifié est activé |
| `frequency` | string | Fréquence de suivi effective |
| `frequencyInherited` | boolean | Indique si la fréquence est héritée de la valeur par défaut de la marque |
| `boostCount` | number | Réponses demandées par modèle et par exécution |
| `status` | string | Statut de traitement |
| `lastGenerationDate` | string | Date de la dernière génération de réponses |
| `answersCount` | number | Réponses sur la période et avec les filtres sélectionnés |

### Exemple de sortie

```markdown theme={null}
## Monitored Prompts

Showing 3 of 156 prompts

### 1. "best project management software 2025"
   - ID: prompt-abc-123
   - Status: COMPLETED
   - Type: TOFU
   - Topic: Project Management (ID: topic-123)
   - Tags: Priority (ID: tag-456)
   - Monitoring: enabled, weekly (brand default), boost ×2
   - Answers: 48
   - Last checked: 2025-01-28

### 2. "Acme Corp vs Northstar Work"
   - ID: prompt-def-456
   - Status: COMPLETED
   - Type: BOFU
   - Answers: 32
   - Last checked: 2025-01-28

### 3. "how to improve team productivity"
   - ID: prompt-ghi-789
   - Status: COMPLETED
   - Type: TOFU
   - Answers: 56
   - Last checked: 2025-01-27
```

### Exemples de prompts

```text theme={null}
Quels prompts est-ce que je suis ?
```

```text theme={null}
Montre-moi mes requêtes BOFU
```

```text theme={null}
Liste les prompts qui ont le Tag « pricing »
```

### Scope OAuth

Requis : `read:prompts`

***

## get\_prompt\_answers

Obtient les réponses IA d’un prompt suivi sur l’ensemble des fournisseurs, des plus récentes aux plus anciennes.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `promptId` | string | Oui | L’UUID du prompt issu de `get_prompts` |
| `limit` | integer | Non | Nombre maximal de réponses, de 1 à 100 (par défaut : 20) |

### Résultat

| Champ | Type | Description |
| - | - | - |
| `id` | string | Identifiant de la réponse |
| `text` | string | Aperçu de la réponse (500 premiers caractères) |
| `provider` | string | Nom du fournisseur IA |
| `modelId` | string | Modèle précis utilisé |
| `createdAt` | string | Date de la réponse |
| `sentiment` | number | Score de sentiment (si la marque est mentionnée) |
| `brandMentioned` | boolean | Indique si la marque apparaît |
| `persona` | object | Persona enregistrée lors de la génération de la réponse, ou `null` |

### Exemple de sortie

```markdown theme={null}
## AI Responses for: "best project management software 2025"

Found 8 responses

### 1. ChatGPT (GPT-5)
Date: 2025-01-28
Brand mentioned: Yes
Sentiment: 82/100

Preview: "For project management in 2025, several excellent options stand out. **Acme Corp** offers robust features for team collaboration..."

### 2. Perplexity Pro
Date: 2025-01-28
Brand mentioned: No

Preview: "The top project management tools include Northstar Work, TaskHarbor, and Acme Corp. Each offers different collaboration features..."

### 3. Claude (Sonnet)
Date: 2025-01-27
Brand mentioned: Yes
Sentiment: 79/100

Preview: "Based on recent reviews, I'd recommend considering **Acme Corp** for enterprise teams that need..."
```

### Exemples de prompts

```text theme={null}
Comment les fournisseurs IA répondent-ils à « best project management software » ?
```

```text theme={null}
Montre-moi la réponse de ChatGPT à ma requête sur les prix
```

```text theme={null}
Compare les réponses des différentes IA à ce prompt
```

### Scope OAuth

Requis : `read:prompts`

***

## get\_answers

Parcourt les réponses IA du périmètre d’analyse sélectionné, des plus récentes aux plus anciennes. Utilisez `get_answer_details` pour le texte complet d’une réponse.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `personaIds` | string\[] | Non | UUID des Personas enregistrées sur la réponse ; `"default"` correspond aux réponses générées sans Persona |
| `countries` | string\[] | Non | Pays des réponses (codes ISO 3166-1 alpha-2, 50 au maximum) |
| `limit` | number | Non | Nombre maximal de réponses (par défaut : 50) |
| `offset` | number | Non | Décalage de pagination (par défaut : 0) |

### Résultat

| Champ | Type | Description |
| - | - | - |
| `id` | string | Identifiant de la réponse |
| `promptText` | string | Le prompt posé |
| `provider` | string | Nom du fournisseur IA |
| `createdAt` | string | Date de la réponse |
| `status` | string | Statut de traitement : `PROCESSING`, `COMPLETED` ou `PARTIAL_ERROR` |
| `brandMentioned` | boolean ou null | Indique si la marque apparaît ; `null` tant que l’analyse n’est pas terminée |
| `sourceCited` | boolean ou null | Indique si le domaine de la marque est cité ; `null` tant que l’analyse n’est pas terminée |
| `persona` | object | Persona enregistrée lors de la génération de la réponse, ou `null` |

### Exemple de sortie

```markdown theme={null}
## AI responses

Showing 10 of 2,340 responses

| Date | Provider | Prompt | Brand | Source |
|------|----------|--------|-------|--------|
| 2025-01-28 | ChatGPT | best project management so... | Yes | Yes |
| 2025-01-28 | Perplexity | top collaboration tools | No | No |
| 2025-01-28 | Claude | Acme Corp review | Yes | Yes |
| 2025-01-27 | Gemini | workflow automation soft... | Yes | No |
```

### Exemples de prompts

```text theme={null}
Montre-moi les réponses de cette semaine
```

```text theme={null}
Trouve les réponses où ma marque est mentionnée
```

```text theme={null}
Liste les réponses de Perplexity en janvier
```

### Scope OAuth

Requis : `read:answers`

***

## get\_answer\_details

Obtient le détail complet d’une réponse IA : texte, concurrents et sources.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque |
| `answerId` | string | Oui | L’identifiant de la réponse (issu d’autres outils) |

### Résultat

| Section | Description |
| - | - |
| Réponse | Texte complet, fournisseur, modèle, date et Persona enregistrée sur la réponse |
| Prompt | Texte et type du prompt d’origine |
| Concurrents | Toutes les marques mentionnées, avec position et sentiment |
| Sources | Toutes les URL citées, avec domaine et position |
| Enrichissement | Topic, mots-clés, résumé et type de réponse extraits par l’IA |

### Exemple de sortie

```markdown theme={null}
## AI response details

**Prompt:** "best project management software 2025"
**Provider:** ChatGPT (GPT-5)
**Date:** 2025-01-28

### Response
For project management in 2025, several options stand out. **Acme Corp** offers team collaboration features including real-time editing, Gantt charts, and automated workflows. Other contenders in this synthetic sample include Northstar Work for visual project tracking and TaskHarbor for task management...

### Analysis
- Topic: Project Management Software
- Type: Comparison
- Keywords: project management, collaboration, Gantt charts, workflows

**Summary:** Comparison of project management tools highlighting Acme Corp's collaboration features.

### Competitors mentioned
1. **Northstar Work** #1 - DIRECT (sentiment: 78/100)
2. **Acme Corp** #2 - SELF (sentiment: 82/100)
3. **TaskHarbor** #3 - DIRECT (sentiment: 75/100)

### Sources cited
1. reviews.example (#1)
   https://reviews.example/project-management
2. acme.example [YOUR SITE] (#2)
   https://www.acme.example/features
3. software-guide.example (#3)
   https://software-guide.example/project-management
```

### Exemples de prompts

```text theme={null}
Montre-moi tout le détail de cette réponse
```

```text theme={null}
Quelles sources ont été citées dans cette réponse de ChatGPT ?
```

```text theme={null}
Qui a été mentionné dans cette réponse ?
```

### Scope OAuth

Requis : `read:answers`


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