Crea una automatización de Mintlify que se ejecute según un calendario, un push a un repositorio o un evento de integración, con contexto y prompt propios.
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.
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.
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.
Haz clic en Create automation.
También puedes pedirle al agente en Slack que cree una automatización por ti describiendo lo que quieres que haga.
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.
Revisa la salida de tus automatizaciones personalizadas para confirmar que funcionan como esperabas. Actualiza tus instrucciones para mejorar los resultados.
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.
Para usar repositorios de Bitbucket en una automatización, conecta tu cuenta de Bitbucket mediante la configuración de OAuth de Bitbucket en tu dashboard de Mintlify. Autoriza a Mintlify a acceder a tus espacios de trabajo de Bitbucket y, después, selecciona los espacios de trabajo y repositorios que la automatización puede usar.Mintlify muestra los repositorios en los que tu cuenta de Bitbucket tiene acceso de colaborador. Conecta los repositorios que la automatización usa para el contenido, los activadores de cambios de código o el contexto. Mintlify registra un webhook para cada repositorio conectado, de modo que los eventos del repositorio puedan activar automatizaciones.Antes de configurar un repositorio de Bitbucket conectado como fuente Git de un deployment, conecta ese repositorio en la configuración de OAuth de Bitbucket. Mintlify requiere que el repositorio forme parte de una instalación activa de Bitbucket para poder usarlo como fuente Git.
Abre Configuración de Git en tu dashboard, selecciona Connect to Bitbucket y haz clic en Continue.
Si Mintlify aloja actualmente tu documentación, haz clic en Download para guardar tu contenido como archivo zip. Crea un repositorio de Bitbucket, sube el contenido del archivo zip y haz clic en Continue setup. Conectar tu propio repositorio elimina permanentemente el contenido alojado, así que descárgalo antes de continuar.
Haz clic en Connect Bitbucket y autoriza a Mintlify a acceder a tu espacio de trabajo y repositorio.
Introduce el slug del espacio de trabajo de Bitbucket, el slug del repositorio y la rama de deployment. Si docs.json está en un subdirectorio, activa Docs are in a subdirectory e introduce la ruta al directorio que contiene docs.json.
Haz clic en Connect.
En un repositorio conectado y configurado como fuente Git de un deployment, los pushes a la rama configurada activan deployments. Mintlify usa los archivos modificados para realizar actualizaciones incrementales cuando puede determinar la diferencia. Ejecuta una actualización completa cuando no puede determinar los archivos modificados o cuando el cambio afecta a todo el sitio.Si los deployments de vista previa están habilitados, las pull requests que cambien el contenido de la documentación pueden crear deployments de vista previa. Al cerrar una pull request o eliminar su rama de origen, se elimina el deployment de vista previa correspondiente. Al fusionar una pull request, se limpia la rama del editor asociada.Mintlify verifica las firmas de los webhooks antes de procesar los eventos. Rechaza las solicitudes sin una firma válida. Ignora los eventos de repositorios no reconocidos.Para dejar de usar un repositorio, desconéctalo desde la configuración de OAuth de Bitbucket. También puedes eliminar la conexión de Bitbucket para desconectar todos los repositorios asociados con esa autorización.
