Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 0 additions & 8 deletions ai/markdown-export.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -52,14 +52,6 @@ If you prefer to omit the spec from Markdown output, set `markdown.schema` to `f
}
```

## Agent feedback

If you enable [agent feedback](/optimize/feedback#agent-feedback), Mintlify appends an `<AgentInstructions>` block to each page's Markdown export that tells agents how to submit feedback about the page's content.

Agents submit feedback by posting to the endpoint with the page path and feedback text.

Use agent feedback to improve your pages for agents based on what they find incorrect, outdated, or confusing.

## Keyboard shortcut

Press <kbd>Command</kbd> + <kbd>C</kbd> (<kbd>Ctrl</kbd> + <kbd>C</kbd> on Windows) to copy a page as Markdown to your clipboard.
2 changes: 1 addition & 1 deletion api/analytics/feedback-by-page.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,6 @@ Use this endpoint to export user feedback aggregated by documentation page path.

Filter feedback by:
- **Date range**: Use `dateFrom` and `dateTo` to limit results to a specific time period
- **Source**: Filter by `code_snippet`, `contextual`, or `agent` feedback types
- **Source**: Filter by `code_snippet` or `contextual` feedback types
- **Status**: Filter by status values like `pending`, `in_progress`, `resolved`, or `dismissed`

5 changes: 2 additions & 3 deletions api/analytics/feedback.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,15 @@ keywords: ["analytics", "feedback", "export", "user feedback"]

## Usage

Use this endpoint to export user feedback collected from your documentation. Feedback includes contextual feedback from page ratings, code snippet feedback, and agent feedback.
Use this endpoint to export user feedback collected from your documentation. Feedback includes contextual feedback from page ratings and code snippet feedback.

Paginate through results using the `cursor` parameter returned in the response. Continue fetching while `hasMore` is `true`.

## Filtering

Filter feedback by:
- **Date range**: Use `dateFrom` and `dateTo` to limit results to a specific time period
- **Source**: Filter by `code_snippet`, `contextual`, or `agent` feedback types
- **Source**: Filter by `code_snippet` or `contextual` feedback types
- **Status**: Filter by status values like `pending`, `in_progress`, `resolved`, or `dismissed`

## Response types
Expand All @@ -24,4 +24,3 @@ The response contains different feedback types based on the source:

- **Contextual feedback**: Includes `helpful` boolean and optional `contact` email
- **Code snippet feedback**: Includes `code`, `filename`, and `lang` fields
- **Agent feedback**: Includes a `comment` with the agent's feedback text and the `path` of the page it relates to
6 changes: 1 addition & 5 deletions changelog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -143,16 +143,12 @@ noindex: true

</Update>

<Update label="April 17, 2026" tags={["New releases", "Improvements"]} rss={{ title: "Visibility component, MCP filesystem access, agent feedback, Git setup wizard, and more" }}>
<Update label="April 17, 2026" tags={["New releases", "Improvements"]} rss={{ title: "Visibility component, MCP filesystem access, Git setup wizard, and more" }}>

## Visibility component

The new [`Visibility`](/components/visibility) component lets you show different content to human readers and AI agents on the same page. Wrap content in `<Visibility for="humans">` to display it only on the web version of a page or `<Visibility for="agents">` to include it only in [Markdown output](/ai/markdown-export) consumed by AI tools. Useful for tailoring instructions, examples, or formatting to each audience without maintaining separate pages.

## Agent feedback

Enable [agent feedback](/optimize/feedback#agent-feedback) in your deployment settings to let agents submit structured feedback about your documentation. When turned on, Markdown versions of your pages include feedback instructions so agents know how to report any issues they encounter accessing your documentation. Available as a beta feature in the dashboard under deployment add-ons.

## MCP filesystem access

[MCP servers](/ai/model-context-protocol) now include a query docs filesystem tool that lets agents browse and read your documentation's file structure directly. Agents can navigate directories, read full page content, and batch-read multiple pages in a single call. This tool replaces the `get_page` tool.
Expand Down
10 changes: 0 additions & 10 deletions es/ai/markdown-export.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -61,16 +61,6 @@ Si prefieres omitir la especificación de la salida en Markdown, establece `mark
}
```

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

Si habilitas los [comentarios de agentes](/es/optimize/feedback#agent-feedback), Mintlify añade un bloque `<AgentInstructions>` a la exportación Markdown de cada página que indica a los agentes cómo enviar comentarios sobre el contenido de la página.

Los agentes envían comentarios publicando en el endpoint con la ruta de la página y el texto del comentario.

Usa los comentarios de agentes para mejorar tus páginas para agentes en función de lo que encuentren incorrecto, desactualizado o confuso.

<div id="keyboard-shortcut">
## Atajo de teclado
</div>
Expand Down
2 changes: 1 addition & 1 deletion es/api/analytics/feedback-by-page.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,5 +18,5 @@ Usa este endpoint para exportar los comentarios de los usuarios agregados por ru
Filtra los comentarios por:

- **Rango de fechas**: Utiliza `dateFrom` y `dateTo` para limitar los resultados a un período de tiempo específico
- **Fuente**: Filtra por tipos de feedback `code_snippet`, `contextual` o `agent`
- **Fuente**: Filtra por tipos de feedback `code_snippet` o `contextual`
- **Estado**: Filtra por valores de estado como `pending`, `in_progress`, `resolved` o `dismissed`
7 changes: 3 additions & 4 deletions es/api/analytics/feedback.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ keywords: [ "Analytics", "feedback", "exportación", "comentarios de los usuario
## Uso
</div>

Usa este endpoint para exportar los comentarios de los usuarios recopilados desde tu documentación. Los comentarios incluyen comentarios contextuales de las calificaciones de las páginas, comentarios sobre fragmentos de código y comentarios de agentes.
Usa este endpoint para exportar los comentarios de los usuarios recopilados desde tu documentación. Los comentarios incluyen comentarios contextuales de las calificaciones de las páginas y comentarios sobre fragmentos de código.

Pagina los resultados usando el parámetro `cursor` devuelto en la respuesta. Continúa obteniendo resultados mientras `hasMore` sea `true`.

Expand All @@ -22,7 +22,7 @@ Pagina los resultados usando el parámetro `cursor` devuelto en la respuesta. Co
Filtra los comentarios por:

- **Rango de fechas**: Utiliza `dateFrom` y `dateTo` para limitar los resultados a un período de tiempo específico
- **Fuente**: Filtra por tipos de feedback `code_snippet`, `contextual` o `agent`
- **Fuente**: Filtra por tipos de feedback `code_snippet` o `contextual`
- **Estado**: Filtra por valores de estado como `pending`, `in_progress`, `resolved` o `dismissed`

<div id="response-types">
Expand All @@ -32,5 +32,4 @@ Filtra los comentarios por:
La respuesta contiene diferentes tipos de comentarios según la fuente:

- **Comentarios contextuales**: Incluyen el valor booleano `helpful` y un correo electrónico opcional en `contact`
- **Comentarios sobre fragmentos de código**: Incluyen los campos `code`, `filename` y `lang`
- **Comentarios de agentes**: Incluyen un `comment` con el texto del comentario del agente y el `path` de la página a la que se refiere
- **Comentarios sobre fragmentos de código**: Incluyen los campos `code`, `filename` y `lang`
8 changes: 1 addition & 7 deletions es/changelog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -73,20 +73,14 @@ noindex: true

</Update>

<Update label="April 17, 2026" tags={["New releases", "Improvements"]} rss={{ title: "Componente Visibility, acceso al sistema de archivos MCP, feedback de agentes, asistente de configuración Git y más" }}>
<Update label="April 17, 2026" tags={["New releases", "Improvements"]} rss={{ title: "Componente Visibility, acceso al sistema de archivos MCP, asistente de configuración Git y más" }}>

<div id="visibility-component">
## Componente Visibility
</div>

El nuevo componente [`Visibility`](/es/components/visibility) te permite mostrar contenido diferente a lectores humanos y agentes de IA en la misma página. Envuelve contenido en `<Visibility for="humans">` para mostrarlo solo en la versión web de una página o `<Visibility for="agents">` para incluirlo solo en la [salida Markdown](/es/ai/markdown-export) consumida por herramientas de IA. Útil para adaptar instrucciones, ejemplos o formato a cada audiencia sin mantener páginas separadas.

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

Activa el [feedback de agentes](/es/optimize/feedback#agent-feedback) en la configuración de tu despliegue para permitir que los agentes envíen feedback estructurado sobre tu documentación. Cuando está activado, las versiones Markdown de tus páginas incluyen instrucciones de feedback para que los agentes sepan cómo reportar cualquier problema que encuentren al acceder a tu documentación. Disponible como función beta en el dashboard en complementos de despliegue.

<div id="mcp-filesystem-access">
## Acceso al sistema de archivos MCP
</div>
Expand Down
54 changes: 0 additions & 54 deletions es/optimize/feedback.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -108,60 +108,6 @@ Haz clic en un elemento de feedback para añadir una nota interna. Estas notas s

Usa las notas para añadir información para colaborar, vincular tickets relevantes de soporte o de 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 versión beta y sujetos a cambios.
</Note>

Cuando agentes de IA de terceros acceden a tu documentación, pueden enviar comentarios estructurados sobre páginas que encuentran incorrectas, desactualizadas o difíciles de usar.

Estos comentarios aparecen en el [dashboard de comentarios](https://dashboard.mintlify.com/products/analytics/v2/feedback) identificados con una etiqueta **Agent**. Gestiona los comentarios de agentes de la misma forma que los comentarios humanos. Establece estados, añade notas internas y filtra los comentarios.

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

Debes habilitar los comentarios de agentes en tu dashboard para recopilarlos.

Una vez habilitados, Mintlify añade un bloque `<AgentInstructions>` con instrucciones y el endpoint para enviar comentarios cuando un agente obtiene una página mediante la exportación Markdown.

Los agentes envían comentarios al endpoint con la ruta de la página y el texto del comentario. Los comentarios aparecen en el dashboard junto a los comentarios humanos.

El endpoint de comentarios siempre está disponible en `https://tu-dominio.com/feedback` como una solicitud `POST`, incluso si no añades las instrucciones a la exportación Markdown, por lo que puedes indicar a los agentes que envíen comentarios manualmente publicando en el endpoint.

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


1. Ve a la página de [Add-ons](https://dashboard.mintlify.com/products/addons) en tu dashboard.
2. Habilita la opción **Agent feedback**.
<Frame>
<img
className="block dark:hidden"
src="/images/analytics/agent-feedback-light.png"
alt="Opción de comentarios de agentes en la página de Add-ons."
/>
<img
className="hidden dark:block"
src="/images/analytics/agent-feedback-dark.png"
alt="Opción de comentarios de agentes en la página de Add-ons."
/>
</Frame>

<div id="retrieve-agent-feedback-via-api">
### Recuperar comentarios de agentes por API
</div>

Usa el [endpoint de feedback de analytics](/es/api/analytics/feedback) para recuperar comentarios de agentes de forma programática. Filtra por `source=agent` para obtener solo 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 a la que se refiere el comentario.

<div id="use-feedback-data">
## Usa los datos de feedback
</div>
Expand Down
10 changes: 0 additions & 10 deletions fr/ai/markdown-export.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -61,16 +61,6 @@ Si vous préférez omettre la spécification de la sortie Markdown, définissez
}
```

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

Si vous activez les [retours des agents](/fr/optimize/feedback#agent-feedback), Mintlify ajoute un bloc `<AgentInstructions>` à l'export Markdown de chaque page indiquant aux agents comment soumettre des retours sur le contenu de la page.

Les agents soumettent des retours en envoyant une requête au endpoint avec le chemin de la page et le texte du retour.

Utilisez les retours des agents pour améliorer vos pages en fonction de ce que les agents trouvent incorrect, obsolète ou confus.

<div id="keyboard-shortcut">
## Raccourci clavier
</div>
Expand Down
2 changes: 1 addition & 1 deletion fr/api/analytics/feedback-by-page.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,5 +18,5 @@ Utilisez cet endpoint pour exporter les retours utilisateurs agrégés par chemi
Filtrez les feedbacks par :

- **Plage de dates** : utilisez `dateFrom` et `dateTo` pour limiter les résultats à une période donnée
- **Source** : filtrez par type de feedback, `code_snippet`, `contextual` ou `agent`
- **Source** : filtrez par type de feedback, `code_snippet` ou `contextual`
- **Statut** : filtrez par des valeurs de statut comme `pending`, `in_progress`, `resolved` ou `dismissed`
5 changes: 2 additions & 3 deletions fr/api/analytics/feedback.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,5 @@ Filtrez les feedbacks par :

La réponse contient différents types de commentaires en fonction de la source :

- **Commentaire contextuel** : inclut le booléen `helpful` et éventuellement l’adresse e-mail `contact`
- **Commentaire sur extrait de code** : inclut les champs `code`, `filename` et `lang`
- **Retour d'agent** : inclut un `comment` avec le texte du retour de l'agent et le `path` de la page concernée
- **Commentaire contextuel** : inclut le booléen `helpful` et éventuellement l’adresse e-mail `contact`
- **Commentaire sur extrait de code** : inclut les champs `code`, `filename` et `lang`
8 changes: 1 addition & 7 deletions fr/changelog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -73,20 +73,14 @@ noindex: true

</Update>

<Update label="17 avril 2026" tags={["Nouvelles versions", "Améliorations"]} rss={{ title: "Composant Visibility, accès au système de fichiers MCP, feedback des agents, assistant de configuration Git et plus encore" }}>
<Update label="17 avril 2026" tags={["Nouvelles versions", "Améliorations"]} rss={{ title: "Composant Visibility, accès au système de fichiers MCP, assistant de configuration Git et plus encore" }}>

<div id="visibility-component">
## Composant Visibility
</div>

Le nouveau composant [`Visibility`](/fr/components/visibility) vous permet d'afficher un contenu différent pour les lecteurs humains et les agents IA sur la même page. Enveloppez le contenu dans `<Visibility for="humans">` pour l'afficher uniquement sur la version web d'une page ou `<Visibility for="agents">` pour l'inclure uniquement dans la [sortie Markdown](/fr/ai/markdown-export) consommée par les outils IA. Utile pour adapter les instructions, les exemples ou le formatage à chaque audience sans maintenir des pages séparées.

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

Activez le [feedback des agents](/fr/optimize/feedback#agent-feedback) dans les paramètres de votre déploiement pour permettre aux agents de soumettre des retours structurés sur votre documentation. Lorsqu'il est activé, les versions Markdown de vos pages incluent des instructions de feedback pour que les agents sachent comment signaler les problèmes qu'ils rencontrent en accédant à votre documentation. Disponible en tant que fonctionnalité bêta dans le tableau de bord sous les modules complémentaires de déploiement.

<div id="mcp-filesystem-access">
## Accès au système de fichiers MCP
</div>
Expand Down
54 changes: 0 additions & 54 deletions fr/optimize/feedback.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -109,60 +109,6 @@ Cliquez sur un retour pour y ajouter une note interne. Ces notes sont uniquement

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="/images/analytics/agent-feedback-light.png"
alt="Option des retours des agents dans la page Add-ons."
/>
<img
className="hidden dark:block"
src="/images/analytics/agent-feedback-dark.png"
alt="Option des retours des agents dans la page Add-ons."
/>
</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>
Expand Down
Loading
Loading