Crear una automatización personalizada

Una automatización personalizada ejecuta al agente según un calendario, en respuesta a pushes al repositorio o cuando ocurre un evento en una integración conectada, utilizando instrucciones que tú escribes. Usa una automatización personalizada cuando necesites un comportamiento que no cubra una automatización predefinida, o cuando quieras combinar tu propio prompt con repositorios de contexto e integraciones específicos. Para ver una descripción general de los activadores, modos de actualización y opciones de configuración compartidas entre todas las automatizaciones, consulta Automatizaciones.

• Un proyecto de Mintlify conectado a un repositorio de GitHub o GitLab
• Para GitHub: la aplicación de GitHub de Mintlify instalada en cada repositorio que planees usar en la automatización
• Para GitLab: una cuenta de GitLab conectada (consulta Configuración de GitLab más abajo)

1. Abre la página Automatizaciones en tu dashboard.
2. Haz clic en New automation.
3. En la página de configuración, define el nombre de la automatización, el activador, el prompt, los repositorios de contexto, las integraciones y el modo de actualización. Para más detalles sobre cada campo, consulta Configuraciones.
4. Haz clic en Save.

Las instrucciones eficaces para una automatización se centran en una sola tarea y definen un resultado claro y verificable. Las automatizaciones presentan cierta variabilidad porque los agentes no son deterministas, pero las instrucciones bien formuladas producen resultados más consistentes.

• Describe el resultado. Indícale al agente cómo debe verse una ejecución exitosa.
• Escribe un procedimiento. Dale al agente una guía paso a paso a seguir.
• Mantén un alcance acotado. Divide las tareas complejas en varias automatizaciones en lugar de combinarlas en un solo prompt.

Para ver más ejemplos y patrones, consulta Usar automatizaciones. Prueba una automatización nueva con una ejecución manual para no tener que esperar a que ocurra su activador. Las ejecuciones manuales usan la configuración actual de la automatización y aparecen en el historial de ejecuciones junto a las ejecuciones automatizadas. No puedes ejecutar manualmente automatizaciones que se activan con eventos de integración. Consulta Ejecutar una automatización manualmente para elegir el alcance de una ejecución de prueba. Revisa la ejecución en el historial de ejecuciones para ver el prompt, los archivos que cambió el agente y cualquier pull request que haya abierto. Si el resultado no es el que esperabas, actualiza tus instrucciones y vuelve a ejecutarla.

​

Configuración de GitLab

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.

1. Abre la página Automatizaciones en tu dashboard.
2. Haz clic en el botón de configuración en la tarjeta de la automatización para abrir su página de configuración.
3. Actualiza cualquiera de los campos descritos en Configuraciones.
4. Haz clic en Save.

Eliminar una automatización es permanente y elimina su configuración y el historial de ejecuciones.

1. Ve a la página Automatizaciones en tu dashboard.
2. Haz clic en el botón de configuración en la tarjeta de la automatización para abrir su página de configuración.
3. Haz clic en Delete automation en la parte inferior de la página y confirma.