Puedes permitir que el agente supervise tus repositorios de Git seleccionados y sugiera actualizaciones de documentación. Cuando el agente identifica posibles cambios que afectan a los usuarios en tu aplicación, prepara el contexto para que puedas crear una solicitud de extracción y actualizar tu documentación con un solo clic.
Usa las sugerencias para mantener tu documentación actualizada de forma proactiva cuando se publiquen nuevas funciones o actualizaciones.
Antes de usar las sugerencias, debes instalar la Aplicación de GitHub de Mintlify en tu organización. La aplicación debe tener acceso a tu repositorio de documentación y al menos a otro repositorio en el que los cambios de código requieran actualizaciones de la documentación.
Configura qué repositorios supervisa el agente y cómo recibes las notificaciones, en la configuración del agente. La página de configuración muestra todas las organizaciones y repositorios de GitHub que el agente supervisa.
Para acceder a la configuración del agente:
-
Haz clic en el botón Ask agent en tu dashboard para abrir el panel del agente.
-
Haz clic en el botón Settings.
El agente supervisa la rama predeterminada (normalmente main) de cada repositorio que habilites. Una verificación de GitHub denominada Mintlify Autopilot se ejecuta en las solicitudes de extracción de los repositorios supervisados para analizarlas y detectar posibles actualizaciones de la documentación. Cuando fusionas una solicitud de extracción que requiere actualizaciones de la documentación, el agente crea una sugerencia en tu dashboard.
Cuando activas por primera vez la supervisión de un repositorio, el agente crea sugerencias para las solicitudes de extracción que se fusionaron en los últimos siete días. Este procesamiento retrospectivo solo ocurre si aún no existen sugerencias para ese repositorio. Es posible que veas que aparezcan varias sugerencias inmediatamente después de habilitar la supervisión.
Si deshabilitas la supervisión, el agente deja de supervisar el repositorio de inmediato. Cualquier sugerencia existente para ese repositorio permanece en tu dashboard hasta que la descartes.
Las sugerencias del agente siempre aparecen en tu dashboard. Puedes configurar las notificaciones para recibir correos electrónicos o mensajes directos de Slack cuando el agente cree nuevas sugerencias.
Si no recibes notificaciones por correo electrónico sobre las sugerencias, revisa tu carpeta de spam y agrega la dirección de correo notifications@mintlify.com a tu lista de remitentes seguros.
Cuando el agente detecta cambios visibles para el usuario en tus repositorios supervisados, crea una sugerencia que aparece en tu dashboard. Cada sugerencia muestra el title de la solicitud de extracción, el nombre del repositorio, la fecha en que se creó la sugerencia y las actualizaciones de documentación propuestas.
El botón Ask agent en tu dashboard muestra la cantidad de sugerencias pendientes de tu revisión.
Añade sugerencias como contexto para que el agente cree solicitudes de extracción.
- Haz clic en el botón Ask agent en tu dashboard para abrir el panel del agente.
- Haz clic en Add to chat.
- Envía la instrucción al agente para abrir una solicitud de extracción.
Si una sugerencia no requiere actualizaciones en la documentación o ya has aplicado los cambios, descártala para eliminarla de tu dashboard.
- Haz clic en el botón Ask agent en tu dashboard para abrir el panel del agente.
- Haz clic en el botón Dismiss junto a cualquier sugerencia que quieras descartar.
La sugerencia se elimina de inmediato de tu dashboard. No puedes recuperar las sugerencias descartadas.