Saltar al contenido principal
El agente está disponible en los planes Pro y Custom para cualquier persona con acceso a tu dashboard.
El agente crea solicitudes de extracción con cambios propuestos en tu documentación basados en tus indicaciones. Cuando envías una solicitud al agente, este consulta tu documentación, los repositorios conectados y los mensajes de Slack para crear contenido que siga las mejores prácticas de redacción técnica y se ajuste al esquema de Mintlify. Accede al agente directamente desde tu dashboard, en tu espacio de trabajo de Slack o intégralo en aplicaciones personalizadas con la API. Usa el agente para:
  • Redactar contenido nuevo basado en tus indicaciones, enlaces a solicitudes de extracción o hilos de Slack
  • Revisar ejemplos de código desactualizados y referencias de API
  • Buscar y actualizar contenido existente
  • Responder preguntas sobre tu documentación y temas de redacción técnica

​
Usa el agente en el dashboard

Accede al panel del agente directamente desde tu dashboard usando el atajo de teclado ⌘+I (Mac) o Ctrl+I (Windows/Linux), o haciendo clic en el botón Preguntar al agente. El panel del agente incluye:
  • Chat: Envía consultas y recibe respuestas con propuestas de cambios en la documentación.
  • Historial: Consulta y continúa conversaciones anteriores.
  • Configuración: Configura los permisos de la Aplicación de GitHub y la integración con Slack.
El panel del agente en modo claro.
Cuando el agente realiza cambios, puedes ver la solicitud de extracción directamente desde el chat o abrir los cambios en el editor web.

​
Añade el agente a tu espacio de trabajo de Slack

También puedes usar el agente en Slack para colaborar con tu equipo en las actualizaciones de la documentación.
Si el propietario del espacio de trabajo de Slack requiere la aprobación de un administrador para instalar aplicaciones, pídele que apruebe la aplicación Mintlify antes de conectarla.
  1. Abre el panel del agente en tu dashboard.
  2. Haz clic en el botón Settings.
    El botón de configuración en modo claro.
  3. Selecciona el botón Connect en la sección de integración con Slack.
  4. Sigue las indicaciones de Slack para añadir la aplicación mintlify a tu espacio de trabajo.
  5. Sigue las indicaciones de Slack para vincular tu cuenta de Mintlify con tu espacio de trabajo de Slack.
  6. Comprueba que el agente funciona y responde cuando:
    • Le envías un mensaje directo.
    • Lo mencionas con @mintlify en un canal.

​
Conecta repositorios como contexto

El agente solo puede acceder a los repositorios que conectes a través de la Aplicación de GitHub de Mintlify. Configura a qué repositorios puede acceder el agente en el panel del agente, en Settings, o en la configuración de la Aplicación de GitHub.

​
Integra el agente mediante la API

Usa los endpoints del agente para crear tareas, obtener una tarea específica y obtener todas las tareas. Al crear tareas mediante la API, puedes controlar si se crean solicitudes de extracción como borradores mediante el parámetro asDraft (predeterminado en true). Establece asDraft: false para crear solicitudes de extracción que no sean borrador, listas para su revisión inmediata y su fusión en flujos de trabajo automatizados.

​
Escribe prompts efectivos

Piensa en el agente como un assistant útil que necesita tu guía para completar tareas. Dale instrucciones claras y contexto. Las tareas más específicas son más fáciles de completar, así que divide los proyectos complejos en pasos más pequeños. Haz que tus prompts sean concretos y orientados a resultados. Prompts genéricos como @mintlify Improve the onboarding page aplican buenas prácticas generales, pero puede que no mejoren el contenido exactamente como lo imaginabas. Prueba prompts basados en los resultados que quieres que tus usuarios alcancen o en los problemas que enfrentan. Por ejemplo:
  • @mintlify A lot of users have trouble installing the CLI. Review the onboarding page and update the docs so that users can easily install the CLI
  • @mintlify Developers keep getting 401 errors when following our authentication guide. Review the auth docs and add clearer examples showing how to properly format the API key
Usa prompts amplios para el mantenimiento general del contenido, como corregir errores tipográficos, actualizar redirecciones o renombrar una función en toda tu documentación. Por ejemplo:
  • @mintlify Find and fix all typos in the docs
  • @mintlify change all unordered lists to use * instead of -

​
Especificar un nombre de dominio

Si tienes varios sitios de documentación, incluye el parámetro subdomain en tu mensaje para especificar en qué conjunto de documentación debe trabajar el agente. Para encontrar tu nombre de dominio, revisa la URL del dashboard para el conjunto de documentación que quieres actualizar. El nombre de dominio es la última parte después del nombre de tu organización. Por ejemplo, si la URL de tu dashboard es https://dashboard.mintlify.com/org-name/domain-name, tu nombre de dominio es domain-name. Usa el formato @mintlify subdomain=<your-domain-name> <your-prompt> para indicarle al agente que trabaje en un conjunto de documentación específico. Ejemplos:
  • @mintlify subdomain=public-docs Añade una nueva sección al quickstart sobre cómo invitar colaboradores en función de este PR: Indica al agente que actualice el quickstart solo en el sitio public-docs.
  • @mintlify subdomain=customer-docs Actualiza la documentación de autenticación para el nuevo método de autenticación: Indica al agente que actualice la documentación de autenticación solo en el sitio customer-docs.

​
Flujos de trabajo del agente

El agente ayuda con muchas tareas de documentación. Estos flujos de trabajo muestran algunas de las maneras en que puedes integrar al agente en tu proceso de documentación. Prueba un enfoque que se adapte a la forma en que trabaja tu equipo actualmente y ajústalo a tus necesidades específicas.

​
Iterar un prompt en un hilo de Slack

Envía un prompt al agente y sigue mencionándolo con @mintlify en el mismo hilo para refinar e iterar la solicitud de extracción que cree. Por ejemplo: @mintlify Nuestra página de inicio rápido necesita una nueva sección sobre cómo invitar colaboradores. Luego: @mintlify La nueva sección debería llamarse "Invitar colaboradores". Y continúa con cualquier otra iteración.

​
Empieza con el agente y termina manualmente

Pídele al agente que inicie un proyecto, luego cambia a la branch que cree y completa la tarea en tu entorno local o en el editor web. El agente puede ayudarte a comenzar; después, puedes retomar para finalizar la tarea. Por ejemplo: @mintlify Update the quickstart page to include information about inviting collaborators, y luego cambia a la branch para realizar cualquier cambio adicional con tu método preferido.

​
Actualiza la documentación al fusionar cambios de funcionalidades

Cuando fusiones una solicitud de extracción de una funcionalidad, comparte el enlace del PR con el agente para actualizar la documentación correspondiente. Por ejemplo: @mintlify Este PR agrega un nuevo método de autenticación. Actualiza la documentación para incluir el nuevo flujo de autenticación: [enlace al PR].

​
Generar notas de versión a partir de una solicitud de extracción

Pídele al agente una solicitud de extracción específica para generar notas de versión o actualizaciones del changelog basadas en el historial de confirmaciones. Por ejemplo: @mintlify Generate release notes for this PR: [PR link].

​
Generar ejemplos de código

Pídele al agente que genere ejemplos de código para funciones en toda tu documentación o en páginas específicas. Por ejemplo: @mintlify Genera un ejemplo de código para que el método de Autenticación sea más fácil de entender.

​
Revisar el contenido existente

Pídele al agente que revise el contenido existente para verificar la precisión técnica, el estilo, la gramática u otros aspectos. Por ejemplo: @mintlify Revisa la sección de limitación de tasa de la API. Cambiamos los límites el mes pasado.

​
Responder a los comentarios de los usuarios

Proporciona al agente comentarios de tus usuarios para realizar actualizaciones específicas en tu documentación. Por ejemplo: @mintlify Los usuarios se están confundiendo con el paso 3 de la guía de configuración. ¿Qué podría estar causando la falta de claridad?.

​
Automatiza con la API

Integra el agente en tus herramientas de automatización existentes para actualizar la documentación automáticamente cuando se produzcan cambios en el código, activar revisiones de contenido o sincronizar las actualizaciones de la documentación en varios repositorios. Aprende cómo en el tutorial Actualizar automáticamente la documentación cuando se hace merge del código.