FirstMate: equipos de agentes, evidencia duradera y autoridad de entrega
Arquitectura de FirstMate: un evento persistente no prueba que el agente esté sano
Sigue el estado de tareas, los veredictos semánticos y los eventos ligados a una encarnación sin confundir terminal visible con tarea terminada.
Qué aprenderás
- El endpoint es solo una observación
- Vincula cada evento con su encarnación
- Escala con evidencia y acciones limitadas
Antes de empezar
- Bases de árboles Git y solicitudes de cambios
- Comprender agentes de terminal y alcance de credenciales
Definir entregables e inspeccionar evidencia de estado y autoridad sin atribuir garantías no probadas.
Conclusiones clave
- La existencia del endpoint y el estado semántico son distintos.
- Un evento antiguo no debe gobernar una nueva encarnación.
- Un estado desconocido requiere inspección, no certeza inventada.
El endpoint es solo una observación
El backend crea y direcciona endpoints, captura salida acotada y ofrece operaciones de ciclo de vida. El adaptador del agente aporta actividad semántica. Son capas diferentes: una terminal puede seguir abierta tras morir el agente y un agente silencioso puede estar esperando una herramienta de larga duración.
La arquitectura define busy, idle, unknown y dead junto con la fuente del veredicto. Los registros semánticos ausentes, malformados, obsoletos o sin verificar quedan como unknown, nunca como busy o idle. En esta revisión Codex y Kimi independiente conservan unknown fuera de sondeos explícitos hasta verificar en vivo su fuente semántica.
Vincula cada evento con su encarnación
Al conectar una tarea se genera un token de encarnación al que pertenecen sus registros. Un evento de una ejecución anterior no debe actualizar al nuevo agente. Es el problema habitual de una respuesta tardía después de un reintento: compartir el nombre de tarea no demuestra que la observación siga vigente.
El supervisor y la cola distinguen además vida del endpoint y consumo de eventos. La arquitectura describe filas persistentes y observación del progreso. Un padre que observa la cola de un segundo oficial local no debería asumir su consumo ni reescribir filas solamente porque haya una demora.
Escala con evidencia y acciones limitadas
Un agente aparentemente bloqueado puede seguir escribiendo en su árbol. El supervisor documentado combina estado e inspección acotada, sin convertir CPU, fechas de modificación o silencio en señales universales. Una notificación de atasco solicita inspección, no un reinicio automático que pueda destruir trabajo activo.
Diseña un registro de recuperación con tarea, encarnación, fuente, progreso de cola y siguiente acción autorizada. Mantén desconocidos los campos desconocidos. Inspeccionamos la arquitectura documentada, pero no ejecutamos el supervisor ni reprodujimos recuperación por adaptador; esto no es una medición de fiabilidad.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Registra tarea y encarnación juntas.
- 2
Conserva la fuente de cada observación.
- 3
Inspecciona consumo de cola aparte de la terminal.
- 4
Reúne evidencia antes de una recuperación destructiva.
Ejemplo para copiar
{
"ejemplo": true,
"tarea": "scout-demo",
"encarnacion": "generation-2",
"veredicto": "unknown",
"fuente": "registro semántico ausente",
"siguienteAccion": "inspeccionar",
"reinicioAutorizado": false
}Preguntas frecuentes
¿Un archivo turn-ended antiguo demuestra inactividad?
No. Es una notificación de despertar, no una fuente autoritativa de estado actual.
¿Un aviso de atasco autoriza reiniciar?
No. Pide inspección; la recuperación todavía requiere una acción autorizada.
Fuentes
- FirstMate / docs/architecture.mdFuente verificada 2026-09-14
- FirstMate / docs/configuration.mdFuente verificada 2026-09-14