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
32 changes: 20 additions & 12 deletions es/ai/llmstxt.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,41 +14,49 @@ Mintlify aloja automáticamente un archivo `llms.txt` en la raíz de tu proyecto
Si tu sitio requiere autenticación, `llms.txt` y `llms-full.txt` también requieren autenticación para poder verse. Los LLM y las herramientas de IA que no puedan autenticarse en tu sitio no pueden acceder a estos archivos. Los archivos excluyen las páginas que pertenecen a [grupos de usuarios](/es/deploy/authentication-setup#control-access-with-groups).
</Note>

Consulta tu `llms.txt` añadiendo `/llms.txt` a la URL de tu sitio de documentación.
Consulta tu `llms.txt` añadiendo `/llms.txt` a la URL de tu sitio de documentación. Mintlify también aloja el archivo en `/.well-known/llms.txt` para garantizar la compatibilidad con herramientas que siguen la convención `.well-known`.

<PreviewButton href="https://mintlify.com/docs/llms.txt">Abrir el llms.txt de este sitio.</PreviewButton>

Mintlify añade cabeceras HTTP a cada respuesta de página para que las herramientas de IA puedan descubrir tus archivos `llms.txt` sin conocimiento previo de su ubicación:

- `Link: </llms.txt>; rel="llms-txt", </llms-full.txt>; rel="llms-full-txt"`: Sigue el formato estándar de la cabecera HTTP `Link` para el descubrimiento de recursos.
- `X-Llms-Txt: /llms.txt`: Una cabecera de conveniencia para herramientas que verifican la compatibilidad con `llms.txt`.

<div id="llmstxt-structure">
## Estructura de llms.txt
</div>

Un archivo `llms.txt` es un archivo Markdown sin formato que contiene:

* **Título del sitio** como encabezado H1.
* **Secciones de contenido estructuradas** con enlaces y una descripción de cada página de tu documentación.
* **Enlaces a especificaciones de API** a tus especificaciones OpenAPI y AsyncAPI, si tu documentación las incluye.
- **Título del sitio** como encabezado H1.
- **Secciones de contenido estructuradas** con enlaces y una descripción de cada página de tu documentación.
- **Enlaces a especificaciones de API** a tus especificaciones OpenAPI y AsyncAPI, si tu documentación las incluye.

El archivo `llms.txt` lista tus páginas alfabéticamente en el orden en que aparecen en tu repositorio, comenzando desde el directorio raíz.
El archivo `llms.txt` lista tus páginas alfabéticamente en el orden en que aparecen en tu repositorio, comenzando desde el directorio raíz. Los enlaces de las páginas en el archivo `llms.txt` incluyen una extensión `.md` para que las herramientas de IA puedan obtener directamente la versión en Markdown de cada página.

La descripción de cada página proviene del campo `description` en su frontmatter. Las descripciones se truncan a 300 caracteres y al primer salto de línea. Para las páginas de referencia de API, la descripción también incluye la información de la especificación del campo `openapi` o `api` del frontmatter. Las páginas sin el campo `description` aparecen en el archivo `llms.txt` sin descripción.

Este enfoque estructurado permite a los LLM procesar tu documentación de forma eficiente a un alto nivel y localizar contenido relevante para las consultas de los usuarios, mejorando la precisión y la velocidad de las búsquedas de documentación asistidas por IA.

```mdx Example llms.txt
# Título del sitio

## Documentación

- [API](https://example.com/docs/api): Lista de endpoints y uso
- [Instalar](https://example.com/docs/install): Pasos de configuración
- [Primeros pasos](https://example.com/docs/start): Guía de introducción
- [API](https://example.com/docs/api.md): Lista de endpoints y uso
- [Instalar](https://example.com/docs/install.md): Pasos de configuración
- [Primeros pasos](https://example.com/docs/start.md): Guía de introducción

## Especificaciones de API
## OpenAPI Specs

- [openapi](https://example.com/docs/openapi.json)

## AsyncAPI Specs

- [asyncapi](https://example.com/docs/asyncapi.yaml)
```

Este enfoque estructurado permite a los LLM procesar tu documentación de forma eficiente a un alto nivel y localizar contenido relevante para las consultas de los usuarios, mejorando la precisión y la velocidad de las búsquedas de documentación asistidas por IA.

<div id="llms-fulltxt">
## llms-full.txt
</div>
Expand All @@ -65,4 +73,4 @@ Mintlify aloja automáticamente un archivo `llms-full.txt` en la raíz de tu pro

Para agregar un archivo personalizado `llms.txt` o `llms-full.txt`, crea un archivo `llms.txt` o `llms-full.txt` en la raíz de tu proyecto. Agregar un archivo personalizado reemplazará el archivo generado automáticamente con el mismo nombre. Si eliminas un archivo personalizado, Mintlify restaura el archivo generado automáticamente.

Tu archivo personalizado `llms.txt` o `llms-full.txt` debe incluir el título del sitio como encabezado H1. El resto del contenido es opcional. Consulta [Format](https://llmstxt.org/#format) en la especificación de `llms.txt` para obtener más información sobre secciones opcionales y buenas prácticas.
Tu archivo personalizado `llms.txt` o `llms-full.txt` debe incluir el título del sitio como encabezado H1. El resto del contenido es opcional. Consulta [Format](https://llmstxt.org/#format) en la especificación de `llms.txt` para obtener más información sobre secciones opcionales y buenas prácticas.
13 changes: 11 additions & 2 deletions es/ai/markdown-export.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,6 @@ Markdown proporciona texto estructurado que las herramientas de IA pueden proces

Mintlify genera automáticamente versiones en Markdown de las páginas, optimizadas para herramientas de IA e integraciones externas.


<div id="md-url-extension">
## Extensión de URL .md
</div>
Expand All @@ -19,8 +18,18 @@ Añade `.md` a la URL de cualquier página para ver una versión en Markdown.

<PreviewButton href="https://mintlify.com/docs/ai/markdown-export.md">Abrir esta página como Markdown</PreviewButton>

<div id="accept-header">
## Cabecera Accept
</div>

Envía una solicitud con `Accept: text/markdown` o `Accept: text/plain` a cualquier URL de página para recibir la versión en Markdown en lugar de HTML. Esto es útil para herramientas de IA e integraciones que obtienen contenido de documentación de forma programática.

```bash
curl -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export
```

<div id="keyboard-shortcut">
## Atajo de teclado
</div>

Pulsa <kbd>Command</kbd> + <kbd>C</kbd> (<kbd>Ctrl</kbd> + <kbd>C</kbd> en Windows) para copiar una página en Markdown al portapapeles.
Pulsa <kbd>Command</kbd> + <kbd>C</kbd> (<kbd>Ctrl</kbd> + <kbd>C</kbd> en Windows) para copiar una página en Markdown al portapapeles.
34 changes: 33 additions & 1 deletion es/ai/skillmd.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ Consulta tu `skill.md` añadiendo `/skill.md` a la URL de tu sitio de documentac
</div>

<Note>
Si utilizas un [proxy inverso](/es/deploy/reverse-proxy), configúralo para reenviar las rutas `/skill.md` y `/.well-known/skills/*` (con el almacenamiento en caché deshabilitado) a tu subdominio de Mintlify.
Si utilizas un [proxy inverso](/es/deploy/reverse-proxy), configúralo para reenviar las rutas `/skill.md` y `/.well-known/skills/*` a tu subdominio de Mintlify.
</Note>

Los agentes pueden procesar tu archivo `skill.md` con la [CLI de skills](https://www.npmjs.com/package/skills).
Expand Down Expand Up @@ -88,3 +88,35 @@ metadata:
version: "1.0"
---
```

<div id="skills-discovery-endpoints">
## Endpoints de descubrimiento de skills
</div>

Mintlify aloja un directorio de skills en `/.well-known/skills/` que los agentes pueden usar para descubrir y obtener tus archivos de skills de forma programática.

<div id="skills-index">
### Índice de skills
</div>

`GET /.well-known/skills/index.json` devuelve un manifiesto JSON que lista todas las skills disponibles:

```json
{
"skills": [
{
"name": "my-product",
"description": "A brief description of what your skill does.",
"files": ["SKILL.md"]
}
]
}
```

El campo `name` es un slug compatible con URLs derivado del campo `name` en el frontmatter de tu `skill.md`.

<div id="individual-skill-files">
### Archivos de skill individuales
</div>

`GET /.well-known/skills/{name}/skill.md` devuelve el archivo `skill.md` de una skill específica identificada por su nombre convertido a slug desde el índice.
2 changes: 1 addition & 1 deletion es/api/assistant/create-assistant-message-v2.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ keywords:
---

<Info>
El endpoint de mensaje de assistant v2 es compatible con **AI SDK v5 o superior**. Si usas AI SDK v4, utiliza en su lugar el [endpoint de mensaje de assistant v1](/es/api-reference/assistant/create-assistant-message).
El endpoint de mensaje de assistant v2 es compatible con **AI SDK v5 o superior**. Si usas AI SDK v4, utiliza en su lugar el [endpoint de mensaje de assistant v1](/es/api/assistant/create-assistant-message).
</Info>

<div id="integration-with-usechat">
Expand Down
4 changes: 2 additions & 2 deletions es/api/assistant/create-assistant-message.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ keywords: [ "mensaje del assistant", "incrustar", "chat", "integrar", "ai sdk v4
<Badge color="orange">En desuso</Badge>

<Info>
El endpoint assistant message v1 es compatible con **AI SDK v4**. Si utilizas AI SDK v5 o posterior, usa en su lugar el [endpoint assistant message v2](/es/api-reference/assistant/create-assistant-message-v2).
El endpoint assistant message v1 es compatible con **AI SDK v4**. Si utilizas AI SDK v5 o posterior, usa en su lugar el [endpoint assistant message v2](/es/api/assistant/create-assistant-message-v2).
</Info>

<div id="integration-with-usechat">
Expand Down Expand Up @@ -72,7 +72,7 @@ El hook `useChat` del AI SDK de Vercel es la forma recomendada de integrar la AP

* `streamProtocol: 'data'` - Obligatorio para respuestas en streaming.
* `sendExtraMessageFields: true` - Obligatorio para enviar metadatos de los mensajes.
* `body.fp` - Identificador de huella digital (usa &#39;anonymous&#39; o un identificador de usuario).
* `body.fp` - Identificador de huella digital (usa 'anonymous' o un identificador de usuario).
* `body.retrievalPageSize` - Número de resultados de búsqueda que se usarán (recomendado: 5).

**Configuración opcional:**
Expand Down
48 changes: 28 additions & 20 deletions fr/ai/llmstxt.mdx
Original file line number Diff line number Diff line change
@@ -1,68 +1,76 @@
---
title: "llms.txt"
description: "Générez automatiquement les fichiers llms.txt et llms-full.txt pour aider les outils dIA à indexer et à comprendre votre documentation."
description: "Générez automatiquement les fichiers llms.txt et llms-full.txt pour aider les outils d'IA à indexer et à comprendre votre documentation."
keywords: ["llms.txt", "LLM indexing", "AEO", "GEO", "content discovery"]
---

import { PreviewButton } from "/snippets/previewbutton.jsx"

Le [fichier llms.txt](https://llmstxt.org) est une norme du secteur qui aide les LLM à indexer le contenu plus efficacement, comme un sitemap le fait pour les moteurs de recherche. Les outils dIA peuvent utiliser ce fichier pour comprendre la structure de votre documentation et trouver le contenu pertinent pour les requêtes des utilisateurs.
Le [fichier llms.txt](https://llmstxt.org) est une norme du secteur qui aide les LLM à indexer le contenu plus efficacement, comme un sitemap le fait pour les moteurs de recherche. Les outils d'IA peuvent utiliser ce fichier pour comprendre la structure de votre documentation et trouver le contenu pertinent pour les requêtes des utilisateurs.

Mintlify héberge automatiquement, à la racine de votre projet, un fichier `llms.txt` qui répertorie toutes les pages disponibles de votre documentation. Ce fichier est toujours à jour et ne nécessite aucun entretien. Vous pouvez également ajouter un fichier `llms.txt` personnalisé à la racine de votre projet.

<Note>
Si votre site nécessite une authentification, `llms.txt` et `llms-full.txt` sont également soumis à une authentification pour être consultés. Les LLM et les outils dIA qui ne peuvent pas sauthentifier sur votre site ne peuvent pas accéder à ces fichiers. Les fichiers excluent les pages qui appartiennent à des [groupes dutilisateurs](/fr/deploy/authentication-setup#control-access-with-groups).
Si votre site nécessite une authentification, `llms.txt` et `llms-full.txt` sont également soumis à une authentification pour être consultés. Les LLM et les outils d'IA qui ne peuvent pas s'authentifier sur votre site ne peuvent pas accéder à ces fichiers. Les fichiers excluent les pages qui appartiennent à des [groupes d'utilisateurs](/fr/deploy/authentication-setup#control-access-with-groups).
</Note>

Affichez votre `llms.txt` en ajoutant `/llms.txt` à lURL de votre site de documentation.
Affichez votre `llms.txt` en ajoutant `/llms.txt` à l'URL de votre site de documentation. Mintlify héberge également le fichier à l'emplacement `/.well-known/llms.txt` pour assurer la compatibilité avec les outils qui suivent la convention `.well-known`.

<PreviewButton href="https://mintlify.com/docs/llms.txt">Ouvrir le llms.txt de ce site.</PreviewButton>

Mintlify ajoute des en-têtes HTTP à chaque réponse de page afin que les outils d'IA puissent découvrir vos fichiers `llms.txt` sans connaissance préalable de leur emplacement :

- `Link: </llms.txt>; rel="llms-txt", </llms-full.txt>; rel="llms-full-txt"` : Suit le format standard de l'en-tête HTTP `Link` pour la découverte de ressources.
- `X-Llms-Txt: /llms.txt` : Un en-tête de commodité pour les outils qui vérifient la prise en charge de `llms.txt`.

<div id="llmstxt-structure">
## Structure de llms.txt
</div>

Un fichier `llms.txt` est un simple fichier Markdown qui contient :
Un fichier `llms.txt` est un simple fichier Markdown qui contient :

- **Le titre du site** en tant que H1.
- **Des sections de contenu structurées** avec des liens et une description de chaque page de votre documentation.
- **Des liens vers les spécifications d'API** pointant vers vos spécifications OpenAPI et AsyncAPI, si votre documentation en inclut.

* **Le titre du site** en tant que H1.
* **Des sections de contenu structurées** avec des liens et une description de chaque page de votre documentation.
* **Des liens vers les spécifications d&#39;API** pointant vers vos spécifications OpenAPI et AsyncAPI, si votre documentation en inclut.
Le fichier `llms.txt` répertorie vos pages par ordre alphabétique selon leur emplacement dans votre référentiel, en commençant au répertoire racine. Les liens des pages dans le fichier `llms.txt` incluent une extension `.md` afin que les outils d'IA puissent récupérer directement la version Markdown de chaque page.

Le fichier `llms.txt` répertorie vos pages par ordre alphabétique selon leur emplacement dans votre référentiel, en commençant au répertoire racine.
La description de chaque page provient du champ `description` de son frontmatter. Les descriptions sont tronquées à 300 caractères et au premier saut de ligne. Pour les pages de référence d'API, la description inclut également les informations de spécification issues du champ de frontmatter `openapi` ou `api`. Les pages sans champ `description` apparaissent dans le fichier `llms.txt` sans description.

La description de chaque page provient du champ `description` de son frontmatter. Les descriptions sont tronquées à 300 caractères et au premier saut de ligne. Pour les pages de référence d&#39;API, la description inclut également les informations de spécification issues du champ de frontmatter `openapi` ou `api`. Les pages sans champ `description` apparaissent dans le fichier `llms.txt` sans description.
Cette approche structurée permet aux LLM de traiter efficacement votre documentation à un niveau global et de repérer le contenu pertinent pour les requêtes des utilisateurs, améliorant ainsi la précision et la rapidité des recherches documentaires assistées par l'IA.

```mdx Example llms.txt
# Titre du site

## Documentation

- [API](https://example.com/docs/api) : Liste des endpoints et utilisation
- [Installation](https://example.com/docs/install) : Étapes de configuration
- [Prise en main](https://example.com/docs/start) : Guide d'introduction
- [API](https://example.com/docs/api.md) : Liste des endpoints et utilisation
- [Installation](https://example.com/docs/install.md) : Étapes de configuration
- [Prise en main](https://example.com/docs/start.md) : Guide d'introduction

## Spécifications API
## OpenAPI Specs

- [openapi](https://example.com/docs/openapi.json)

## AsyncAPI Specs

- [asyncapi](https://example.com/docs/asyncapi.yaml)
```

Cette approche structurée permet aux LLMs de traiter efficacement votre documentation à un niveau global et de repérer le contenu pertinent pour les requêtes des utilisateurs, améliorant ainsi la précision et la rapidité des recherches documentaires assistées par l’IA.

<div id="llms-fulltxt">
## llms-full.txt
</div>

Le fichier `llms-full.txt` regroupe lintégralité de votre site de documentation en un seul fichier servant de contexte pour les outils dIA et lindexation par les LLM.
Le fichier `llms-full.txt` regroupe l'intégralité de votre site de documentation en un seul fichier servant de contexte pour les outils d'IA et l'indexation par les LLM.

Mintlify héberge automatiquement un fichier `llms-full.txt` à la racine de votre projet. Affichez votre `llms-full.txt` en ajoutant `/llms-full.txt` à lURL de votre site de documentation. Mintlify héberge également le fichier à lemplacement `/.well-known/llms-full.txt` pour assurer la compatibilité avec les outils qui suivent la convention `.well-known`.
Mintlify héberge automatiquement un fichier `llms-full.txt` à la racine de votre projet. Affichez votre `llms-full.txt` en ajoutant `/llms-full.txt` à l'URL de votre site de documentation. Mintlify héberge également le fichier à l'emplacement `/.well-known/llms-full.txt` pour assurer la compatibilité avec les outils qui suivent la convention `.well-known`.

<PreviewButton href="https://mintlify.com/docs/llms-full.txt">Ouvrir le llms-full.txt de ce site</PreviewButton>

<div id="custom-files">
## Fichiers personnalisés
</div>

Pour ajouter un fichier `llms.txt` ou `llms-full.txt` personnalisé, créez un fichier `llms.txt` ou `llms-full.txt` à la racine de votre projet. Lajout dun fichier personnalisé remplace le fichier généré automatiquement portant le même nom. Si vous supprimez un fichier personnalisé, Mintlify restaure le fichier généré automatiquement.
Pour ajouter un fichier `llms.txt` ou `llms-full.txt` personnalisé, créez un fichier `llms.txt` ou `llms-full.txt` à la racine de votre projet. L'ajout d'un fichier personnalisé remplace le fichier généré automatiquement portant le même nom. Si vous supprimez un fichier personnalisé, Mintlify restaure le fichier généré automatiquement.

Votre fichier `llms.txt` ou `llms-full.txt` personnalisé doit comporter le titre du site en tant que niveau de titre H1. Le reste du contenu est facultatif. Consultez [Format](https://llmstxt.org/#format) dans la spécification `llms.txt` pour plus dinformations sur les sections facultatives et les bonnes pratiques.
Votre fichier `llms.txt` ou `llms-full.txt` personnalisé doit comporter le titre du site en tant que niveau de titre H1. Le reste du contenu est facultatif. Consultez [Format](https://llmstxt.org/#format) dans la spécification `llms.txt` pour plus d'informations sur les sections facultatives et les bonnes pratiques.
Loading
Loading