Crear una automatización personalizada

Crea una automatización personalizada de Mintlify con un activador programado o por push, repositorios de contexto y un prompt para el agente.

​

Requisitos previos

• 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)

​

Crear una automatización personalizada

El agente se ejecuta en un sandbox aislado con acceso restringido a internet. No puede instalar paquetes o herramientas adicionales en tiempo de ejecución. Los prompts que hagan referencia a herramientas no disponibles pueden producir resultados inesperados o fallar.

1. Abre la página Automatizaciones en tu dashboard.
2. Haz clic en Create a custom automation.
3. Configura el nombre de la automatización, el activador, las instrucciones, 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 Create automation.

​

Escribir instrucciones eficaces

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.

Revisa la salida de tus automatizaciones personalizadas para confirmar que funcionan como esperabas. Actualiza tus instrucciones para mejorar los resultados.

​

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.

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.

​

Eliminar una automatización personalizada

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 junto a una automatización.
3. Haz clic en Delete.