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

# Crear una automatización personalizada

> 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](/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
</div>

* Un proyecto de Mintlify conectado a un repositorio de GitHub, GitLab o Bitbucket
* 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)
* Para Bitbucket: una cuenta de Bitbucket conectada (consulta [Configuración de Bitbucket](#bitbucket-setup) más abajo)

<div id="create-a-custom-automation">
  ## 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 **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](/es/automations/manage#configurations).
4. Haz clic en **Create automation**.

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

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

## 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="bitbucket-setup">
  <div id="bitbucket-setup">
    ## Configuración de Bitbucket
  </div>

  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.

  <div id="configure-a-bitbucket-deployment">
    ### Configurar un deployment de Bitbucket
  </div>

  1. Abre [Configuración de Git](https://app.mintlify.com/settings/deployment/git-settings) en tu dashboard, selecciona **Connect to Bitbucket** y haz clic en **Continue**.
  2. 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.
  3. Haz clic en **Connect Bitbucket** y autoriza a Mintlify a acceder a tu espacio de trabajo y repositorio.
  4. 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`.
  5. 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.
</div>

<div id="delete-a-custom-automation">
  ## 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="settings" /> junto a una automatización.
3. Haz clic en **Delete**.