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

# Crear un workflow personalizado

> Crea un workflow personalizado de Mintlify con un trigger programado o de push, repositorios de contexto y un prompt para el agente para automatizar tareas de documentación recurrentes.

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

* Un proyecto de Mintlify conectado a un repositorio de GitHub o GitLab
* Para GitHub: la [Mintlify GitHub App](/es/deploy/github) instalada en cada repositorio que planees usar en el workflow
* Para GitLab: una cuenta de GitLab conectada (consulta [Configuración de GitLab](#gitlab-setup) a continuación)

<div id="create-a-custom-workflow">
  ## Crear un workflow personalizado
</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 hacen referencia a herramientas no disponibles pueden producir resultados inesperados o fallar.
</Note>

1. Abre la página [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) en tu panel.
2. Haz clic en **Create a custom workflow**.
3. Configura el nombre del workflow, el trigger, las instrucciones, los repositorios de contexto, las integraciones y el modo de actualización.
4. Haz clic en **Create workflow**.

<div id="write-effective-instructions">
  ## Escribir instrucciones efectivas
</div>

Las instrucciones efectivas para workflows se centran en una sola tarea y definen un resultado claro y verificable. Los workflows presentan cierta variabilidad porque los agentes son no deterministas, pero las instrucciones bien formateadas producen resultados más consistentes.

* **Describe el resultado.** Indica al agente cómo debe verse el resultado de una ejecución exitosa.
* **Escribe un procedimiento.** Dale al agente una guía paso a paso a seguir.
* **Mantén el alcance acotado.** Divide las tareas complejas en varios workflows en lugar de combinarlas en un solo prompt.

Para más ejemplos y patrones, consulta [Usar workflows](/es/guides/use-workflows).

<Tip>
  Revisa la salida de tus workflows personalizados para confirmar que funcionan como se espera. Actualiza tus instrucciones para mejorar los resultados.
</Tip>

## Configuración de GitLab

Para usar repositorios de GitLab en un workflow, 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 el workflow 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>
  Los workflows 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="delete-a-custom-workflow">
  ## Eliminar un workflow personalizado
</div>

Eliminar un workflow es permanente y borra su configuración e historial de ejecuciones.

1. Ve a la página [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) en tu panel.
2. Haz clic en el botón <Icon icon="settings" /> de configuración junto a un workflow.
3. Haz clic en **Delete**.
