mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
dc82d98a90
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
87 lines
5.1 KiB
Plaintext
87 lines
5.1 KiB
Plaintext
---
|
|
title: "¿Qué es el agente?"
|
|
description: "Automatiza las actualizaciones de documentación con el agente de Mintlify. Activa cambios desde mensajes de Slack, pull requests o llamadas de API."
|
|
keywords: ["automation", "automate", "AI", "autoupdate", "maintenance"]
|
|
---
|
|
|
|
El agente es una herramienta de IA que crea solicitudes de extracción (pull requests) con cambios propuestos para tu documentación a partir de tus indicaciones. Cuando envías una solicitud, el agente:
|
|
|
|
* **Investiga**: Busca y lee tu documentación existente, los repositorios conectados, el contexto relevante y la web.
|
|
* **Planifica**: Crea una lista de tareas estructurada para trabajos de documentación complejos.
|
|
* **Escribe**: Genera o actualiza contenido siguiendo los estándares y las mejores prácticas de redacción.
|
|
* **Valida**: Ejecuta comprobaciones con Mintlify CLI para asegurarse de que la documentación se compile correctamente.
|
|
* **Crea una PR**: Abre una solicitud de extracción con cambios propuestos para revisión.
|
|
|
|
Todos los cambios pasan por solicitudes de extracción (pull requests). El agente nunca realiza confirmaciones directamente en tu branch principal.
|
|
|
|
<div id="what-you-can-do-with-the-agent">
|
|
## Qué puedes hacer con el agente
|
|
</div>
|
|
|
|
Usa el agente para:
|
|
|
|
* Escribir contenido nuevo basado en tus prompts, solicitudes de extracción, hilos de Slack o archivos adjuntos.
|
|
* Actualizar documentación existente con nuevas funcionalidades o cambios en la API.
|
|
* Procesar e incluir imágenes, diagramas y otros archivos a partir de archivos adjuntos de Slack.
|
|
* Buscar y revisar ejemplos de código y referencias de API en toda tu documentación.
|
|
* Hacer referencia al código fuente de cualquier repositorio que tenga instalada la aplicación de GitHub de Mintlify.
|
|
* Obtener contexto en vivo desde aplicaciones conectadas como Slack, Notion, Linear y Jira.
|
|
* Automatizar el mantenimiento de la documentación mediante flujos de trabajo.
|
|
* Responder preguntas sobre tu documentación y temas de redacción técnica.
|
|
* Atender comentarios de revisión de código para mantener la calidad de la documentación.
|
|
* Capturar conocimiento de conversaciones en Slack y solicitudes de extracción antes de que se pierda.
|
|
* Navegar y coordinar cambios de forma eficiente en múltiples archivos y directorios.
|
|
|
|
<div id="connect-your-github-account">
|
|
## Conecta tu cuenta de GitHub
|
|
</div>
|
|
|
|
De forma predeterminada, el agente abre solicitudes de extracción a nombre del bot de Mintlify. Para que las solicitudes de extracción se atribuyan a ti, conecta tu cuenta de GitHub en la página [Mi perfil](https://dashboard.mintlify.com/settings/account) del dashboard.
|
|
|
|
<div id="connect-repositories-as-context">
|
|
## Conecta repositorios como contexto
|
|
</div>
|
|
|
|
El agente solo puede acceder a los repositorios que conectes mediante la Aplicación de GitHub de Mintlify. Configura a qué repositorios puede acceder el agente en la sección **Settings** del panel del agente o en la [configuración de la Aplicación de GitHub](https://github.com/apps/mintlify/installations/new).
|
|
|
|
<div id="use-ai-tools-alongside-the-agent">
|
|
## Usa herramientas de IA junto con el agente
|
|
</div>
|
|
|
|
El agente funciona de forma asíncrona mediante pull requests, pero también puedes usar herramientas de codificación con IA como Cursor o Claude Code localmente para realizar ediciones rápidas e iterativas. Instala el [skill](/es/ai/skillmd) de Mintlify y conecta el [servidor MCP](/es/ai/model-context-protocol) para que tu editor tenga el mismo contexto que utiliza el agente.
|
|
|
|
Para permitir que un agente externo edite tu contenido directamente mediante llamadas a herramientas MCP, conéctalo al [servidor MCP de Mintlify](/ai/mintlify-mcp).
|
|
|
|
<Prompt description="Instala el skill de Mintlify y los servidores MCP para herramientas de codificación con IA." actions={["copy", "cursor"]}>
|
|
Instala el skill de Mintlify para obtener contexto sobre la estructura de proyectos, los componentes y las mejores prácticas de documentación de Mintlify:
|
|
|
|
npx skills add https://mintlify.com/docs
|
|
|
|
Luego añade el servidor MCP de Mintlify Docs para acceder a la búsqueda en la documentación. https://mintlify.com/docs/mcp
|
|
|
|
Luego añade el servidor MCP de Mintlify para acceder al dashboard y a otras herramientas específicas de Mintlify. https://mcp.mintlify.com
|
|
</Prompt>
|
|
|
|
<div id="next-steps">
|
|
## Próximos pasos
|
|
</div>
|
|
|
|
<Card title="Conectar Slack" horizontal icon="slack" href="/es/agent/slack">
|
|
Añade el agente a tu espacio de trabajo de Slack.
|
|
</Card>
|
|
|
|
<Card title="Conectar integraciones" horizontal icon="plug" href="/es/agent/integrations">
|
|
Da al agente acceso a Slack, Notion, Linear y otras herramientas.
|
|
</Card>
|
|
|
|
<Card title="Personalizar comportamiento" horizontal icon="wrench" href="/es/agent/customize">
|
|
Configura el agente con un archivo `AGENTS.md`.
|
|
</Card>
|
|
|
|
<Card title="Escribir prompts eficaces" horizontal icon="pen" href="/es/agent/effective-prompts">
|
|
Obtén mejores resultados con prompts más específicos.
|
|
</Card>
|
|
|
|
<Card title="Automatizar con flujos de trabajo" horizontal icon="refresh-cw" href="/workflows">
|
|
Automatiza tareas recurrentes y el mantenimiento de la documentación mediante flujos de trabajo.
|
|
</Card> |