También puedes crear, listar y eliminar automatizaciones desde la terminal con mint automations. La CLI es útil para scripts y CI; el dashboard es la forma más sencilla de configurar y supervisar las ejecuciones de automatizaciones.
Haz clic en el interruptor junto a una automatización para activarla.
Si la automatización puede ejecutarse con la configuración predeterminada, se activa de inmediato. De lo contrario, se abre el panel de configuración para que completes los ajustes obligatorios.
Si se abre el panel de configuración, completa los campos obligatorios.
Haz clic en Turn on automation.
Para cambiar la configuración de una automatización activa, haz clic en el botón de configuración junto a ella. Usa el interruptor en el encabezado del modal para activarla o desactivarla sin salir de la vista de configuración.
Cada automatización tiene un activador predeterminado que controla cuándo se ejecuta. Para cambiar el activador, selecciona otra opción en el panel de configuración.
Actualización de contenido: se ejecuta cada vez que envías contenido al repositorio de tu proyecto, incluidas las fusiones de pull requests y los pushes directos.
Cambio de código: se ejecuta cuando se fusiona una pull request en un repositorio de código fuente conectado. Debes especificar al menos un repositorio de origen.
Programación personalizada: se ejecuta de forma recurrente según la programación que definas. Las automatizaciones se ponen en cola dentro de los 10 minutos siguientes a la hora programada.
Cada automatización tiene un modo predeterminado para realizar actualizaciones. Puede fusionar los cambios directamente en tu repositorio de contenido o abrir una pull request para revisión.Para requerir una revisión antes de que la automatización actualice tu contenido, selecciona Require review en el panel de configuración.
Para repositorios de GitHub, las actualizaciones automáticas requieren que la aplicación de GitHub de Mintlify tenga permisos de bypass en todos los rulesets que apunten a tu rama de implementación, incluidos los rulesets a nivel de organización y de repositorio. Consulta Configurar automerge para ver las instrucciones de configuración.Para repositorios de GitLab, el automerge utiliza la conexión OAuth de GitLab y requiere al menos el rol Maintainer en cada proyecto.
Para automatizaciones personalizadas y algunas automatizaciones predefinidas, puedes añadir repositorios de contexto: repositorios de código fuente adicionales que el agente lee cuando se ejecuta la automatización. Esto es útil cuando el prompt de tu automatización hace referencia a código, APIs u otro contenido que vive fuera del repositorio de tu proyecto.Puedes añadir hasta 10 repositorios de contexto por automatización. Para cada repositorio de GitHub, instala la aplicación de GitHub de Mintlify. Añade repositorios en la página de configuración de la aplicación de GitHub.
Para automatizaciones personalizadas y la automatización Update from code changes, puedes habilitar las integraciones del agente conectadas para que el agente pueda obtener contexto desde herramientas como Slack, Notion o Linear cuando se ejecuta la automatización.Para habilitar integraciones en una automatización, abre su configuración y selecciona las integraciones que quieres que el agente use en la sección Available integrations. Solo aparecen en la lista las integraciones ya conectadas para tu organización. Consulta Integraciones del agente para más información sobre cómo conectar integraciones.
Añade instrucciones opcionales que se agregan al prompt base de la automatización en cada ejecución. Úsalas para ajustar el estilo, el tono u otros comportamientos específicos del proyecto sin cambiar la lógica principal de la automatización.
Cuando activas la automatización Translate content, selecciona uno o más idiomas para mantenerlos sincronizados con tu contenido fuente.
Mintlify lee los idiomas definidos en tu docs.json para identificar tu idioma predeterminado y preselecciona los idiomas de destino que ya estén configurados.
Debes seleccionar al menos un idioma de destino para guardar la automatización.
No puedes seleccionar el idioma fuente como idioma de destino.
Puedes añadir idiomas de destino en cualquier momento abriendo la configuración de la automatización y editando el campo Translate to.
Para usar repositorios de GitLab en una automatización, conecta cada proyecto a través de la página de configuración de OAuth de GitLab. Conecta cada repositorio que la automatización utilice: tu repositorio de documentación y cualquier repositorio de activación o contexto. Debes tener al menos el rol de Maintainer en cada proyecto.
Las automatizaciones requieren un plan de pago de GitLab. El agente utiliza tokens de acceso de proyecto de corta duración para acceder a los repositorios, lo cual el plan gratuito de GitLab no admite.
Haz clic en el interruptor junto a una automatización para desactivarla.
Cuando vuelves a activar una automatización programada o cambias su programación, Mintlify recalcula el próximo tiempo de ejecución a partir de la hora actual. Las automatizaciones desactivadas no conservan un tiempo de ejecución pendiente.
Haz clic en el botón de ejecución junto a la automatización que quieres iniciar.
Las ejecuciones manuales usan la configuración actual de la automatización, cuentan para tu uso de créditos y aparecen en el historial de ejecuciones junto a las ejecuciones programadas.
Activar una automatización programada mediante la API
Para automatizaciones con un activador de Programación personalizada, puedes iniciar una ejecución desde tus propias herramientas en lugar de esperar a la próxima hora programada. Usa el endpoint Trigger automation para iniciar una ejecución desde un pipeline CI/CD, un script de versión o cualquier servicio que pueda hacer una solicitud HTTP autenticada.Las ejecuciones activadas por API se comportan exactamente igual que las ejecuciones programadas: recogen todo lo que ha cambiado desde la última ejecución completada, cuentan para el uso de créditos y aparecen en el historial de ejecuciones.
Usa los menús desplegables para filtrar por automatizaciones o estado específicos.
Cada ejecución muestra uno de los siguientes estados:
Queued: La ejecución está esperando para comenzar. Las ejecuciones programadas se ponen en cola dentro de los 10 minutos siguientes a la hora programada.
In progress: El agente está trabajando activamente en la ejecución.
Succeeded: El agente finalizó la ejecución. Si la automatización realizó cambios, la ejecución enlaza con el commit o la pull request resultante.
Failed: El agente no pudo completar la ejecución. Las ejecuciones fallidas no cuentan para tu límite diario de ejecuciones.
No changes: El agente finalizó la ejecución pero no encontró nada que actualizar.
Haz clic en una ejecución individual para ver su prompt, los archivos que leyó o modificó y cualquier pull request que haya abierto.
Después de que una automatización se complete y cree cambios en una rama, puedes abrir esos cambios directamente en el editor para revisarlos, refinarlos o publicarlos.
Haz clic en Ver cambios junto a la ejecución del workflow con la que quieres seguir trabajando en el editor.
El editor se abre en la rama de la automatización con el panel del agente ya desplegado. El panel del agente muestra cada página que la automatización modificó. Haz clic en cualquier página para ver los cambios realizados por la automatización.El agente del editor tiene contexto completo sobre lo que hizo la automatización, incluido su prompt, un resumen de los cambios y qué páginas modificó la automatización. Pídele al agente que refine o amplíe el trabajo sin tener que volver a explicar el contexto.
