Skip to main content

​
Requisitos previos

​
Crear una automatización personalizada

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.
Dentro del sandbox, el agente puede:
  • Leer archivos en tu repositorio de documentación y en cualquier repositorio de contexto conectado.
  • Usar las integraciones compartidas y personales que selecciones como herramientas.
  • Editar archivos MDX y abrir una pull request en tu repositorio de documentación.
El sandbox no puede realizar solicitudes de red salientes arbitrarias, instalar paquetes ni ejecutar comandos de shell más allá de las herramientas que proporciona Mintlify.
  1. Abre la página Automatizaciones en tu dashboard.
  2. Haz clic en Create a custom automation.
  3. Configura la automatización:
    • Nombre: Una etiqueta corta y descriptiva que se muestra en el dashboard y en el historial de ejecuciones.
    • Activador: Cuándo se ejecuta la automatización (actualización de contenido, cambio de código, programación personalizada o evento de integración).
    • Instrucciones: El prompt que sigue el agente en cada ejecución.
    • Repositorios de contexto: Repositorios adicionales que el agente puede leer para obtener más contexto.
    • Integraciones: Integraciones compartidas que el agente puede invocar como herramientas durante la ejecución.
    • Modo de actualización: Cómo propone cambios el agente: abrir una pull request, hacer commit directamente u otro modo.
    Para más detalles sobre cada campo, consulta Configuraciones.
  4. Haz clic en Create automation.

​
Escribir instrucciones eficaces

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.
Revisa la salida de tus automatizaciones personalizadas para confirmar que funcionan como esperabas. Actualiza tus instrucciones para mejorar los resultados.

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

​
Eliminar una automatización personalizada

Eliminar una automatización es permanente y elimina su configuración y el historial de ejecuciones.
  1. Ve a la página Automatizaciones en tu dashboard.
  2. Haz clic en el botón de configuración junto a una automatización.
  3. Haz clic en Delete.