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

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

HerramientaSeñales
GitHubUna incidencia o pull request recibe una etiqueta (por defecto ingot), o un comentario dice @ingot <tarea>
JiraUna incidencia pasa a una columna (por ejemplo Ready for agent), recibe una etiqueta, o un comentario dice @ingot
LinearUna 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

  1. On it (en marcha), con un enlace para seguir la ejecución (nube) o el nombre del dueño (su Ingot).
  2. 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.
  3. 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

  1. 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.
  2. Copia la URL del webhook y el Secreto del webhook que muestra Ingot.
  3. 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

  1. 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).
  2. Copia la URL del webhook y el Secreto del webhook.
  3. 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

  1. 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.
  2. Copia la URL del webhook.
  3. En Linear: Settings › API › Webhooks › New webhook. URL: la URL del webhook. Tipos de recurso: Issues y Comments. Linear muestra un signing secret.
  4. 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

  1. Haz clic en Conectar en la tarjeta de Slack y copia la URL del webhook.
  2. 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
  1. Instala la app en el espacio de trabajo. Copia el Signing Secret (Basic Information) y el Bot User OAuth Token (xoxb-…, OAuth & Permissions).
  2. 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.
  3. 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:

  1. por una cuenta vinculada (Integraciones › Disparadores › Cuentas vinculadas: los administradores vinculan a cualquiera del equipo, los miembros se vinculan a sí mismos),
  2. por correo, cuando la herramienta lo comparte (usuarios de Jira y Linear, perfiles de Slack con el correo visible),
  3. 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

VesQué hacer
No pasa nadaRevisa 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 respondeLa 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.
Las automatizaciones del repositorio que guardas en .ingot/automations/ se explican en Automatizaciones. Los disparadores de equipo no necesitan archivos en el repositorio.