Disparadores de equipo
Inicia agentes de Ingot desde donde tu equipo ya sigue el trabajo: etiqueta una incidencia de GitHub, mueve una tarjeta de Jira, etiqueta una incidencia de Linear o escribe /ingot en Slack. Ingot responde en el mismo hilo con un enlace, el progreso y el resultado.
Qué inicia un agente
| Herramienta | Señales |
|---|---|
| GitHub | Una incidencia o pull request recibe una etiqueta (por defecto ingot), o un comentario dice @ingot <tarea> |
| Jira | Una incidencia pasa a una columna (por ejemplo Ready for agent), recibe una etiqueta, o un comentario dice @ingot |
| Linear | Una incidencia recibe una etiqueta, o un comentario dice @ingot |
| Slack | /ingot <tarea>, o una @mención de tu app de Ingot en un canal |
Cada regla elige una señal, el repositorio en el que trabaja el agente y dónde se ejecuta:
- Agente en la nube: una ejecución de Zaprex en la cuenta del dueño de la regla. Funciona con todos los portátiles cerrados y abre un pull request cuando cambia código.
- Ingot del dueño: un chat nuevo en el Ingot en marcha del dueño de la regla (la app de escritorio o
ingot serve), por la misma conexión que usa Ingot Remote. Si su Ingot no está en marcha, el hilo lo sabe y no se inicia nada.
Qué ve el hilo
- On it (en marcha), con un enlace para seguir la ejecución (nube) o el nombre del dueño (su Ingot).
- El mismo mensaje se actualiza a medida que avanza. Cuando un paso de riesgo necesita aprobación, una nota corta dice que la ejecución está esperando.
- Done (hecho), con el resumen del agente y el enlace al pull request, o el motivo por el que se detuvo.
Responde en el hilo para guiarlo. En GitHub, Jira y Linear, menciona @ingot en la respuesta; en Slack, cuenta cualquier respuesta bajo el mensaje de Ingot. Una respuesta llega enseguida a un chat que se ejecuta en el Ingot del dueño. Una ejecución en la nube la recibe como ejecución de seguimiento en cuanto termina la actual, con el resumen anterior y tu respuesta.
Configúralo
Necesitas un equipo (Panel › Equipo) y ser su propietario o administrador. Abre Panel › Integraciones › Disparadores.
GitHub
- Haz clic en Conectar en la tarjeta de GitHub. Pega un token para las respuestas: un token de acceso detallado con Issues: Read and write en los repositorios, o un token de instalación de tu propia GitHub App. Sin token, las ejecuciones se inician igual, pero Ingot no puede comentar.
- Copia la URL del webhook y el Secreto del webhook que muestra Ingot.
- En GitHub: Settings › Webhooks › Add webhook del repositorio (u organización). Payload URL: la URL del webhook. Content type:
application/json. Secret: el secreto del webhook. Eventos: Issues, Issue comments y Pull requests.
Jira
- Haz clic en Conectar en la tarjeta de Jira y completa la URL de tu sitio (
https://tu-equipo.atlassian.net), el correo de la cuenta con la que responde Ingot y un token de API de esa cuenta (id.atlassian.com › Security › API tokens). - Copia la URL del webhook y el Secreto del webhook.
- En Jira: Settings › System › WebHooks › Create a WebHook. URL: la URL del webhook. Secret: el secreto del webhook. Eventos: Issue updated y Comment created. Si quieres, acótalo con JQL (por ejemplo
project = SHOP).
Linear
- Haz clic en Conectar en la tarjeta de Linear. Puedes pegar ahora una clave de API de Linear para las respuestas (Settings › API › Personal API keys) o más tarde.
- Copia la URL del webhook.
- En Linear: Settings › API › Webhooks › New webhook. URL: la URL del webhook. Tipos de recurso: Issues y Comments. Linear muestra un signing secret.
- De vuelta en Ingot, haz clic en Actualizar credenciales en la tarjeta de Linear y pega el secreto de firma. Hasta entonces, las llamadas de Linear se rechazan.
Slack
- Haz clic en Conectar en la tarjeta de Slack y copia la URL del webhook.
- Crea una app de Slack para tu espacio de trabajo (api.slack.com/apps › Create New App › From a manifest) y pega esto, con tu URL del webhook en los dos sitios:
display_information:
name: Ingot
features:
bot_user:
display_name: Ingot
slash_commands:
- command: /ingot
url: <your Ingot webhook URL>
description: Start an Ingot agent
usage_hint: fix the flaky login test
oauth_config:
scopes:
bot:
- commands
- chat:write
- app_mentions:read
- channels:history
- groups:history
- users:read
- users:read.email
settings:
event_subscriptions:
request_url: <your Ingot webhook URL>
bot_events:
- app_mention
- message.channels
- message.groups
- Instala la app en el espacio de trabajo. Copia el Signing Secret (Basic Information) y el Bot User OAuth Token (
xoxb-…, OAuth & Permissions). - En Ingot, haz clic en Actualizar credenciales en la tarjeta de Slack y pega los dos. Si Slack dijo que la Request URL no está verificada, abre Event Subscriptions en la app y haz clic en Retry: Ingot responde en cuanto el secreto de firma está guardado.
- Invita a la app a los canales donde quieras usarla (
/invite @Ingot).
Añade una regla
Haz clic en Añadir regla, elige la fuente, un nombre y la señal, y completa la etiqueta, la columna o la palabra de mención (ingot por defecto). Solo en limita una regla a un repositorio de GitHub (propietario/nombre), una clave de proyecto de Jira, una clave de equipo de Linear o un id de canal de Slack. Elige el repositorio (uno de tus repositorios de Zaprex) y dónde se ejecuta, y añade instrucciones para el agente si quieres, como «Mantén los pull requests pequeños».
El interruptor de la columna Activa apaga y enciende una regla sin eliminarla.
Quién puede iniciar un agente
Solo los miembros de tu equipo. Ingot reconoce a la persona que etiquetó, comentó o escribió el comando:
- por una cuenta vinculada (Integraciones › Disparadores › Cuentas vinculadas: los administradores vinculan a cualquiera del equipo, los miembros se vinculan a sí mismos),
- por correo, cuando la herramienta lo comparte (usuarios de Jira y Linear, perfiles de Slack con el correo visible),
- por su inicio de sesión con GitHub en Ingot.
Los demás reciben un amable no en el hilo (en Slack, solo lo ven ellos). No se inicia nada.
Seguridad y límites
- Cada webhook está firmado: GitHub y Jira con el secreto que generó Ingot, Slack con su secreto de firma, Linear con su secreto de firma y una marca de tiempo. Las llamadas sin firma o repetidas se rechazan.
- Un webhook reenviado nunca inicia una segunda ejecución.
- El texto de incidencias, comentarios y Slack llega al agente solo como descripción de la tarea, nunca como instrucciones que cambien sus reglas.
- Las ejecuciones usan el plan, los minutos y los límites del dueño de la regla. Los pasos de riesgo siguen esperando la aprobación del dueño en Zaprex: nadie puede aprobar desde un hilo. Se aplican los topes de gasto y la pausa del administrador.
- Límites de frecuencia: 6 inicios por persona cada 10 minutos, 30 por fuente cada hora.
- Los comentarios del propio Ingot y otros bots nunca inician ni continúan una ejecución.
Solución de problemas
| Ves | Qué hacer |
|---|---|
| No pasa nada | Revisa las entregas del webhook en la herramienta. 401 significa que el secreto no coincide; 503, que el secreto aún no está guardado en Ingot. Comprueba que la regla está activa y que su Solo en coincide. |
| La ejecución empieza pero Ingot nunca responde | La fuente no tiene token de respuesta, o el token no puede comentar. La tarjeta dice Sin token de respuesta. |
| «Only members of … can start agents» | Vincula la cuenta de la persona en Cuentas vinculadas, o invítala al equipo. |
| «…'s Ingot is not running right now» | La regla se ejecuta en el equipo del dueño. Inicia su Ingot o cambia la regla a Agente en la nube. |
| «Could not start an agent: …» | Se agotaron el plan, los minutos o las ejecuciones simultáneas del dueño de la regla, o un administrador pausó los agentes. |
.ingot/automations/ se explican en Automatizaciones. Los disparadores de equipo no necesitan archivos en el repositorio.