Saltar al contenido principal
Autopilot requiere un plan Pro o Enterprise.
Autopilot es un agente que trabaja en segundo plano para ayudarte a mantener tu documentación. Puedes concederle acceso de lectura a tus repositorios de código y a otras herramientas para que comprenda el flujo de trabajo de tu equipo y las necesidades de contenido. Cuando detecta cambios en tu código, abre pull requests para sugerir actualizaciones de tu documentación y etiqueta a tu equipo para que las revise. Autopilot es independiente de las automatizaciones. Las automatizaciones ejecutan prompts específicos para el agente en los activadores que configuras. Autopilot decide por sí mismo qué necesita actualizarse. Comprueba qué automatizaciones están activas y evita duplicarlas. Autopilot también examina tus automatizaciones configuradas para obtener contexto sobre tu sitio y tus necesidades de contenido. De forma predeterminada, Autopilot sugiere actualizaciones de tu documentación cuando cambia tu código y ejecuta una comprobación de calidad una vez al día. Para cambiar en qué trabaja Autopilot y cuándo se ejecuta, chatea con Autopilot.

Requisitos previos

  • Un proyecto de Mintlify conectado a un repositorio de GitHub. Autopilot no admite GitLab ni otros proveedores de Git.
  • La GitHub App de Mintlify instalada en tu repositorio de documentación y en cualquier repositorio de código fuente que quieras que use Autopilot.

Habilitar Autopilot

  1. Abre la página Autopilot en tu panel.
  2. Activa el interruptor de la tarjeta Autopilot.
Cuando habilitas Autopilot por primera vez, ejecuta una primera comprobación para obtener contexto de tu documentación, tus repositorios y tus herramientas conectadas. Esto suele tardar unos minutos. Cuando termina la primera comprobación, puedes chatear con Autopilot.

Conectar repositorios y herramientas

La sección Integrations de la página de Autopilot enumera las fuentes que Autopilot lee para aprender cómo publica tu equipo y qué aborda tu documentación.

Repositorios de GitHub

Si no has conectado GitHub, haz clic en Connect en la fila GitHub para instalar la GitHub App de Mintlify. Para elegir los repositorios que Autopilot usa como contexto:
  1. Haz clic en Configure en la fila GitHub.
  2. En Additional repositories, selecciona los repositorios de código fuente que quieres que use Autopilot.
  3. Haz clic en Save.
Tu repositorio de documentación siempre se incluye como contexto obligatorio para Autopilot, por lo que no puedes quitarlo. La lista Additional repositories solo muestra los repositorios en los que está instalada la GitHub App de Mintlify. Para añadir un repositorio que no aparece en la lista, primero instala la GitHub App en él.

Slack y otras integraciones

Haz clic en Connect en la fila Slack para que Autopilot pueda obtener contexto de las conversaciones. Si desconectas Slack desde la página de Autopilot, se elimina la app de Slack de Mintlify de tu espacio de trabajo para todos los productos que la usan, incluidas las automatizaciones. La sección también enumera las integraciones compartidas compatibles disponibles para tu organización, como Linear, Jira, Notion, Confluence, PostHog, Zendesk, Intercom, Plain y Pylon. Autopilot lee como contexto las que conectes.

Cómo abre Autopilot las pull requests

Autopilot confirma sus cambios en una nueva rama y abre una pull request. Nunca hace push directamente a tu rama de despliegue ni a la rama predeterminada del repositorio. De forma predeterminada, las pull requests apuntan a tu rama de despliegue. Si tu equipo fusiona los cambios en una rama distinta de la que despliega tu sitio, díselo a Autopilot en un chat y apuntará a esa rama en su lugar.

Revisores y correos electrónicos

De forma predeterminada, Autopilot asigna cada pull request al compañero de equipo que identifica como responsable del código que cambió, solicita su revisión y le envía un correo electrónico sobre la pull request. Para solicitar revisiones a más personas o cambiar quién revisa los cambios, díselo a Autopilot en un chat. Autopilot envía correos electrónicos desde autopilot@mintlify.com. Añade esta dirección a tus contactos de correo electrónico para evitar los filtros de spam. Autopilot solo envía correos electrónicos a miembros de tu organización de Mintlify o a direcciones de un dominio de correo electrónico de empresa que usen los miembros de tu organización.

Revisar sugerencias

Las pull requests abiertas de Autopilot aparecen en Suggestions en la página Autopilot de tu panel. Haz clic en una sugerencia para abrirla. Cada sugerencia muestra el título de la pull request, el repositorio, la rama y los archivos modificados con el recuento de líneas. Cuando existe un despliegue de vista previa, haz clic en Preview para ver los cambios en tu sitio.
  • Haz clic en Accept para fusionar la pull request.
  • Haz clic en Close para cerrar la pull request sin fusionarla.
  • Envía un mensaje para pedir cambios. Autopilot actualiza la pull request.
Si una pull request tiene conflictos de fusión o tus reglas de protección de ramas bloquean la fusión, resuélvelo en GitHub.

Chatear con Autopilot

En la página Autopilot, haz clic en Chat to configure en la tarjeta Autopilot para iniciar una conversación con Autopilot en el panel del agente. En un chat, puedes hacer preguntas sobre el trabajo de Autopilot, dar instrucciones para trabajos futuros y pausar o reanudar un tipo de trabajo. Cuando reanudas un trabajo programado, se ejecuta en su siguiente hora programada. Algunos ejemplos de chats que puedes tener con Autopilot:
  • Preguntar qué hizo Autopilot y por qué, por ejemplo, por qué abrió una pull request concreta.
  • Preguntar cuándo se ejecuta Autopilot y qué repositorios e integraciones usa.
  • Pedirle a Autopilot que un compañero de equipo concreto revise una pull request.
  • Pedirle a Autopilot que ejecute una comprobación semanal de enlaces rotos.
Los chats requieren el rol de editor o administrador. No puedes iniciar un chat nuevo mientras Autopilot está en pausa.

Pausar Autopilot

Para pausar Autopilot, desactiva el interruptor de la tarjeta Autopilot. Cuando reanudas Autopilot, obtiene contexto sobre los cambios que se produjeron mientras estaba en pausa, pero no crea actualizaciones para ellos.

Pausas automáticas

Antes de cada ejecución, Autopilot comprueba tu plan y tus créditos. Se pausa a sí mismo en lugar de ejecutarse en cualquiera de estos casos:
  • Tu organización se queda sin créditos. Añade créditos y vuelve a activar el interruptor.
  • Tu plan ya no incluye Autopilot. Para reanudarlo, actualiza a un plan que incluya Autopilot.

Créditos

Cada ejecución de Autopilot que abre o actualiza una pull request cuesta 250 créditos. Las ejecuciones que no abren ni actualizan una pull request no cuestan créditos. Consulta Precios por créditos para obtener más información.