Beta Próximamente. Esta función aún está en desarrollo; los nombres y detalles pueden cambiar antes del lanzamiento.

Automatizaciones

Las automatizaciones inician un agente con un pull request, un comentario, un fallo de CI, Slack, un webhook o un horario, y lo mantienen hasta cumplir una meta.

Cada automatización es un archivo Markdown en .ingot/automations/: vive en tu repositorio y se revisa como el código. Se ejecuta en el IDE de Ingot abierto (run: local) o en un agente de Ingot en la nube aunque el IDE esté cerrado (run: cloud).

El panel Automations: tres automatizaciones con sus disparadores y su meta, y el historial con Goal met y DoneEl panel Automations: tres automatizaciones con sus disparadores y su meta, y el historial con Goal met y Done
El panel Automations: tres automatizaciones con sus disparadores y su meta, y el historial con Goal met y Done

Un archivo de automatización

---
name: Fix failing CI
on: [ci_failure]
branches: [main]
run: local
goal: CI passes again
done_when: [the failing tests pass locally, no unrelated changes]
check: npm test
max_iterations: 3
---
CI failed: {{title}}.
Find the failing job, reproduce it locally, make the smallest safe fix and run the tests again.

El nombre del archivo es el id de la automatización (fix-ci.md es fix-ci). El texto después del frontmatter es el prompt. {{title}}, {{body}}, {{branch}}, {{base}}, {{url}}, {{author}}, {{number}}, {{repo}}, {{workflow}}, {{sha}} y {{channel}} se completan con el evento. El texto externo (el cuerpo de un PR, un comentario, un mensaje de Slack) se marca como datos no confiables, así que el agente nunca sigue instrucciones escondidas en él.

ClavePor defectoQué hace
onobligatoriauno o más disparadores (abajo)
runlocallocal: el IDE abierto inicia un chat con el agente. cloud: una ejecución de un agente de Ingot en la nube
enabledtruefalse conserva el archivo pero nunca lo inicia
repoel origin del proyectoowner/name: solo eventos de ese repositorio de GitHub
branchescualquieraglobs de la rama base para pr, de la rama head para ci_failure
pr_actionsopened, reopened, ready_for_reviewtambién synchronize, edited, closed
mention@ingotcomment necesita este texto; "" acepta cualquier comentario
workflowscualquieraci_failure: globs del nombre del workflow o del check
slack_channel, keywordcualquieraslack: un canal (#eng o C0123…); keyword debe aparecer en el mensaje (también para webhook)
cron, timezonecron: cinco campos (0 3 * * *) o @daily; al menos 5 minutos de separación. La nube usa UTC salvo que indiques timezone
cooldown10minutos antes de que la misma automatización vuelva a iniciarse
modelel predeterminadoel modelo del agente

Disparadores

DisparadorSe inicia con
prun pull request abierto, reabierto o listo para revisión (pull_request de GitHub)
commentun comentario en un PR o issue, o de revisión, que menciona @ingot
ci_failureuna ejecución o check de GitHub Actions fallido o con tiempo agotado (workflow_run, check_run, check_suite)
slackuna mención a @Ingot, el comando /ingot o un mensaje del canal con la keyword
webhookun POST a la URL de webhook de la automatización (cualquier JSON o texto)
cronel horario

Los eventos enviados por bots, o por el propio Ingot, nunca inician una automatización, así que no puede dispararse a sí misma en bucle. La misma entrega (la misma ejecución de CI, comentario o actualización de PR) inicia una automatización una sola vez.

Mantener una meta hasta cumplirla

Con goal, el agente sigue trabajando hasta cumplir la meta o agotar max_iterations turnos (5 por defecto, 20 como máximo):

  1. El agente trabaja en el prompt con la meta y los criterios done_when a la vista.
  2. Ingot ejecuta check (un comando como npm test), que debe terminar con 0.
  3. Si falla, el agente recibe la salida del check y lo intenta otra vez.
  4. El disparo termina como Goal met, o Gave up cuando se acaban los turnos.

En el IDE es el modo meta del chat: el banner de la meta muestra cada criterio, el resultado del check y los turnos usados. En la nube, cada intento es una ejecución nueva que empieza con la salida del check que falló.

El chat de una automatización en el IDE: el check de la meta falló, luego pasó, y el banner dice DoneEl chat de una automatización en el IDE: el check de la meta falló, luego pasó, y el banner dice Done
El chat de una automatización en el IDE: el check de la meta falló, luego pasó, y el banner dice Done

En el IDE

Abre Automations en el panel inferior (Alt+Shift+N en Windows y Linux, ⌘⌥⇧N en macOS). Muestra cada automatización con sus disparadores, dónde se ejecuta y su meta, y el historial de cada disparo: qué lo inició, los turnos usados y el resultado. Show Chat abre el chat del agente de un disparo.

AcciónmacOSWindows / Linux
Panel Automations⌘⌥⇧NAlt+Shift+N
New Automation… (desde una plantilla o un formulario en blanco)⌘⌥⇧CCtrl+Alt+Shift+C
Run Automation Now…⌘⌥JCtrl+Alt+J
Send Test Event to Automations…⌘⌥GCtrl+Alt+G

Todas las acciones están también en Find Action, junto con Copy Automation Webhook URL, Copy GitHub Webhook Secret for Automations, Set Slack Signing Secret for Automations, Sync Cloud Automations, Reload Automations y Clear Automation History. Los ajustes están en Settings › Automations: el interruptor general, el receptor local y su puerto (7391), cuántas automatizaciones pueden ejecutarse a la vez (2) y las notificaciones.

GitHub, Slack y webhooks

Las automatizaciones locales escuchan en un receptor dentro del IDE en http://127.0.0.1:7391:

  • /github: agrega un webhook de GitHub (Settings › Webhooks del repositorio) con content type application/json y el secreto de Copy GitHub Webhook Secret for Automations. Elige Pull requests, Issue comments, Pull request review comments, Workflow runs y Check runs.
  • /slack: la request URL del Events API y la URL del slash command de tu app de Slack; guarda su signing secret con Set Slack Signing Secret for Automations.
  • /hooks/<id>: cualquier herramienta puede hacer POST aquí con el token de Copy Automation Webhook URL (Authorization: Bearer <token> o ?token=).

GitHub y Slack no llegan a 127.0.0.1 directamente: reenvía con un túnel (por ejemplo gh webhook forward) o usa run: cloud.

Las automatizaciones en la nube tienen URLs públicas en el servidor de Ingot. Sync Cloud en el panel (o ingot automations sync) sube los archivos run: cloud y muestra las URLs:

HookURLFirmado con
GitHub/api/bot/automations/hooks/<key>/githubtu secreto de webhook de GitHub (X-Hub-Signature-256)
Slack/api/bot/automations/hooks/<key>/slackel signing secret de tu app de Slack
Webhook/api/bot/automations/hooks/<key>/hooks/<id>tu token de webhook

Las llamadas sin firma se rechazan. Las automatizaciones en la nube necesitan un plan con agentes de Zaprex en la nube (Silver, Gold o Platinum) y usan sus minutos, aprobaciones y límites.

Desde la terminal

npx @ingotide/cli automations                     # lista: disparadores, dónde se ejecuta, meta, próxima ejecución
npx @ingotide/cli automations validate            # revisa cada archivo; sale con 1 si hay errores (CI)
npx @ingotide/cli automations new --template fix-ci
npx @ingotide/cli automations test --github workflow_run payload.json --show-prompt
npx @ingotide/cli automations sync                # sube las automatizaciones run: cloud
npx @ingotide/cli automations run fix-ci          # Run Now en la nube
npx @ingotide/cli automations fires               # disparos recientes en la nube e intentos de la meta

test funciona sin conexión: muestra qué automatizaciones inicia un evento de ejemplo de GitHub, Slack, webhook u horario, y por qué las demás no. Los comandos de la nube necesitan un token de acceso personal (--token o INGOT_TOKEN). Todas las opciones están en CLI.

Seguridad

  • El agente de una automatización tiene las mismas herramientas, sandbox y aprobaciones que un chat que inicias tú; un paso riesgoso sigue esperando tu aprobación.
  • Como máximo 2 automatizaciones locales se ejecutan a la vez (Settings › Automations); un evento que llega mientras están ocupadas se omite y se le dice el motivo al remitente.
  • Apaga todas las automatizaciones en Settings › Automations, o una con su casilla en el panel (esto escribe enabled: false en el archivo).
  • Los secretos viven en el almacén de claves del IDE o cifrados en el servidor, nunca en los archivos.