> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestionar automatizaciones

> Activa, desactiva, ejecuta y elimina automatizaciones desde tu dashboard. Configura activadores, programaciones, repositorios y automerge.

<div id="prerequisites">
  ## Requisitos previos
</div>

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

<Tip>
  También puedes crear, listar y eliminar automatizaciones desde la terminal con [`mint automations`](/es/cli/commands#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.
</Tip>

<div id="enable-an-automation">
  ## Activar una automatización
</div>

1. Abre la página [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard.
2. Haz clic en el interruptor junto a una automatización para activarla.

   <Frame>
     <img src="https://mintcdn.com/mintlify/W02DorBattbLN0HY/images/workflows/workflows-dashboard-light.png?fit=max&auto=format&n=W02DorBattbLN0HY&q=85&s=d62900c82d4940c72eee78e045251794" alt="El dashboard de automatizaciones." className="block dark:hidden" width="2345" height="1197" data-path="images/workflows/workflows-dashboard-light.png" />

     <img src="https://mintcdn.com/mintlify/W02DorBattbLN0HY/images/workflows/workflows-dashboard-dark.png?fit=max&auto=format&n=W02DorBattbLN0HY&q=85&s=69c95f7f445913f8f2d1080f186333c2" alt="El dashboard de automatizaciones." className="hidden dark:block" width="2345" height="1197" data-path="images/workflows/workflows-dashboard-dark.png" />
   </Frame>

   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.

   <Frame>
     <img src="https://mintcdn.com/mintlify/W02DorBattbLN0HY/images/workflows/workflow-settings-light.png?fit=max&auto=format&n=W02DorBattbLN0HY&q=85&s=93039048b3f1c31077c7ec8865eb5969" alt="Las opciones de configuración de una automatización." className="block dark:hidden" width="975" height="1423" data-path="images/workflows/workflow-settings-light.png" />

     <img src="https://mintcdn.com/mintlify/W02DorBattbLN0HY/images/workflows/workflow-settings-dark.png?fit=max&auto=format&n=W02DorBattbLN0HY&q=85&s=5926999c30fcd483e5b0fecb90f5fd03" alt="Las opciones de configuración de una automatización." className="hidden dark:block" width="975" height="1423" data-path="images/workflows/workflow-settings-dark.png" />
   </Frame>
3. Si se abre el panel de configuración, completa los campos obligatorios.
4. 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 <Icon icon="settings" /> junto a ella. Usa el interruptor en el encabezado del modal para activarla o desactivarla sin salir de la vista de configuración.

<div id="configurations">
  ## Configuraciones
</div>

<div id="trigger">
  ### Activador
</div>

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.

<div id="update-mode">
  ### Modo de actualización
</div>

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.

<Note>
  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](/es/guides/configure-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.
</Note>

<div id="context-repositories">
  ### Repositorios de contexto
</div>

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](https://app.mintlify.com/settings/organization/github-app).

<div id="integrations">
  ### Integraciones
</div>

Para automatizaciones personalizadas y la automatización **Update from code changes**, puedes habilitar las [integraciones del agente](/es/agent/integrations) 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](/es/agent/integrations) para más información sobre cómo conectar integraciones.

<div id="slack-notifications">
  ### Notificaciones de Slack
</div>

Envía mensajes de Slack a uno o más canales cuando se ejecuten las automatizaciones.

Para activar las notificaciones de Slack:

1. Instala la [aplicación de Slack de Mintlify](/es/agent/slack) en tu espacio de trabajo.
2. Haz clic en **Turn on Slack notifications** en la página [Automatizaciones](https://app.mintlify.com/products/automations) de tu dashboard.

   <Frame>
     <img src="https://mintcdn.com/mintlify/DfHGw7nkiSuCxbSc/images/workflows/turn-on-slack-notifications-light.png?fit=max&auto=format&n=DfHGw7nkiSuCxbSc&q=85&s=fffed374cd7a186cb8755a3eaf2e741a" alt="El botón para activar las notificaciones de Slack." className="block dark:hidden" width="1751" height="327" data-path="images/workflows/turn-on-slack-notifications-light.png" />

     <img src="https://mintcdn.com/mintlify/DfHGw7nkiSuCxbSc/images/workflows/turn-on-slack-notifications-dark.png?fit=max&auto=format&n=DfHGw7nkiSuCxbSc&q=85&s=51a21e178c81dfe097c4f54aedd3f078" alt="El botón para activar las notificaciones de Slack." className="hidden dark:block" width="1751" height="327" data-path="images/workflows/turn-on-slack-notifications-dark.png" />
   </Frame>
3. Selecciona uno o más canales de notificación.
4. Haz clic en **Save changes**.

Una vez activado, Mintlify publica en los canales seleccionados cuando:

* Una automatización abre una pull request para revisión.
* Una pull request de una automatización lleva tres días esperando revisión.
* Una automatización fusiona una pull request o no logra completarse.

<div id="instructions">
  ### Instrucciones
</div>

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.

<div id="target-languages">
  ### Idiomas de destino
</div>

Cuando activas la automatización **Translate content**, selecciona uno o más idiomas para mantenerlos sincronizados con tu contenido fuente.

* Mintlify lee los [idiomas](/es/organize/navigation#languages) 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**.

<GitlabAutomationSetup />

<div id="disable-an-automation">
  ## Desactivar una automatización
</div>

1. Ve a la página [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard.
2. 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.

<div id="run-an-automation-manually">
  ## Ejecutar una automatización manualmente
</div>

Puedes activar cualquier automatización habilitada bajo demanda sin esperar a su próxima ejecución programada o basada en eventos.

1. Abre la página [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard.
2. Haz clic en el botón de ejecución <Icon icon="play" /> 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.

<div id="view-run-history">
  ## Ver el historial de ejecuciones
</div>

Cada automatización mantiene un registro de las ejecuciones pasadas, incluido el estado y un resumen de los cambios realizados.

1. Ve a la página [Ejecuciones de automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard.
2. Usa los menús desplegables para filtrar por automatizaciones o estado específicos.

   <Frame>
     <img src="https://mintcdn.com/mintlify/W02DorBattbLN0HY/images/workflows/workflow-runs-light.png?fit=max&auto=format&n=W02DorBattbLN0HY&q=85&s=de79d723b5f33b813c300b18bdc8ae04" alt="Página de ejecuciones de automatizaciones con los filtros de automatización y estado." className="block dark:hidden" width="769" height="243" data-path="images/workflows/workflow-runs-light.png" />

     <img src="https://mintcdn.com/mintlify/W02DorBattbLN0HY/images/workflows/workflow-runs-dark.png?fit=max&auto=format&n=W02DorBattbLN0HY&q=85&s=018e78c17176384fbdac65f9677c607d" alt="Página de ejecuciones de automatizaciones con los filtros de automatización y estado." className="hidden dark:block" width="769" height="243" data-path="images/workflows/workflow-runs-dark.png" />
   </Frame>

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.

<div id="continue-a-run-in-the-editor">
  ## Continuar una ejecución en el editor
</div>

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.

1. Abre la página [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard.
2. 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.


## Related topics

- [Vista general de automatizaciones](/es/automations/index.md)
- [Usar automatizaciones](/es/guides/use-automations.md)
- [Automatizaciones predefinidas](/es/automations/reference.md)