Misiones
Una misión lleva un objetivo desde el plan hasta la pull request. El agente escribe un plan, tú lo revisas, y después trabaja paso a paso y ejecuta las comprobaciones de tu proyecto después de cada paso. Al final recibes una prueba de lo que cambió y un botón Ship que abre la pull request.
Empezar una misión
Escribe /mission <objetivo> en el chat del agente. También está en el menú /.
Primero el agente lee el proyecto en un turno de solo lectura y después escribe un plan:
- el objetivo
- los archivos que espera tocar
- los pasos, cada uno con los archivos que toca
- las pruebas que añadirá o ejecutará
- los riesgos
Revisar el plan
La tarjeta Mission encima del cuadro del chat muestra el plan con tres botones:
- Approve and run empieza el primer paso.
- Edit plan abre el plan como texto plano con el mismo formato. Ctrl/Cmd+Enter guarda y Escape cancela.
- Cancel descarta la misión.
Marca Let missions run without plan review para saltarte esta tarjeta y empezar en cuanto el plan esté escrito.
Paso a paso
Cada paso se ejecuta como un turno propio del agente. Después del paso, Ingot ejecuta las comprobaciones del proyecto que encontró:
- los scripts
gate,test,lintytypecheckdepackage.json - o el comando de pruebas del manifiesto del proyecto, como
pytest,go testocargo test
Una comprobación que falla se convierte en un turno de corrección: el agente recibe el fallo y lo corrige, y después las comprobaciones se ejecutan de nuevo. Un paso puede tomar hasta 3 turnos de corrección (un ajuste). Si las comprobaciones siguen fallando, la misión se detiene y explica por qué.
Los pasos se marcan en directo en la tarjeta y en la lista de tareas del chat.
Las ediciones siguen pasando por la revisión del agente (Accept / Reject) salvo que la aceptación automática esté activada. Las comprobaciones se ejecutan cuando ya has decidido las ediciones del paso.
Prueba
Cuando la misión termina, la tarjeta muestra la prueba:
- qué cambió, con las líneas añadidas y quitadas por archivo
- el último resultado de cada comprobación
- los archivos cambiados fuera del plan
- los pasos que no se hicieron
- los riesgos del plan
El plan y la prueba se guardan en .ingot/artifacts/missions/<fecha>-<objetivo>.md. La estructura del proyecto mantiene esta carpeta fuera de git.
Ship
Una misión terminada llega hasta la pull request. Haz clic en Ship: commit, push and open a pull request en la prueba, o deja que ocurra solo en una misión verificada con el ajuste de después de la misión en enviar automáticamente. Ingot:
- crea
feature/<objetivo>, salvo que ya estés en una rama de feature - hace commit solo de los archivos que cambió la misión, con el trailer de atribución (
Co-Authored-By: Ingot) - hace push con upstream
- abre una pull request cuya descripción es el plan y la prueba, a través de tu cuenta conectada de Git Hosts
Sin una cuenta conectada, enlaza la página de nueva pull request del proveedor. Consulta Ship.
Con Follow PR to green activado, el agente vigila después la pull request y corrige los fallos de CI y los comentarios de revisión.
Mapa del proyecto
Cada ejecución del agente, también las misiones, empieza con un resumen ordenado del proyecto abierto:
- lenguajes y frameworks
- puntos de entrada
- comandos de compilación y de pruebas
- carpetas principales
- los archivos más importados, con sus nombres exportados
Cabe en 2.000 tokens por defecto. Ingot lo construye en el backend, lo guarda en caché y lo reconstruye unos segundos después de que cambien los archivos. Ejecuta Ingot: Show Project Map para escribirlo en .ingot/cache/repo-map.md y abrirlo.
Herramientas de símbolos
Dos herramientas del agente encuentran código por su nombre:
| Herramienta | Qué devuelve |
|---|---|
ingot/find_symbol | dónde se declara una función, clase, tipo o variable: símbolos del espacio de trabajo de los servidores de lenguaje más una búsqueda de declaraciones |
ingot/document_symbols | el esquema de un archivo |
Cuando ningún servidor de lenguaje cubre el archivo, las dos recurren a una búsqueda de declaraciones y lo indican.
Ejecutar una misión sin interfaz
ingot agent run ejecuta una misión desde la línea de comandos, para CI y scripts. Usa los mismos prompts, el mismo motor de misiones y el mismo mapa del proyecto que el IDE.
Por ahora se ejecuta desde una copia del repositorio de Ingot con npm run ingot -- agent run …; la CLI ingot instalada lo recibirá en una próxima versión.
ingot agent run --task <archivo> [--repo <carpeta>] [--json]
- La misión se ejecuta en una carpeta temporal, un worktree de git separado de
--repo. La carpeta se borra al terminar;--keepla conserva. - La ejecución se puntúa por el resultado completo: la funcionalidad funciona (pruebas ocultas copiadas después de la ejecución), las comprobaciones del proyecto pasan, hay una pull request abierta con la prueba y el diff no se sale del alcance. La puntuación también muestra los pasos hechos, los turnos de corrección, los tokens y el tiempo.
--jsonla imprime como JSON. - Por defecto la pull request se registra en un repositorio bare junto a la carpeta temporal.
--ship ghhace push aoriginy ejecutagh pr createen su lugar. - Elige el modelo con
--model anthropic/<id>(ANTHROPIC_API_KEY),--model openrouter/<id>(OPENROUTER_API_KEY) o--model ingot/<id>(INGOT_EVAL_TOKEN, con--server), o defineINGOT_AGENT_MODEL. Sin la clave, la ejecución indica skipped.
Ajustes
En Settings › Agent tools › Missions:
| Ajuste | Valor por defecto |
|---|---|
| Misiones activadas o desactivadas | Activado |
| Let missions run without plan review | Desactivado |
| Turnos de corrección por paso | 3 |
Ejecutar peticiones de varios pasos como misiones sin /mission | Desactivado |
| Después de la misión: botón Ship, enviar automáticamente o nada | Botón Ship |
En Settings › Agent tools › Project map: activado o desactivado, y su tamaño (2.000 tokens por defecto).
Settings › Features y la configuración inicial lo muestran como Missions.
La app de escritorio y el navegador funcionan igual.