Saltar al contenido principal
Las sugerencias del agente están disponibles en los planes Custom. Para habilitar las sugerencias para tu organización, contacta a nuestro equipo de ventas.
Puedes permitir que el agente sugiera actualizaciones de documentación procedentes de dos fuentes.
  • Cambios en solicitudes de extracción: Supervisa repositorios de Git seleccionados en busca de cambios en el código que requieran actualizaciones de documentación.
  • Conversaciones con el assistant: Analiza las preguntas que los usuarios hacen al assistant en tu sitio de documentación para identificar lagunas en el contenido.
Cuando el agente identifica posibles actualizaciones de documentación, crea una sugerencia en tu dashboard con el contexto necesario para crear una solicitud de extracción. Usa las sugerencias para mantener tu documentación actualizada de forma proactiva cuando se lancen nuevas funciones o para responder a las preguntas más habituales de los usuarios.

​
Requisitos previos

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.

​
Configurar sugerencias

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:
  1. Haz clic en el botón Ask agent en tu dashboard para abrir el panel del agente.
  2. Haz clic en el botón Settings.
    El botón Settings en modo claro.

​
Supervisar repositorios

El agente supervisa todas las solicitudes de extracción fusionadas de cada repositorio que habilites, independientemente de la branch en la que se fusionen. 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.

​
Información sobre conversaciones

Activa la información sobre conversaciones para recibir sugerencias basadas en las preguntas frecuentes que los usuarios hacen al assistant. Cuando esta opción está activada, el agente analiza periódicamente las conversaciones del assistant y crea sugerencias cuando identifica patrones de preguntas que indican documentación que falta o que no es clara.

​
Notificaciones

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.

​
Revisar sugerencias

El agente crea sugerencias en tu dashboard. Cada sugerencia muestra la solicitud de extracción o el tema de la conversación con el assistant que desencadenó la sugerencia, la fecha de creación 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.
El botón Ask agent mostrando cuatro sugerencias en modo claro.

​
Crear solicitudes de extracción

Añade sugerencias como contexto para que el agente cree solicitudes de extracción.
  1. Haz clic en el botón Ask agent en tu dashboard para abrir el panel del agente.
  2. Haz clic en Add to chat.
  3. Envía la instrucción al agente para abrir una solicitud de extracción.

​
Descartar sugerencias

Si una sugerencia no requiere actualizaciones en la documentación o ya has aplicado los cambios, descártala para eliminarla de tu dashboard.
  1. Haz clic en el botón Ask agent en tu dashboard para abrir el panel del agente.
  2. 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.