Skip to content
Merged
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
16 changes: 13 additions & 3 deletions es/agent/slack.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ Para añadir una nueva integración desde Slack:
- "Instala la integración con HubSpot."
- "Configura la integración con Linear."
2. El agente responde con un enlace de autorización.
3. Haz clic en el enlace, inicia sesión en el servicio de terceros y aprueba los permisos solicitados.
3. Haz clic en el enlace, inicia sesión en el servicio de terceros y aprueba los permisos solicitados. Después de autorizar, el navegador muestra una página de confirmación que indica que la conexión se ha completado.
4. Vuelve a Slack. El agente confirma la conexión y puede usar inmediatamente la integración como contexto para futuras solicitudes.

Las integraciones que conectes desde Slack se aplican al ámbito de tu usuario individual de Slack, por lo que cada miembro del equipo configura sus propias conexiones y el agente usa las conexiones de quien haya enviado el mensaje. Si un usuario de Slack no ha conectado un servicio, el agente recurre a las integraciones a nivel de organización instaladas desde la página [Agent](https://dashboard.mintlify.com/products/agent) en el panel.
Expand All @@ -60,6 +60,16 @@ Para eliminar o volver a autorizar una integración a nivel de organización, us

Para ver la lista completa de servicios admitidos, consulta el [catálogo de toolkits de Composio](https://docs.composio.dev/toolkits).

### Conexiones caducadas o revocadas

Mintlify mantiene sincronizado el estado de tus servicios conectados con Composio. Una conexión queda desconectada cuando:

- El proveedor externo expira o revoca las credenciales.
- El proveedor marca la conexión como inactiva.
- Tú eliminas la conexión.

Si una conexión ya no está activa, la próxima vez que pidas al agente que use ese servicio, responderá con un enlace de autorización. Haz clic en el enlace, vuelve a autorizar el servicio y el agente retomará la conexión.

<div id="use-the-agent-in-slack">
## Usar el agente en Slack
</div>
Expand All @@ -69,7 +79,7 @@ Una vez conectado, puedes:
- Enviar mensajes directos al agente para usarlo en privado y actualizar tu documentación.
- Mencionar `@mintlify` en un canal para usarlo de forma pública y colaborativa.
- Adjuntar archivos e imágenes directamente a tus mensajes para que el agente los procese y los incluya en tu documentación.
- Continuar las conversaciones en hilos para iterar sobre los cambios.
- Continuar las conversaciones en hilos para iterar sobre los cambios o hacer preguntas de seguimiento. El agente reutiliza los archivos e imágenes compartidos previamente en el hilo como contexto para las solicitudes posteriores, por lo que no es necesario que los vuelvas a cargar.
- Compartir enlaces a solicitudes de extracción con el agente para actualizar la documentación relacionada.

<div id="update-documentation">
Expand All @@ -80,7 +90,7 @@ Utiliza el agente para actualizar tu documentación mediante una nueva solicitud

- **Nueva solicitud**: Envía un mensaje directo al agente o menciona `@mintlify` en un canal con instrucciones sobre qué actualizar.
- **Hilo existente**: Responde en el hilo y menciona `@mintlify` con instrucciones sobre qué actualizar.
- **Con archivos adjuntos**: Sube imágenes, diagramas, archivos de código u otros documentos junto con tu mensaje. El agente los procesa automáticamente y los incluye en tu documentación.
- **Con archivos adjuntos**: Sube imágenes, diagramas, archivos de código u otros documentos junto con tu mensaje. El agente los procesa automáticamente y los incluye en tu documentación. En un hilo, el agente tiene acceso a las imágenes y archivos compartidos en mensajes anteriores, por lo que puedes hacer referencia a ellos en las solicitudes posteriores sin necesidad de volver a subirlos.

El agente lee el contexto de la solicitud o del hilo y crea una solicitud de extracción en tu repositorio conectado con las actualizaciones.

Expand Down
27 changes: 27 additions & 0 deletions es/api-playground/asyncapi-setup.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -109,6 +109,33 @@ Para generar automáticamente páginas para todos los canales de tu esquema Asyn
El campo `directory` es opcional. Si no se especifica, Mintlify añade los archivos a la carpeta **api-reference** del repositorio de documentación.
</Note>

### Ejemplos con grupos anidados

La propiedad `asyncapi` admite grupos anidados. Mintlify genera las páginas de canal y las añade al grupo anidado, junto con cualquier página existente.

Esto resulta útil cuando quieres organizar los canales WebSocket como una subsección de un grupo de API más amplio, o cuando necesitas combinar varias especificaciones de AsyncAPI bajo un grupo principal común.

```json
"navigation": {
"tabs": [
{
"tab": "API Reference",
"groups": [
{
"group": "Voice API",
"pages": [
"voice/overview",
{
"group": "Voice API Commands",
"asyncapi": "/path/to/voice-asyncapi.json"
}
]
}
]
}
]
}
```

<div id="channel-page">
## Página de canal
Expand Down
3 changes: 0 additions & 3 deletions es/api/agent/create-agent-job.mdx
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
---
title: "Crear trabajo del agente (v1)"
description: "En desuso. Crea un trabajo del agente para automatizar las
actualizaciones de la documentación, con creación automática de branch y
generación de solicitud de extracción."
openapi: /es/admin-openapi.json POST /v1/agent/{projectId}/job
keywords: [ "trabajo del agente", "crear", "automatización", "automatizar" ]
tag: "deprecated"
Expand Down
3 changes: 0 additions & 3 deletions es/api/agent/get-agent-job.mdx
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
---
title: "Obtener trabajo de agente (v1)"
description: "En desuso. Obtén el estado y los detalles de un trabajo de agente
específico, incluido el progreso, la información de la branch y los detalles
de la solicitud de extracción."
openapi: /es/admin-openapi.json GET /v1/agent/{projectId}/job/{id}
keywords: [ "trabajo de agente", "estado", "obtener", "detalles" ]
tag: "deprecated"
Expand Down
3 changes: 0 additions & 3 deletions es/api/agent/get-all-jobs.mdx
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
---
title: "Listar trabajos del agente (v1)"
description: "En desuso. Recupera todos los trabajos del agente de un proyecto
para monitorear actividades y hacer seguimiento del historial de estados de
los trabajos."
openapi: /es/admin-openapi.json GET /v1/agent/{projectId}/jobs
keywords: [ "trabajos del agente", "listar", "monitoreo" ]
tag: "deprecated"
Expand Down
2 changes: 0 additions & 2 deletions es/api/agent/v2/create-agent-job.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
---
title: "Crear tarea de agente"
description: "Crea una tarea de agente que se ejecuta en segundo plano y crea
automáticamente una solicitud de extracción con cambios en la documentación."
openapi: /es/admin-openapi.json POST /v2/agent/{projectId}/job
keywords: [ "tarea de agente", "crear", "automatización", "automatizar" ]
---
Expand Down
2 changes: 0 additions & 2 deletions es/api/agent/v2/get-agent-job.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
---
title: "Obtener tarea del agente"
description: "Recupera el estado y los detalles de una tarea del agente,
incluido el progreso y el enlace de la solicitud de extracción."
openapi: /es/admin-openapi.json GET /v2/agent/{projectId}/job/{id}
keywords:
[
Expand Down
2 changes: 0 additions & 2 deletions es/api/agent/v2/send-message.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
---
title: "Enviar un mensaje de seguimiento"
description: "Envía un mensaje de seguimiento a una tarea de agente existente
para proporcionar instrucciones adicionales."
openapi: /es/admin-openapi.json POST /v2/agent/{projectId}/job/{id}/message
keywords: [ "tarea de agente", "mensaje", "seguimiento", "enviar" ]
---
Expand Down
1 change: 0 additions & 1 deletion es/api/analytics/assistant-caller-stats.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
title: "Obtener estadísticas de llamadas del assistant"
description: "Obtén un desglose del número de consultas del assistant por tipo de origen para un rango de fechas determinado."
openapi: /es/analytics.openapi.json GET /v1/analytics/{projectId}/assistant/caller-stats
keywords: ["analytics", "assistant", "caller", "stats", "export"]
---
Expand Down
5 changes: 2 additions & 3 deletions es/api/analytics/assistant-conversations.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
---
title: "Obtener conversaciones del assistant"
description: "Obtén el historial de conversaciones del Asistente de IA,
incluidas las consultas, respuestas, fuentes citadas y categorías."
openapi: /es/analytics.openapi.json GET /v1/analytics/{projectId}/assistant
keywords: [ "analytics", "assistant", "conversations", "export", "AI" ]
---
Expand All @@ -10,7 +8,7 @@ keywords: [ "analytics", "assistant", "conversations", "export", "AI" ]
## Uso
</div>

Utiliza este endpoint para exportar el historial de conversaciones del Asistente de IA desde tu documentación. Cada conversación incluye la búsqueda del usuario, la respuesta del Asistente de IA, las fuentes citadas y la categoría de la búsqueda.
Utiliza este endpoint para exportar el historial de conversaciones del Asistente de IA desde tu documentación. Cada conversación incluye la búsqueda del usuario, la respuesta del Asistente de IA, las fuentes citadas, el estado de resolución y la categoría de la búsqueda.

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

Expand All @@ -29,4 +27,5 @@ Cada conversación incluye:
- **query**: La pregunta del usuario
- **response**: La respuesta del assistant
- **sources**: Páginas a las que se hace referencia en la respuesta, con título y URL
- **resolutionStatus**: Indica si el assistant respondió correctamente a la pregunta. Puede ser `answered` o `unanswered`. Usa este campo para identificar y analizar lagunas en la documentación detectadas a partir de preguntas de usuarios que el assistant no pudo resolver.
- **queryCategory**: Clasificación del tipo de búsqueda (si está disponible)
1 change: 0 additions & 1 deletion es/api/analytics/feedback-by-page.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
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" ]
---
Expand Down
3 changes: 0 additions & 3 deletions es/api/analytics/feedback.mdx
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
---
title: "Obtener comentarios"
description: "Obtén comentarios de los usuarios sobre tu documentación,
incluidas las valoraciones de las páginas y los comentarios sobre fragmentos
de código."
openapi: /es/analytics.openapi.json GET /v1/analytics/{projectId}/feedback
keywords: [ "Analytics", "feedback", "exportación", "comentarios de los usuarios" ]
---
Expand Down
1 change: 0 additions & 1 deletion es/api/analytics/searches.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
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" ]
---
Expand Down
1 change: 0 additions & 1 deletion es/api/analytics/views.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
title: "Obtener vistas de página"
description: "Recupera los recuentos de vistas de contenido por página y de todo el sitio, desglosados por tráfico humano y de IA."
openapi: /es/analytics.openapi.json GET /v1/analytics/{projectId}/views
keywords: [ "Analytics", "vistas", "vistas de página", "tráfico", "exportación" ]
---
Expand Down
1 change: 0 additions & 1 deletion es/api/analytics/visitors.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
title: "Obtener visitantes únicos"
description: "Recupera los recuentos aproximados de visitantes únicos por página y de todo el sitio, desglosados por tráfico humano y de IA."
openapi: /es/analytics.openapi.json GET /v1/analytics/{projectId}/visitors
keywords: [ "Analytics", "visitantes", "visitantes únicos", "tráfico", "exportación" ]
---
Expand Down
1 change: 0 additions & 1 deletion es/api/assistant/get-page-content.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
title: "Obtener contenido de la página"
description: "Recupera el contenido de texto completo de una página de documentación por su ruta."
openapi: "/es/discovery-openapi.json POST /v1/page/{domain}"
keywords: [ "página", "contenido", "recuperar" ]
---
Expand Down
2 changes: 0 additions & 2 deletions es/api/assistant/search.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
---
title: "Buscar en la documentación"
description: "Busca en tu documentación de forma programática y obtén las
páginas relevantes que coincidan con la búsqueda."
openapi: "/es/discovery-openapi.json POST /v1/search/{domain}"
keywords: [ "búsqueda", "query" ]
---
Expand Down
1 change: 0 additions & 1 deletion es/api/preview/trigger.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
title: "Activar implementación de vista previa"
description: "Crea o actualiza una implementación de vista previa para una rama específica y revisa los cambios en la documentación antes de fusionarlos a producción."
openapi: "/es/openapi.json POST /project/preview/{projectId}"
keywords: ["preview", "preview deployment", "branch preview", "staging"]
---
Expand Down
2 changes: 0 additions & 2 deletions es/api/update/status.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
---
title: "Obtener el estado de la implementación"
description: "Consulta el estado de una implementación de la documentación para
supervisar el progreso y la finalización."
openapi: "/es/openapi.json GET /project/update-status/{statusId}"
keywords: [ "actualizar estado", "estado de implementación", "comprobar estado" ]
---
3 changes: 0 additions & 3 deletions es/api/update/trigger.mdx
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
---
title: "Iniciar implementación"
description: "Inicia una implementación de la documentación de forma
programática para publicar actualizaciones fuera de los flujos de trabajo de
Git."
openapi: "/es/openapi.json POST /project/update/{projectId}"
keywords: [ "disparar", "actualización", "implementación", "programático" ]
---
4 changes: 4 additions & 0 deletions es/create/reusable-snippets.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,10 @@ keywords: ["content snippets", "reusable content", "variables"]

Uno de los principios fundamentales del desarrollo de software es DRY (Don&#39;t Repeat Yourself), que también se aplica a la documentación. Si te encuentras repitiendo el mismo contenido en varios lugares, crea un fragmento personalizado para ese contenido. Los fragmentos incluyen contenido que puedes importar en otros archivos para reutilizarlo. Tú controlas dónde aparece el fragmento en una página. Si alguna vez necesitas actualizar el contenido, solo tendrás que editar el fragmento en lugar de cada archivo donde se use.

<Note>
Actualmente, los fragmentos no son compatibles con el editor web. Para usar fragmentos, edita tus archivos MDX localmente con la CLI o envía las importaciones de fragmentos directamente a tu repositorio.
</Note>

<div id="how-snippets-work">
## Cómo funcionan los snippets
</div>
Expand Down
Loading
Loading