Saltar al contenido principal
Una automatización personalizada ejecuta al agente según un calendario, en respuesta a pushes al repositorio, cuando ocurre un evento en una integración conectada o cuando llega una solicitud de webhook entrante, utilizando instrucciones que tú escribes. Usa una automatización personalizada cuando necesites un comportamiento que no cubra una automatización predefinida, 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.

​
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.
  1. Abre la página Automatizaciones en tu dashboard.
  2. Haz clic en New automation.
  3. En la página de configuración, define el nombre de la automatización, el activador, el prompt, los repositorios de contexto, las integraciones y el modo de actualización. Para más detalles sobre cada campo, consulta Configuraciones.
  4. Haz clic en Save.
También puedes pedirle al agente en Slack que cree una automatización por ti describiendo lo que quieres que haga.

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

​
Abrir varias pull requests o añadir cambios a las abiertas

Cada ejecución de una automatización personalizada puede abrir cero, una o varias pull requests. El agente abre pull requests separadas cuando el trabajo se divide en cambios independientes que debes revisar por separado. Cada pull request parte de tu rama de despliegue, por lo que no incluye commits de las demás. De forma predeterminada, cada ejecución abre nuevas pull requests. Para que el agente añada commits a una pull request que abrió una ejecución anterior de la misma automatización, indícalo explícitamente en tus instrucciones. El agente ve hasta cinco de las pull requests abiertas de la automatización. Solo puede añadir cambios o actualizar pull requests que abrió la misma automatización.
Example instructions

​
Probar tu automatización

Prueba una automatización nueva con una ejecución manual para no tener que esperar a que ocurra su activador. Las ejecuciones manuales usan la configuración actual de la automatización y aparecen en el historial de ejecuciones junto a las ejecuciones automatizadas. No puedes ejecutar manualmente automatizaciones con activador de integración o de webhook; en su lugar, envía un evento o una solicitud de webhook. Consulta Ejecutar una automatización manualmente para elegir el alcance de una ejecución de prueba. Revisa la ejecución en el historial de ejecuciones para ver el prompt, los archivos que cambió el agente y cualquier pull request que haya abierto. Si el resultado no es el que esperabas, actualiza tus instrucciones y vuelve a ejecutarla.

​
Configuración de GitLab

Para usar repositorios de GitLab en una automatización, conecta cada proyecto en la sección GitLab OAuth de la página de ajustes de Git. Conecta cada repositorio que la automatización utilice, incluido 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.

​
Editar una automatización personalizada

  1. Abre la página Automatizaciones en tu dashboard.
  2. Haz clic en el botón de configuración en la tarjeta de la automatización para abrir su página de configuración.
  3. Actualiza cualquiera de los campos descritos en Configuraciones.
  4. Haz clic en Save.

​
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 en la tarjeta de la automatización para abrir su página de configuración.
  3. Haz clic en Delete automation en la parte inferior de la página y confirma.

Temas relacionados

Vista general de automatizacionesUsar automatizacionesDespliega en una subruta con Vercel