Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
30 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion es/agent/customize.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Personalizar el comportamiento del agente"
description: "Configura cómo el agente maneja tareas de documentación con AGENTS.md."
description: "Personaliza el comportamiento del agente con un archivo de configuración `AGENTS.md` para controlar cómo gestiona las tareas de documentación y sigue tus convenciones."
keywords: ["AGENTS.md", "agent configuration", "custom instructions", "agent customization"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/agent/effective-prompts.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Escribe prompts eficaces"
description: "Obtén mejores resultados del agente con prompts claros y precisos."
description: "Escribe prompts claros y específicos para obtener mejores resultados del agente, con ejemplos de instrucciones efectivas y patrones comunes."
keywords: ["prompts", "agent prompts", "effective prompting", "agent usage"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/agent/index.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "¿Qué es el agente?"
description: "Automatiza las actualizaciones de documentación con el agente desde Slack, pull requests o llamadas de API."
description: "Automatiza las actualizaciones de documentación con el agente de Mintlify. Activa cambios desde mensajes de Slack, pull requests, issues de Linear o llamadas de API."
keywords: ["automation", "automate", "AI", "autoupdate", "maintenance"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/agent/linear.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Añade el agente a Linear"
description: "Usa el agente en Linear para crear actualizaciones de documentación a partir de issues y comentarios."
description: "Conecta el agente de Mintlify a Linear para crear actualizaciones de documentación a partir de issues, comentarios y actividad de proyectos."
keywords: ["issue tracking", "project management"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/agent/notion.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Conectar Notion al agente"
description: "Otorga al agente acceso a tu espacio de trabajo de Notion para que consulte páginas y bases de datos al actualizar la documentación."
description: "Conecta Notion al agente de Mintlify para que pueda consultar páginas y bases de datos de tu espacio de trabajo como contexto al crear actualizaciones de documentación."
keywords: ["Notion", "integration", "knowledge base", "context"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/agent/slack.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Añade el agente a Slack"
description: "Usa el agente en Slack para hacer actualizaciones de la documentación a partir de conversaciones y capturar el conocimiento del equipo."
description: "Añade el agente de Mintlify a Slack para crear actualizaciones de documentación a partir de conversaciones, capturar el conocimiento del equipo y mantener los documentos sincronizados."
keywords: ["Integración con Slack", "Bot de Slack", "Colaboración en equipo", "Integración del agente", "Captura de conocimiento"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/agent/use-cases.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Casos de uso"
description: "Ejemplos de cómo utilizar el agente en tu proceso de documentación."
description: "Explora ejemplos del mundo real sobre cómo usar el agente de Mintlify para automatizar actualizaciones de documentación, capturar conocimiento y mantener documentación precisa."
keywords: ["agent workflows", "documentation workflows", "automation examples"]
---

Expand Down
14 changes: 14 additions & 0 deletions es/agent/workflows.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -254,6 +254,20 @@ Puedes ejecutar flujos de trabajo basados en cron bajo demanda sin esperar a la
3. Haz clic en el botón <Icon icon="settings" /> de configuración del flujo de trabajo que deseas ejecutar.
4. Haz clic en el botón <Icon icon="play" /> de activación manual del flujo de trabajo para ejecutarlo.

<div id="disable-a-workflow">
### Deshabilitar un flujo de trabajo
</div>

Deshabilita un flujo de trabajo para detenerlo temporalmente sin eliminarlo. Los flujos de trabajo deshabilitados conservan su configuración e historial de ejecuciones, pero no se ejecutan según su programación ni en respuesta a eventos push. No se puede activar manualmente un flujo de trabajo deshabilitado.

Para activar o desactivar un flujo de trabajo:

1. Ve a la página [Workflows](https://dashboard.mintlify.com/products/workflows) en tu dashboard.
2. Haz clic en **View Workflows**.
3. Haz clic en el interruptor junto al flujo de trabajo que deseas deshabilitar o habilitar.

Cuando vuelves a habilitar un flujo de trabajo basado en cron, su próxima ejecución se recalcula a partir de la hora actual.

<div id="prompts">
## Prompts
</div>
Expand Down
2 changes: 1 addition & 1 deletion es/ai-native.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Documentación nativa en IA"
sidebarTitle: "Nativa en IA"
description: "Aprende cómo la IA mejora la lectura, la redacción y la exploración de tu documentación"
description: "Descubre cómo las funciones nativas de IA mejoran la lectura, la escritura y el descubrimiento de tu documentación con el asistente, el agente y el servidor MCP."
keywords: ["AI","assistant","agent","llms.txt","MCP","llms-full.txt"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/ai/assistant.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Assistant"
description: "Añade un chat con IA a tu documentación que responde preguntas, cita fuentes y genera ejemplos de código."
description: "Añade un asistente de chat con IA a tu sitio de documentación que responde preguntas de los usuarios, cita fuentes y genera ejemplos de código bajo demanda."
keywords: ["chat", "RAG", "user support", "mulitmodal"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/ai/discord.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Bot de Discord"
description: "Agrega un bot a tu servidor de Discord que responda preguntas basadas en tu documentación."
description: "Configura un bot de Discord que responda preguntas de la comunidad usando tu documentación como base de conocimiento, con citas de fuentes automáticas."
keywords: ["Discord", "bot", "Q&A", "customer support"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/ai/llmstxt.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "llms.txt"
description: "Genera automáticamente archivos llms.txt y llms-full.txt para ayudar a las herramientas de IA a indexar y comprender tu documentación."
description: "Genera automáticamente archivos llms.txt y llms-full.txt para que herramientas de IA como ChatGPT y Claude puedan indexar y comprender tu documentación."
keywords: ["llms.txt", "indexación de LLM", "AEO", "GEO", "descubrimiento de contenido"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/ai/markdown-export.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Exportación de Markdown"
description: "Obtén rápidamente versiones en Markdown de páginas para herramientas de IA e integraciones."
description: "Exporta versiones limpias en Markdown de tus páginas de documentación para herramientas de IA, integraciones de LLM y flujos de trabajo automatizados."
keywords: ["markdown", "eficiencia de tokens", "procesamiento de IA"]
---

Expand Down
34 changes: 28 additions & 6 deletions es/ai/model-context-protocol.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Protocolo de Contexto del Modelo"
description: "Conecta tu documentación y endpoints de API con herramientas de IA mediante un servidor MCP alojado."
description: "Conecta tu documentación y endpoints de API a herramientas de IA como Claude y Cursor con un servidor de Protocolo de Contexto de Modelos (MCP) alojado."
keywords: ["MCP", "Herramientas de IA", "Claude", "Cursor"]
---

Expand All @@ -12,22 +12,33 @@ import { PreviewButton } from "/snippets/previewbutton.jsx"

El Model Context Protocol (MCP) es un protocolo abierto que crea conexiones estandarizadas entre aplicaciones de IA y servicios externos, como la documentación. Mintlify genera un servidor MCP a partir de tu documentación, preparando tu contenido para el ecosistema de IA más amplio, donde cualquier cliente MCP (como Claude, Cursor, Goose y otros) puede conectarse a tu documentación.

Tu servidor MCP expone una herramienta para que las aplicaciones de IA puedan buscar en tu documentación. Tus usuarios deben conectar tu servidor MCP a sus herramientas.
Tu servidor MCP expone herramientas para que las aplicaciones de IA puedan buscar en tu documentación y obtener el contenido completo de las páginas. Tus usuarios deben conectar tu servidor MCP a sus herramientas.

<div id="how-mcp-servers-work">
### Cómo funcionan los servidores MCP
</div>

Cuando una aplicación de IA se conecta a tu servidor MCP de documentación, puede buscar directamente en tu documentación en respuesta a la instrucción de un usuario, en lugar de basarse en información de sus datos de entrenamiento o realizar una búsqueda genérica en la web. Tu servidor MCP proporciona acceso a todo el contenido indexado de tu sitio de documentación.
Cuando una aplicación de IA se conecta a tu servidor MCP de documentación, puede buscar en tu documentación y obtener el contenido completo de las páginas directamente en respuesta a la instrucción de un usuario, en lugar de basarse en información de sus datos de entrenamiento o realizar una búsqueda genérica en la web. Tu servidor MCP proporciona acceso a todo el contenido indexado de tu sitio de documentación.

* Las aplicaciones de IA pueden buscar proactivamente en tu documentación mientras generan una respuesta, incluso si no se les pide explícitamente que busquen en tu documentación para encontrar una respuesta.
* Las aplicaciones de IA determinan cuándo usar la herramienta de búsqueda según el contexto de la conversación y la relevancia de tu documentación.
* Cada búsqueda, también conocida como llamada a la herramienta, ocurre durante el proceso de generación, por lo que la aplicación de IA busca información actualizada de tu documentación para generar su respuesta.
* Las aplicaciones de IA determinan cuándo usar las herramientas disponibles según el contexto de la conversación y la relevancia de tu documentación.
* Cada llamada a la herramienta ocurre durante el proceso de generación, por lo que la aplicación de IA utiliza información actualizada de tu documentación para generar su respuesta.

<Tip>
Algunas herramientas de IA como Claude son compatibles tanto con MCP como con Skills. MCP da a la IA acceso al contenido de tu documentación, mientras que Skills le indican a la IA cómo usar ese contenido de forma eficaz. Son complementarios. MCP proporciona los datos y Skills proporcionan las instrucciones.
</Tip>

<div id="mcp-tools">
### Herramientas MCP
</div>

Tu servidor MCP proporciona dos herramientas que las aplicaciones de IA pueden usar:

- **Search**: Busca en toda tu documentación para encontrar contenido relevante, devolviendo fragmentos con títulos y enlaces. Úsala cuando necesites descubrir información o encontrar páginas que coincidan con una consulta.
- **Get page**: Obtiene el contenido completo de una página de documentación específica por su ruta. Úsala cuando ya conozcas la ruta de la página, como a partir de los resultados de búsqueda, y necesites el contenido completo en lugar de un fragmento.

Las aplicaciones de IA determinan cuándo usar cada herramienta según el contexto de la conversación. Por ejemplo, una aplicación de IA podría primero buscar en tu documentación para encontrar páginas relevantes y luego usar la herramienta get page para obtener el contenido completo del resultado más relevante.

<div id="search-parameters">
### Parámetros de búsqueda
</div>
Expand All @@ -41,6 +52,14 @@ La herramienta de búsqueda MCP admite parámetros opcionales que las aplicacion

Las aplicaciones de IA determinan cuándo aplicar estos parámetros en función del contexto de la búsqueda del usuario. Por ejemplo, si un usuario pregunta por una versión específica de la API, la aplicación de IA puede aplicar automáticamente el filtro adecuado para ofrecer resultados más relevantes.

<div id="get-page-parameters">
### Parámetros de get page
</div>

La herramienta get page acepta un parámetro obligatorio:

- **`page`**: La ruta de la página a obtener, como `'api-reference/create-customer'`. Usa las rutas de página devueltas por los resultados de búsqueda.

<div id="mcp-compared-to-web-search">
### MCP en comparación con la búsqueda en la web
</div>
Expand Down Expand Up @@ -112,7 +131,10 @@ Para proteger la disponibilidad, Mintlify aplica límites de uso a los servidore
| Alcance | Límite | Descripción |
| :---------------------------------- | :------------------------- | :-------------------------------------------------------------------------------- |
| Por usuario (dirección IP) | 5.000 solicitudes por hora | Limita la frecuencia con la que un solo usuario puede consultar la configuración de tu servidor MCP. |
| Por sitio de documentación (domain) | 10.000 solicitudes por hora | Limita el total de búsquedas entre todos los usuarios de tu servidor MCP. |
| Search por sitio de documentación (domain) | 10.000 solicitudes por hora | Limita el total de llamadas a la herramienta de búsqueda entre todos los usuarios de tu servidor MCP. |
| Get page por sitio de documentación (domain) | 10.000 solicitudes por hora | Limita el total de llamadas a la herramienta get page entre todos los usuarios de tu servidor MCP. |
| Search autenticado por sitio de documentación (domain) | 5.000 solicitudes por hora | Limita el total de llamadas autenticadas a la herramienta de búsqueda entre todos los usuarios de tu servidor MCP. |
| Get page autenticado por sitio de documentación (domain) | 5.000 solicitudes por hora | Limita el total de llamadas autenticadas a la herramienta get page entre todos los usuarios de tu servidor MCP. |

<div id="content-filtering-and-indexing">
## Filtrado de contenido e indexación
Expand Down
4 changes: 4 additions & 0 deletions es/ai/skillmd.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,10 @@ La [especificación de skill.md](https://agentskills.io/specification) es un for

Mintlify genera automáticamente un archivo `skill.md` para tu proyecto analizando tu documentación con un bucle de agentes. Este archivo se mantiene actualizado a medida que realizas cambios en tu documentación y no requiere mantenimiento. Opcionalmente, puedes añadir un archivo `skill.md` personalizado en la raíz de tu proyecto que reemplace al generado automáticamente.

<Note>
Generar o actualizar un archivo `skill.md` puede tardar hasta 24 horas.
</Note>

Consulta tu `skill.md` añadiendo `/skill.md` a la URL de tu sitio de documentación. Mintlify solo genera archivos `skill.md` para sitios de documentación que sean públicos.

<PreviewButton href="https://mintlify.com/docs/skill.md">Abrir el skill.md de este sitio.</PreviewButton>
Expand Down
2 changes: 1 addition & 1 deletion es/ai/slack-bot.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Bot de Slack"
description: "Añade un bot a tu espacio de trabajo de Slack que responda preguntas basadas en tu documentación."
description: "Configura un bot de Slack que responda preguntas del equipo usando tu documentación como base de conocimiento, con citas de fuentes y seguimiento de conversaciones."
keywords: ["bot", "workspace", "Q&amp;A", "Slack", "app"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/api-playground/adding-sdk-examples.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Agregar ejemplos de SDK"
description: "Muestra ejemplos de código de SDK en tu documentación de API."
description: "Añade ejemplos de código de SDK a tu documentación de API con ejemplos autogenerados de Speakeasy y Stainless en múltiples lenguajes."
keywords: ["x-codeSamples", "ejemplos de SDK"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/api-playground/asyncapi-setup.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Configuración de AsyncAPI"
description: "Crea documentación de WebSocket con especificaciones de AsyncAPI."
description: "Configura documentación de WebSocket en tiempo real usando archivos de especificación AsyncAPI para generar páginas de referencia interactivas de canales y mensajes."
keywords: ["asyncapi", "websocket"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/api-playground/managing-page-visibility.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Gestionar la visibilidad de páginas"
description: "Controla qué endpoints de API aparecen en la navegación de tu documentación."
description: "Controla qué endpoints de API aparecen en la navegación de tu documentación ocultando, filtrando u organizando las páginas de OpenAPI generadas automáticamente."
keywords: ["x-hidden", "x-excluded", "ocultar endpoints", "visibilidad de la página", "endpoints internos"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/api-playground/mdx-setup.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Crear páginas de API manuales"
description: "Crea páginas de referencia de API manualmente con archivos MDX para APIs pequeñas, prototipos o necesidades de documentación personalizada."
description: "Crea páginas de referencia de API manualmente con archivos MDX cuando necesitas control total del diseño para APIs pequeñas, prototipos o documentación personalizada."
keywords: ["Documentación de API", "Documentación de endpoints"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/api-playground/multiple-responses.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Respuestas múltiples"
description: "Documenta múltiples variaciones de respuestas para endpoints de la API."
description: "Documenta múltiples variaciones de respuestas para endpoints de la API, incluyendo casos de éxito y error, con códigos de estado y payloads de ejemplo."
keywords: ["response examples", "conditional responses", "response variations", "examples property"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/api-playground/openapi-setup.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Configuración de OpenAPI"
description: "Genera documentación de API interactiva a partir de tus archivos de especificación de OpenAPI."
description: "Genera documentación de API interactiva a partir de archivos de especificación OpenAPI con páginas de endpoints automáticas, constructores de solicitudes y navegación."
keywords: ["OpenAPI", "Especificación de API", "Swagger"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/api-playground/overview.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Playground"
description: "Permite a los desarrolladores probar endpoints de API directamente en tu documentación."
description: "Permite a los desarrolladores probar endpoints de API directamente en tu documentación con un área de pruebas interactiva que envía solicitudes reales y muestra respuestas."
keywords: ["interactivo", "API", "pruebas de endpoints", "solicitudes de API en tiempo real", "generador de solicitudes"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/api-playground/troubleshooting.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Solución de problemas"
description: "Resuelva problemas comunes con la configuración de las páginas de la API."
description: "Resuelve problemas comunes de configuración del área de pruebas de API, como errores de validación de OpenAPI, endpoints faltantes y problemas de autenticación."
keywords: ["API troubleshooting", "invalid OpenAPI", "configuration issues"]
---

Expand Down
2 changes: 1 addition & 1 deletion es/api-playground/websocket-playground.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "Zona de pruebas"
description: "Añade zonas de prueba interactivas de websockets a tu documentación para que los usuarios puedan probar directamente las conexiones en tiempo real."
description: "Añade áreas de pruebas interactivas de WebSocket a tu documentación para que los usuarios puedan probar conexiones en tiempo real, enviar mensajes y ver flujos de eventos."
asyncapi: "/asyncapi.yaml channelOne"
---
22 changes: 22 additions & 0 deletions es/api/analytics/feedback-by-page.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
title: "Obtener comentarios por página"
description: "Recupera los recuentos de comentarios de los usuarios agregados por página de documentación, incluidas las valoraciones positivas/negativas y los comentarios sobre fragmentos de código."
openapi: /es/analytics.openapi.json GET /v1/analytics/{projectId}/feedback/by-page
keywords: [ "Analytics", "feedback", "exportación", "por página", "agregado" ]
---

<div id="usage">
## Uso
</div>

Usa este endpoint para exportar los comentarios de los usuarios agregados por ruta de página de documentación. Cada entrada muestra el recuento total de comentarios de una página, desglosado por tipo.

<div id="filtering">
## Filtrado
</div>

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` o `contextual`
- **Estado**: Filtra por valores de estado como `pending`, `in_progress`, `resolved` o `dismissed`
20 changes: 20 additions & 0 deletions es/api/analytics/searches.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
title: "Obtener consultas de búsqueda"
description: "Recupera los términos de búsqueda de la documentación con los recuentos de resultados, las tasas de clics y las páginas más visitadas."
openapi: /es/analytics.openapi.json GET /v1/analytics/{projectId}/searches
keywords: [ "Analytics", "búsqueda", "exportación", "consultas", "términos de búsqueda" ]
---

<div id="usage">
## Uso
</div>

Usa este endpoint para exportar el análisis de búsqueda de la documentación. Los resultados se ordenan de mayor a menor número de resultados, mostrando los términos que más buscan tus usuarios.

Pagina los resultados usando el parámetro `nextCursor` devuelto en la respuesta. Continúa obteniendo resultados mientras `nextCursor` no sea nulo.

<div id="filtering">
## Filtrado
</div>

Filtra los datos de búsqueda por rango de fechas usando los parámetros `dateFrom` y `dateTo`.
Loading
Loading