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

# Recopilar comentarios de usuarios y agentes de IA

> Activa widgets de comentarios, calificaciones de página, notas contextuales, reacciones en fragmentos de código y comentarios de agentes para mejorar tus docs.

<Info>
  Los comentarios requieren un [plan Pro o Enterprise](https://mintlify.com/pricing?ref=feedback).
</Info>

La sección de comentarios de la página de [analíticas](https://app.mintlify.com/analytics) muestra los votos cuantitativos de pulgar arriba y pulgar abajo que reciben tus páginas por parte de los usuarios, así como cualquier comentario cualitativo que proporcionen. Utiliza esta información para evaluar la calidad de tu contenido y realizar mejoras.

Revisa tus datos de comentarios para:

* **Identificar contenido exitoso**: Las páginas con más comentarios positivos muestran qué funciona bien en tu documentación.
* **Priorizar mejoras**: Las páginas con más comentarios negativos indican qué contenido podría necesitar atención.
* **Tomar medidas**: Realiza actualizaciones en la documentación basadas en los comentarios directos de los usuarios.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/mintlify-mintlify-647791c7/WG2bkYANPyKtR7s4/images/analytics/feedback-light.png?fit=max&auto=format&n=WG2bkYANPyKtR7s4&q=85&s=c1fb4dd9a1fc7afc9b332102909fb268" alt="Pestaña de comentarios en la página de analíticas." width="2329" height="663" data-path="images/analytics/feedback-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/mintlify-mintlify-647791c7/WG2bkYANPyKtR7s4/images/analytics/feedback-dark.png?fit=max&auto=format&n=WG2bkYANPyKtR7s4&q=85&s=6365045e302dfa0388d9dd44fbfbae35" alt="Pestaña de comentarios en la página de analíticas." width="2329" height="663" data-path="images/analytics/feedback-dark.png" />
</Frame>

<div id="enable-feedback">
  ## Habilitar comentarios
</div>

<Note>
  Si desactivas la telemetría en tu archivo `docs.json`, no podrás habilitar las funciones de comentarios.
</Note>

Para recopilar y ver los comentarios de los usuarios, debes habilitar los comentarios desde la página [Add-ons](https://app.mintlify.com/products/addons) en tu panel.

1. Navega a la página [Add-ons](https://app.mintlify.com/products/addons).
2. Habilita los tipos de comentarios que desees.

* **Thumbs rating**: Votación simple con pulgar arriba/abajo para evaluar la satisfacción general con las páginas.
* **Edit suggestions**: Permite a los usuarios sugerir modificaciones a tu documentación. Solo disponible para repositorios públicos.
* **Raise issues**: Permite a los usuarios crear issues directamente desde tu sitio. Solo disponible para repositorios públicos.
* **Contextual feedback**: Comentarios de formato libre sobre el contenido de una página. Opcionalmente, habilita la recopilación de correos electrónicos para permitir que los usuarios proporcionen su dirección de correo al enviar comentarios.
* **Code snippet feedback**: Comentarios específicamente sobre fragmentos de código.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/mintlify-mintlify-647791c7/WG2bkYANPyKtR7s4/images/analytics/feedback-addons-light.png?fit=max&auto=format&n=WG2bkYANPyKtR7s4&q=85&s=d5221f9adb7fb8952f60a44b42e488a6" alt="Interruptores de comentarios en la página de Add-ons." width="1858" height="1280" data-path="images/analytics/feedback-addons-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/mintlify-mintlify-647791c7/WG2bkYANPyKtR7s4/images/analytics/feedback-addons-dark.png?fit=max&auto=format&n=WG2bkYANPyKtR7s4&q=85&s=d57abf97e2185ca8fb6be2f881111806" alt="Interruptores de comentarios en la página de Add-ons." width="1860" height="1280" data-path="images/analytics/feedback-addons-dark.png" />
</Frame>

<div id="manage-feedback">
  ## Gestionar comentarios
</div>

Puedes establecer el estado de un comentario y añadir notas internas para realizar un seguimiento de tu trabajo resolviendo los comentarios de los usuarios.

<div id="change-feedback-status">
  ### Cambiar el estado de un comentario
</div>

Selecciona el estado junto a un comentario para marcarlo como **Pending**, **In Progress**, **Resolved** o **Dismissed**.

Mejores prácticas para establecer los estados de los comentarios:

* **Pending**: El comentario está en espera de revisión.
* **In Progress**: Se está trabajando en abordar el comentario.
* **Resolved**: Resolviste el comentario.
* **Dismissed**: El comentario es irrelevante o inexacto.

<div id="filter-by-status">
  ### Filtrar por estado
</div>

Utiliza el menú **Filters** para controlar qué comentarios se muestran. Desmarca un estado para ocultar todos los comentarios con ese estado. De forma predeterminada, se muestran todos los tipos de comentarios.

<div id="filter-by-type">
  ### Filtrar por tipo
</div>

Selecciona entre **Ratings by page**, **Detailed feedback** y **Code snippets** según la información que quieras analizar.

* **Ratings by page**: Ve qué páginas tienen más comentarios positivos y negativos. Utiliza estos datos cuantitativos para identificar las páginas que los usuarios encuentran más y menos útiles.
* **Detailed feedback**: Revisa los comentarios abiertos que los usuarios dejan en las páginas para identificar mejoras específicas para páginas concretas. Los comentarios detallados solo muestran comentarios que incluyen información adicional. Los envíos que utilizan únicamente la calificación de pulgar arriba o pulgar abajo sin seleccionar una opción adicional de comentarios no aparecen en la vista detallada.
* **Code snippets**: Revisa los comentarios abiertos que los usuarios dejan en los fragmentos de código para identificar mejoras específicas para bloques concretos de código.

<div id="add-internal-notes">
  ### Añadir notas internas
</div>

Haz clic en un comentario para añadir una nota interna. Estas notas solo son visibles para las personas con acceso a tu panel.

Utiliza las notas para añadir información para la colaboración, vincular tickets relevantes de soporte o ingeniería, o recordar cualquier otra información útil.

<div id="agent-feedback">
  ## Comentarios de agentes
</div>

<Note>
  Los comentarios de agentes están en beta y sujetos a cambios.
</Note>

Los agentes de IA de terceros pueden enviar comentarios estructurados sobre páginas que consideran incorrectas, desactualizadas o difíciles de usar.

Estos comentarios aparecen en la sección **Detailed feedback** identificados con una insignia **Agent**. Gestiona los comentarios de agentes de la misma manera que los comentarios humanos.

<div id="how-agent-feedback-works">
  ### Cómo funcionan los comentarios de agentes
</div>

Los agentes pueden enviar comentarios de dos maneras:

* **Servidor Search MCP**: Un agente conectado al [servidor Search MCP](/es/ai/model-context-protocol) de tu sitio puede descubrir y llamar a la herramienta `submit_feedback`. La herramienta requiere la ruta de la página y una descripción del problema.
* **Endpoint HTTP**: Un agente con capacidad para realizar solicitudes `POST` puede enviar la ruta de la página y el texto del comentario directamente a `https://your-domain.com/feedback`. Este método no requiere una conexión MCP.

Por ejemplo:

```bash theme={null}
curl --request POST \
  --url https://your-domain.com/feedback \
  --header 'Content-Type: application/json' \
  --data '{
    "path": "/quickstart",
    "feedback": "El comando de instalación de esta página está desactualizado."
  }'
```

<Note>
  Las herramientas de búsqueda y obtención web no proporcionan al agente la herramienta MCP `submit_feedback`. Un agente que solo admite solicitudes `GET` no puede enviar comentarios. Necesita una conexión a tu servidor Search MCP o la capacidad de realizar una solicitud HTTP `POST`.
</Note>

Ambos métodos registran el envío como un comentario no útil para la página especificada. Los comentarios aparecen en el panel junto con los comentarios humanos.

<div id="retrieve-agent-feedback-via-api">
  ### Recuperar los comentarios de agentes vía API
</div>

Utiliza el [endpoint de comentarios de analíticas](/es/api/analytics/feedback) para recuperar los comentarios de agentes de forma programática. Filtra por `source=agent` para devolver únicamente los comentarios de agentes.

Las respuestas de comentarios de agentes incluyen:

* `comment`: El texto del comentario enviado por el agente.
* `path`: La ruta de la página sobre la que trata el comentario.