diff --git a/ai/markdown-export.mdx b/ai/markdown-export.mdx index 7d284da7b..6847746d5 100644 --- a/ai/markdown-export.mdx +++ b/ai/markdown-export.mdx @@ -24,6 +24,29 @@ Send a request with `Accept: text/markdown` or `Accept: text/plain` to any page curl -L -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export ``` +## Automatic detection for AI agents + +Mintlify automatically returns the Markdown version of a page when the request comes from a known AI agent, even if the agent does not send an `Accept: text/markdown` header. This ensures agents receive the most efficient content format without any extra configuration. + +Detection is based on the `User-Agent` header. The following agents are currently recognized: + +- `Claude-User` (Anthropic Claude Code and browsing) +- `ChatGPT-User` (OpenAI ChatGPT browsing) +- `OAI-SearchBot` (OpenAI search) +- `PerplexityBot` and `Perplexity-User` (Perplexity AI) +- `Google-Agent` (Google Project Mariner) +- `MistralAI-User` (Mistral Le Chat) +- `DuckAssistBot` (DuckDuckGo AI Answers) +- `cohere-ai` (Cohere AI assistant) + +For example, a request with a recognized agent user-agent receives Markdown: + +```bash +curl -L -H "User-Agent: Claude-User/1.0" https://mintlify.com/docs/ai/markdown-export +``` + +Human visitors using standard browsers continue to receive the HTML version of the page. + ## Audience-specific content Use the [visibility](/components/visibility) component to customize content for each human and AI audiences. diff --git a/es/ai/markdown-export.mdx b/es/ai/markdown-export.mdx index e067a1881..86e26573c 100644 --- a/es/ai/markdown-export.mdx +++ b/es/ai/markdown-export.mdx @@ -29,6 +29,31 @@ Envía una solicitud con `Accept: text/markdown` o `Accept: text/plain` a la URL curl -L -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export ``` +
+ ## Detección automática para agentes de IA +
+ +Mintlify devuelve automáticamente la versión en Markdown de una página cuando la solicitud proviene de un agente de IA conocido, incluso si el agente no envía un encabezado `Accept: text/markdown`. Esto garantiza que los agentes reciban el formato de contenido más eficiente sin configuración adicional. + +La detección se basa en el encabezado `User-Agent`. Actualmente se reconocen los siguientes agentes: + +- `Claude-User` (Anthropic Claude Code y navegación) +- `ChatGPT-User` (navegación de ChatGPT de OpenAI) +- `OAI-SearchBot` (búsqueda de OpenAI) +- `PerplexityBot` y `Perplexity-User` (Perplexity AI) +- `Google-Agent` (Google Project Mariner) +- `MistralAI-User` (Mistral Le Chat) +- `DuckAssistBot` (DuckDuckGo AI Answers) +- `cohere-ai` (asistente de IA de Cohere) + +Por ejemplo, una solicitud con un user-agent de un agente reconocido recibe Markdown: + +```bash +curl -L -H "User-Agent: Claude-User/1.0" https://mintlify.com/docs/ai/markdown-export +``` + +Los visitantes humanos que usan navegadores estándar siguen recibiendo la versión HTML de la página. +
## Contenido específico por audiencia
diff --git a/fr/ai/markdown-export.mdx b/fr/ai/markdown-export.mdx index dfa4672b1..181c4425b 100644 --- a/fr/ai/markdown-export.mdx +++ b/fr/ai/markdown-export.mdx @@ -29,6 +29,31 @@ Envoyez une requête avec `Accept: text/markdown` ou `Accept: text/plain` à l'U curl -L -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export ``` +
+ ## Détection automatique des agents d'IA +
+ +Mintlify renvoie automatiquement la version Markdown d'une page lorsque la requête provient d'un agent d'IA connu, même si l'agent n'envoie pas d'en-tête `Accept: text/markdown`. Cela garantit que les agents reçoivent le format de contenu le plus efficace sans configuration supplémentaire. + +La détection repose sur l'en-tête `User-Agent`. Les agents suivants sont actuellement reconnus : + +- `Claude-User` (Anthropic Claude Code et navigation) +- `ChatGPT-User` (navigation ChatGPT d'OpenAI) +- `OAI-SearchBot` (recherche OpenAI) +- `PerplexityBot` et `Perplexity-User` (Perplexity AI) +- `Google-Agent` (Google Project Mariner) +- `MistralAI-User` (Mistral Le Chat) +- `DuckAssistBot` (DuckDuckGo AI Answers) +- `cohere-ai` (assistant IA de Cohere) + +Par exemple, une requête avec un user-agent reconnu reçoit du Markdown : + +```bash +curl -L -H "User-Agent: Claude-User/1.0" https://mintlify.com/docs/ai/markdown-export +``` + +Les visiteurs humains utilisant des navigateurs standards continuent de recevoir la version HTML de la page. +
## Contenu spécifique par audience