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

# Commentaires

> Surveillez la satisfaction des utilisateurs avec des widgets de feedback intégrés, des évaluations de pages et des réactions pouce haut ou bas.

<Info>
  Pour collecter et consulter les commentaires, vous devez activer la collecte de commentaires depuis la page [Modules complémentaires](https://dashboard.mintlify.com/products/addons) de votre Dashboard.
</Info>

L’onglet [Feedback](https://dashboard.mintlify.com/products/analytics/v2/feedback) affiche le nombre de votes positifs (pouce levé) et négatifs (pouce baissé) que votre documentation a reçus, ainsi que tous les commentaires qualitatifs fournis par les utilisateurs. Utilisez ces informations pour évaluer la qualité de votre documentation et l’améliorer.

Consultez les commentaires sur la page Analytics de votre Dashboard.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/adminroletesting-justin-client-exports/EkKs8Jdk6h9M5TkU/images/analytics/feedback-light.png?fit=max&auto=format&n=EkKs8Jdk6h9M5TkU&q=85&s=2bac4106346e85c8d313bd2ff646d213" alt="Onglet Feedback sur la page Analytics." width="1846" height="1210" data-path="images/analytics/feedback-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/adminroletesting-justin-client-exports/EkKs8Jdk6h9M5TkU/images/analytics/feedback-dark.png?fit=max&auto=format&n=EkKs8Jdk6h9M5TkU&q=85&s=25c8b5df0cf97b649e2714d387f8aa4b" alt="Onglet Feedback sur la page Analytics." width="1848" height="1210" data-path="images/analytics/feedback-dark.png" />
</Frame>

<div id="feedback-types">
  ## Types de feedback
</div>

<Note>
  Les feedbacks contextuels et sur les extraits de code sont en bêta. Pour les activer sur votre site de documentation, [contactez notre équipe commerciale](mailto:gtm@mintlify.com).
</Note>

L'onglet Feedback affiche des informations en fonction des [modules complémentaires de feedback](https://dashboard.mintlify.com/products/addons) que vous activez.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/adminroletesting-justin-client-exports/EkKs8Jdk6h9M5TkU/images/analytics/feedback-addons-light.png?fit=max&auto=format&n=EkKs8Jdk6h9M5TkU&q=85&s=fc82f001c92421acb6774e76bd8abc78" alt="Commandes de feedback dans la page Modules complémentaires." width="1858" height="1280" data-path="images/analytics/feedback-addons-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/adminroletesting-justin-client-exports/EkKs8Jdk6h9M5TkU/images/analytics/feedback-addons-dark.png?fit=max&auto=format&n=EkKs8Jdk6h9M5TkU&q=85&s=79caee3b877a472c351ff6f0cb7006ae" alt="Commandes de feedback dans la page Modules complémentaires." width="1860" height="1280" data-path="images/analytics/feedback-addons-dark.png" />
</Frame>

* **Évaluation par pouces** : système simple de vote pouce levé/pouce baissé pour mesurer la satisfaction globale vis-à-vis des pages.
* **Suggestions de modification** : permettez aux utilisateurs de proposer des modifications à votre documentation. Disponible uniquement pour les dépôts GitHub publics.
* **Création d’issues** : permettez aux utilisateurs de créer des issues GitHub directement depuis votre documentation. Disponible uniquement pour les dépôts GitHub publics.
* **Feedback contextuel** : retour libre sur le contenu d’une page.
* **Feedback sur les extraits de code** : retour spécifiquement sur les extraits de code.
* **Retours des agents** : retours soumis par des agents IA tiers qui accèdent à votre documentation.

<div id="collect-email-addresses">
  ## Collecte d’adresses e-mail
</div>

Activez la collecte d’e-mails pour que les utilisateurs puissent fournir leur adresse e-mail de manière facultative lors de l’envoi de feedback.

1. Accédez à la page [Add-ons](https://dashboard.mintlify.com/products/addons) de votre dashboard.
2. Activez l’option **Collect reader emails** dans les paramètres de feedback.
3. Ajoutez éventuellement une mention de confidentialité expliquant comment votre équipe utilise les e-mails collectés.

Consultez les adresses e-mail envoyées avec le feedback dans le [dashboard de feedback](https://dashboard.mintlify.com/products/analytics/v2/feedback) aux côtés du contenu du feedback.

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

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

Pour les retours contextuels et ceux portant sur des extraits de code, vous pouvez définir le statut d’un retour et ajouter des notes internes afin de suivre l’avancement du traitement des retours des utilisateurs.

<div id="change-feedback-status">
  ### Modifier le statut des retours
</div>

Sélectionnez le statut à côté d’un retour pour le marquer comme **En attente**, **En cours**, **Résolu** ou **Ignoré**.

Bonnes pratiques pour définir les statuts des retours :

* **En attente** : le retour est en attente d’examen.
* **En cours** : le travail est en cours pour traiter le retour.
* **Résolu** : le retour a été résolu.
* **Ignoré** : le retour est non pertinent ou inexact.

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

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

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

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

* **Ratings by page** : consultez les pages qui reçoivent 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 pour identifier des améliorations ciblées sur des pages spécifiques. Detailed feedback n'affiche que les retours comportant des informations supplémentaires. Les soumissions qui utilisent uniquement la note pouce levé ou pouce baissé sans sélectionner d'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 pour identifier des améliorations ciblées sur des blocs de code spécifiques.

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

Cliquez sur un retour pour y ajouter une note interne. Ces notes sont uniquement visibles par les personnes ayant accès à votre Dashboard.

Utilisez les notes pour ajouter des informations afin de faciliter la collaboration, associer des tickets de support ou d’ingénierie pertinents, ou conserver toute autre information utile.

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

<Note>
  Les retours des agents sont en bêta et susceptibles de changer.
</Note>

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

Ces retours apparaissent dans le [dashboard de feedback](https://dashboard.mintlify.com/products/analytics/v2/feedback) identifiés par un badge **Agent**. Gérez les retours des agents de la même manière que les retours humains. Définissez des statuts, ajoutez des notes internes et filtrez les retours.

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

Vous devez activer les retours des agents dans votre dashboard pour les collecter.

Une fois activé, Mintlify ajoute un bloc `<AgentInstructions>` contenant les instructions et l'endpoint pour soumettre des retours lorsqu'un agent récupère une page via l'export Markdown.

Les agents envoient des retours à l'endpoint avec le chemin de la page et le texte du retour. Les retours apparaissent dans le dashboard aux côtés des retours humains.

L'endpoint de retours est toujours disponible à l'adresse `https://votre-domaine.com/feedback` en tant que requête `POST`, même si vous n'ajoutez pas les instructions à l'export Markdown. Vous pouvez donc inviter les agents à soumettre des retours manuellement en envoyant une requête à l'endpoint.

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

1. Accédez à la page [Add-ons](https://dashboard.mintlify.com/products/addons) de votre dashboard.
2. Activez l'option **Agent feedback**.

   <Frame>
     <img className="block dark:hidden" src="https://mintcdn.com/adminroletesting-justin-client-exports/EkKs8Jdk6h9M5TkU/images/analytics/agent-feedback-light.png?fit=max&auto=format&n=EkKs8Jdk6h9M5TkU&q=85&s=ea01ea550a88f1f6f1348414cb913a37" alt="Option des retours des agents dans la page Add-ons." width="2162" height="223" data-path="images/analytics/agent-feedback-light.png" />

     <img className="hidden dark:block" src="https://mintcdn.com/adminroletesting-justin-client-exports/EkKs8Jdk6h9M5TkU/images/analytics/agent-feedback-dark.png?fit=max&auto=format&n=EkKs8Jdk6h9M5TkU&q=85&s=aa13996da6dd136e00d4b117fa288f69" alt="Option des retours des agents dans la page Add-ons." width="2162" height="223" data-path="images/analytics/agent-feedback-dark.png" />
   </Frame>

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

Utilisez l'[endpoint de feedback analytics](/fr/api/analytics/feedback) pour récupérer les retours des agents de manière programmatique. Filtrez par `source=agent` pour ne retourner que les retours des agents.

Les réponses de retours des agents incluent :

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

<div id="use-feedback-data">
  ## Utiliser les données de feedback
</div>

Analysez vos données de feedback pour :

* **Identifier les contenus les plus efficaces** : les pages qui reçoivent le plus de retours positifs montrent ce qui fonctionne bien dans votre documentation.
* **Prioriser les améliorations** : les pages qui reçoivent le plus de retours négatifs indiquent quels contenus pourraient nécessiter une attention particulière.
* **Passer à l'action** : mettez à jour votre documentation en vous appuyant sur les retours directs des utilisateurs.