> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-andrew-mintlify-update-jlkd4ke.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Recueillir les retours des utilisateurs et agents IA

> Activez les widgets de retour, notes de page, retours contextuels, réactions sur les extraits de code et retours des agents pour améliorer votre documentation.

<Info>
  Les retours nécessitent un [plan Pro ou Enterprise](https://mintlify.com/pricing?ref=feedback).
</Info>

La section Retours de la page [analytics](https://app.mintlify.com/analytics) affiche les votes quantitatifs pouce en haut et pouce en bas que vos pages reçoivent des utilisateurs, ainsi que tous les retours qualitatifs qu'ils fournissent. Utilisez ces informations pour évaluer la qualité de votre contenu et apporter des améliorations.

Examinez vos données de retour pour :

* **Identifier le contenu qui fonctionne** : les pages ayant le plus de retours positifs montrent ce qui fonctionne bien dans votre documentation.
* **Prioriser les améliorations** : les pages ayant le plus de retours négatifs indiquent quels contenus peuvent nécessiter de l'attention.
* **Passer à l'action** : effectuez des mises à jour de la documentation en fonction des retours directs des utilisateurs.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/mintlify-andrew-mintlify-update-jlkd4ke/PjBTho2pYPDwBYT5/images/analytics/feedback-light.png?fit=max&auto=format&n=PjBTho2pYPDwBYT5&q=85&s=5068cc9e4743ab1720a65183328c35ac" alt="Onglet Retours dans la page Analytique." width="2329" height="663" data-path="images/analytics/feedback-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/mintlify-andrew-mintlify-update-jlkd4ke/PjBTho2pYPDwBYT5/images/analytics/feedback-dark.png?fit=max&auto=format&n=PjBTho2pYPDwBYT5&q=85&s=238e13b40ecfbbe34bb59cfc5e5eaabf" alt="Onglet Retours dans la page Analytique." width="2329" height="663" data-path="images/analytics/feedback-dark.png" />
</Frame>

<div id="enable-feedback">
  ## Activer les retours
</div>

<Note>
  Si vous désactivez la télémétrie dans votre fichier `docs.json`, vous ne pouvez pas activer les fonctionnalités de retour.
</Note>

Pour collecter et consulter les retours des utilisateurs, vous devez les activer depuis la page [Add-ons](https://app.mintlify.com/products/addons) de votre tableau de bord.

1. Rendez-vous sur la page [Add-ons](https://app.mintlify.com/products/addons).
2. Activez les types de retours souhaités.

* **Thumbs rating** : vote simple pouce en haut/en bas pour évaluer la satisfaction globale vis-à-vis des pages.
* **Edit suggestions** : permettez aux utilisateurs de suggérer des modifications à votre documentation. Disponible uniquement pour les dépôts publics.
* **Raise issues** : permettez aux utilisateurs de créer des issues directement depuis votre site. Disponible uniquement pour les dépôts publics.
* **Contextual feedback** : retour en texte libre sur le contenu d'une page. Vous pouvez également activer la collecte d'e-mails pour permettre aux utilisateurs de fournir leur adresse e-mail lors de l'envoi d'un retour.
* **Code snippet feedback** : retour spécifique sur les extraits de code.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/mintlify-andrew-mintlify-update-jlkd4ke/PjBTho2pYPDwBYT5/images/analytics/feedback-addons-light.png?fit=max&auto=format&n=PjBTho2pYPDwBYT5&q=85&s=ab38c688b2e5760ceeccc038c1ef5e15" alt="Interrupteurs de retour dans la page Add-ons." width="1858" height="1280" data-path="images/analytics/feedback-addons-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/mintlify-andrew-mintlify-update-jlkd4ke/PjBTho2pYPDwBYT5/images/analytics/feedback-addons-dark.png?fit=max&auto=format&n=PjBTho2pYPDwBYT5&q=85&s=472487f0e8c9e1e9c84ce1c394e93946" alt="Interrupteurs de retour dans la page Add-ons." width="1860" height="1280" data-path="images/analytics/feedback-addons-dark.png" />
</Frame>

<div id="manage-feedback">
  ## Gérer les retours
</div>

Vous pouvez définir le statut d'un retour et ajouter des notes internes pour suivre votre travail de traitement des retours des utilisateurs.

<div id="change-feedback-status">
  ### Modifier le statut d'un retour
</div>

Sélectionnez le statut à côté d'un retour pour le marquer comme **Pending**, **In Progress**, **Resolved** ou **Dismissed**.

Bonnes pratiques pour définir les statuts des retours :

* **Pending** : le retour est en attente d'examen.
* **In Progress** : un travail est en cours pour traiter le retour.
* **Resolved** : vous avez résolu le retour.
* **Dismissed** : le retour n'est pas pertinent ou est inexact.

<div id="filter-by-status">
  ### Filtrer par statut
</div>

Utilisez le menu **Filters** pour contrôler quels retours s'affichent. Décochez un statut pour masquer tous les retours associés à ce statut. Par défaut, tous les types de retours sont affichés.

<div id="filter-by-type">
  ### Filtrer par type
</div>

Choisissez entre **Ratings by page**, **Detailed feedback** et **Code snippets** selon les informations que vous souhaitez analyser.

* **Ratings by page** : voyez quelles pages ont le plus de retours positifs et négatifs. Utilisez ces données quantitatives pour identifier les pages que les utilisateurs trouvent les plus et les moins utiles.
* **Detailed feedback** : examinez les retours ouverts que les utilisateurs laissent sur les pages afin d'identifier des améliorations ciblées pour certaines pages. Detailed feedback n'affiche que les retours qui incluent des informations supplémentaires. Les soumissions qui utilisent uniquement la note pouce en haut ou pouce en bas sans sélectionner une option de retour supplémentaire n'apparaissent pas dans la vue détaillée.
* **Code snippets** : examinez les retours ouverts que les utilisateurs laissent sur les extraits de code afin d'identifier des améliorations ciblées pour des blocs de code spécifiques.

<div id="add-internal-notes">
  ### Ajouter des notes internes
</div>

Cliquez sur un retour pour ajouter une note interne. Ces notes ne sont visibles que par les personnes ayant accès à votre tableau de bord.

Utilisez les notes pour ajouter des informations de collaboration, lier des tickets de support ou d'ingénierie pertinents, ou pour retenir toute autre information utile.

<div id="agent-feedback">
  ## Retours des agents
</div>

<Note>
  Les retours des agents sont en beta et sujets à modification.
</Note>

Les agents IA tiers peuvent soumettre des retours structurés sur les pages qu'ils trouvent incorrectes, obsolètes ou difficiles à utiliser.

Ces retours apparaissent dans la section **Detailed feedback**, identifiés par un badge **Agent**. Gérez les retours des agents de la même manière que les retours humains.

<div id="how-agent-feedback-works">
  ### Fonctionnement des retours des agents
</div>

Les agents peuvent soumettre des retours de deux façons :

* **Serveur Search MCP** : un agent connecté au [serveur Search MCP](/fr/ai/model-context-protocol) de votre site peut découvrir et appeler l'outil `submit_feedback`. L'outil requiert le chemin de la page et une description du problème.
* **Point de terminaison HTTP** : un agent capable d'effectuer des requêtes `POST` peut envoyer le chemin de la page et le texte du retour directement à `https://your-domain.com/feedback`. Cette méthode ne nécessite pas de connexion MCP.

Par exemple :

```bash theme={null}
curl --request POST \
  --url https://your-domain.com/feedback \
  --header 'Content-Type: application/json' \
  --data '{
    "path": "/quickstart",
    "feedback": "La commande d’installation de cette page est obsolète."
  }'
```

<Note>
  Les outils de recherche et de récupération web ne donnent pas accès à l'outil MCP `submit_feedback`. Un agent qui prend uniquement en charge les requêtes `GET` ne peut pas soumettre de retour. Il doit être connecté à votre serveur Search MCP ou pouvoir effectuer une requête HTTP `POST`.
</Note>

Les deux méthodes enregistrent la soumission comme un retour négatif pour la page spécifiée. Le retour apparaît dans le tableau de bord aux côtés des retours humains.

<div id="retrieve-agent-feedback-via-api">
  ### Récupérer les retours des agents via l'API
</div>

Utilisez le [point de terminaison analytics feedback](/fr/api/analytics/feedback) pour récupérer les retours des agents de manière programmatique. Filtrez avec `source=agent` pour ne renvoyer que les retours des agents.

Les réponses de retour des agents comprennent :

* `comment` : le texte du retour soumis par l'agent.
* `path` : le chemin de la page concernée par le retour.