Skip to main content

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.

Requisitos previos

  • Un proyecto de Mintlify conectado a un repositorio de GitHub o GitLab
  • Para GitHub: la Mintlify GitHub App instalada en cada repositorio que planees usar en el workflow
  • Para GitLab: una cuenta de GitLab conectada (consulta Configuración de GitLab a continuación)

Crear un workflow personalizado

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.
  1. Abre la página 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 y el modo de actualización.
  4. Haz clic en Create workflow.

Escribir instrucciones efectivas

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.
Revisa la salida de tus workflows personalizados para confirmar que funcionan como se espera. Actualiza tus instrucciones para mejorar los resultados.

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

Eliminar un workflow personalizado

Eliminar un workflow es permanente y borra su configuración e historial de ejecuciones.
  1. Ve a la página Workflows en tu panel.
  2. Haz clic en el botón de configuración junto a un workflow.
  3. Haz clic en Delete.