# Crear una automatización personalizada (/es/automations/create)

<!-- agent-signals: reading_time_min: 6 · est_tokens: 2389 · updated: 2026-09-23 -->
Related: [Integraciones para el agente y las automatizaciones](/es/automations/integrations.md), [Gestionar automatizaciones](/es/automations/manage.md), [Automatizaciones predefinidas](/es/automations/reference.md), [Contacto de seguridad](/es/dashboard/security-contact.md)

Una automatización personalizada ejecuta al agente según un calendario, en respuesta a pushes al repositorio, cuando ocurre un evento en una integración conectada o cuando llega una solicitud de webhook entrante, utilizando instrucciones que tú escribes. Usa una automatización personalizada cuando necesites un comportamiento que no cubra una [automatización predefinida](/es/automations/reference), 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](/es/automations).

<div id="prerequisites">
  ## Requisitos previos [#requisitos-previos]
</div>

* Un [plan Pro o Enterprise](https://mintlify.com/pricing?ref=automations). El activador de integración requiere un plan Enterprise.
* Un proyecto de Mintlify conectado a un repositorio de GitHub o GitLab
* Para GitHub: la [aplicación de GitHub de Mintlify](/es/deploy/github) instalada en cada repositorio que planees usar en la automatización
* Para GitLab: una cuenta de GitLab conectada (consulta [Configuración de GitLab](#gitlab-setup) más abajo)

<div id="create-a-custom-automation">
  ## Crear una automatización personalizada [#crear-una-automatización-personalizada]
</div>

<Note>
  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.
</Note>

1. Abre la página [Automatizaciones](https://app.mintlify.com/products/automations) 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](/es/automations/manage#configurations).
4. Haz clic en **Save**.

<Tip>
  También puedes pedirle al [agente en Slack](/es/agent/slack#manage-automations) que cree una automatización por ti describiendo lo que quieres que haga.
</Tip>

<div id="write-effective-instructions">
  ## Escribir instrucciones eficaces [#escribir-instrucciones-eficaces]
</div>

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](/es/guides/use-automations).

<div id="test-your-automation">
  ## Probar tu automatización [#probar-tu-automatización]
</div>

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 con activador de integración o de webhook; en su lugar, envía un evento o una solicitud de webhook. Consulta [Ejecutar una automatización manualmente](/es/automations/manage#run-an-automation-manually) para elegir el alcance de una ejecución de prueba.

Revisa la ejecución en el [historial de ejecuciones](/es/automations/manage#view-run-history) 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 [#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](https://app.mintlify.com/settings/organization/gitlab-oauth). 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.

<Note>
  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.
</Note>

<div id="edit-a-custom-automation">
  ## Editar una automatización personalizada [#editar-una-automatización-personalizada]
</div>

1. Abre la página [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard.
2. Haz clic en el botón de configuración <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M15.5 12C15.5 13.933 13.933 15.5 12 15.5C10.067 15.5 8.5 13.933 8.5 12C8.5 10.067 10.067 8.5 12 8.5C13.933 8.5 15.5 10.067 15.5 12Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M21.011 14.0965C21.5329 13.9558 21.7939 13.8854 21.8969 13.7508C22 13.6163 22 13.3998 22 12.9669V11.0332C22 10.6003 22 10.3838 21.8969 10.2493C21.7938 10.1147 21.5329 10.0443 21.011 9.90358C19.0606 9.37759 17.8399 7.33851 18.3433 5.40087C18.4817 4.86799 18.5509 4.60156 18.4848 4.44529C18.4187 4.28902 18.2291 4.18134 17.8497 3.96596L16.125 2.98673C15.7528 2.77539 15.5667 2.66972 15.3997 2.69222C15.2326 2.71472 15.0442 2.90273 14.6672 3.27873C13.208 4.73448 10.7936 4.73442 9.33434 3.27864C8.95743 2.90263 8.76898 2.71463 8.60193 2.69212C8.43489 2.66962 8.24877 2.77529 7.87653 2.98663L6.15184 3.96587C5.77253 4.18123 5.58287 4.28891 5.51678 4.44515C5.45068 4.6014 5.51987 4.86787 5.65825 5.4008C6.16137 7.3385 4.93972 9.37763 2.98902 9.9036C2.46712 10.0443 2.20617 10.1147 2.10308 10.2492C2 10.3838 2 10.6003 2 11.0332V12.9669C2 13.3998 2 13.6163 2.10308 13.7508C2.20615 13.8854 2.46711 13.9558 2.98902 14.0965C4.9394 14.6225 6.16008 16.6616 5.65672 18.5992C5.51829 19.1321 5.44907 19.3985 5.51516 19.5548C5.58126 19.7111 5.77092 19.8188 6.15025 20.0341L7.87495 21.0134C8.24721 21.2247 8.43334 21.3304 8.6004 21.3079C8.76746 21.2854 8.95588 21.0973 9.33271 20.7213C10.7927 19.2644 13.2088 19.2643 14.6689 20.7212C15.0457 21.0973 15.2341 21.2853 15.4012 21.3078C15.5682 21.3303 15.7544 21.2246 16.1266 21.0133L17.8513 20.034C18.2307 19.8187 18.4204 19.711 18.4864 19.5547C18.5525 19.3984 18.4833 19.132 18.3448 18.5991C17.8412 16.6616 19.0609 14.6226 21.011 14.0965Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> en la tarjeta de la automatización para abrir su página de configuración.
3. Actualiza cualquiera de los campos descritos en [Configuraciones](/es/automations/manage#configurations).
4. Haz clic en **Save**.

<div id="delete-a-custom-automation">
  ## Eliminar una automatización personalizada [#eliminar-una-automatización-personalizada]
</div>

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

1. Ve a la página [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard.
2. Haz clic en el botón de configuración <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M15.5 12C15.5 13.933 13.933 15.5 12 15.5C10.067 15.5 8.5 13.933 8.5 12C8.5 10.067 10.067 8.5 12 8.5C13.933 8.5 15.5 10.067 15.5 12Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M21.011 14.0965C21.5329 13.9558 21.7939 13.8854 21.8969 13.7508C22 13.6163 22 13.3998 22 12.9669V11.0332C22 10.6003 22 10.3838 21.8969 10.2493C21.7938 10.1147 21.5329 10.0443 21.011 9.90358C19.0606 9.37759 17.8399 7.33851 18.3433 5.40087C18.4817 4.86799 18.5509 4.60156 18.4848 4.44529C18.4187 4.28902 18.2291 4.18134 17.8497 3.96596L16.125 2.98673C15.7528 2.77539 15.5667 2.66972 15.3997 2.69222C15.2326 2.71472 15.0442 2.90273 14.6672 3.27873C13.208 4.73448 10.7936 4.73442 9.33434 3.27864C8.95743 2.90263 8.76898 2.71463 8.60193 2.69212C8.43489 2.66962 8.24877 2.77529 7.87653 2.98663L6.15184 3.96587C5.77253 4.18123 5.58287 4.28891 5.51678 4.44515C5.45068 4.6014 5.51987 4.86787 5.65825 5.4008C6.16137 7.3385 4.93972 9.37763 2.98902 9.9036C2.46712 10.0443 2.20617 10.1147 2.10308 10.2492C2 10.3838 2 10.6003 2 11.0332V12.9669C2 13.3998 2 13.6163 2.10308 13.7508C2.20615 13.8854 2.46711 13.9558 2.98902 14.0965C4.9394 14.6225 6.16008 16.6616 5.65672 18.5992C5.51829 19.1321 5.44907 19.3985 5.51516 19.5548C5.58126 19.7111 5.77092 19.8188 6.15025 20.0341L7.87495 21.0134C8.24721 21.2247 8.43334 21.3304 8.6004 21.3079C8.76746 21.2854 8.95588 21.0973 9.33271 20.7213C10.7927 19.2644 13.2088 19.2643 14.6689 20.7212C15.0457 21.0973 15.2341 21.2853 15.4012 21.3078C15.5682 21.3303 15.7544 21.2246 16.1266 21.0133L17.8513 20.034C18.2307 19.8187 18.4204 19.711 18.4864 19.5547C18.5525 19.3984 18.4833 19.132 18.3448 18.5991C17.8412 16.6616 19.0609 14.6226 21.011 14.0965Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> 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.