Motor de bucle del Agent

Descripción general

El motor de bucle del Agent (Agent Loop) es el mecanismo de ejecución central del módulo Work del espacio de trabajo. Impulsa al AI Agent para que realice un bucle autónomo de razonamiento-ejecución: analiza la tarea → selecciona la herramienta → ejecuta la operación → evalúa el resultado → continúa razonando, hasta que la tarea se completa o se activa una condición de salida.

El motor adopta una arquitectura provider-agnostic y admite múltiples proveedores de modelos mediante una interfaz unificada de LLM Adapter.

Arquitectura

Adaptador de LLM

                      
                      AgentEngine
    │
    ├── OpenAIAdapter
    │   ├── Responses API（增量状态管理）
    │   └── Chat Completions API（全量上下文）
    │
    └── AnthropicAdapter
        └── Messages API（原生 streaming + thinking）

                    

El adaptador procesa automáticamente:

• Conversión del formato de mensajes (OpenAI ↔ Anthropic)
• Conversión de las definiciones de herramientas
• Procesamiento de Think Tag (elimina automáticamente las etiquetas <think> de modelos como DeepSeek)

Flujo del bucle

                      
                      ┌─ 预检验证 ──────────────────────────────────────────────┐
│ 拒绝超过输入预算 60% 的提示词，防止静默截断              │
└──────────────────────────┬──────────────────────────────┘
                           ▼
┌─ 主循环（Round 0 → maxTurns-1）─────────────────────────┐
│                                                          │
│  ① 上下文管理                                            │
│     - 预防性工具结果截断（Layer 1）                        │
│     - 检查是否需要压实（shouldPreemptiveCompact）          │
│                                                          │
│  ② LLM 调用                                              │
│     - 流式推理（text_delta + thinking + tool_use）        │
│     - 事件实时推送到 UI                                   │
│                                                          │
│  ③ 工具执行                                              │
│     - validateToolCalls → 验证合法性                      │
│     - 并发分区 → 按 concurrency 元数据分组                │
│     - 并行执行 → 结果归一化                               │
│                                                          │
│  ④ 退出判断                                              │
│     - 无工具调用 → 退出（end_turn）                       │
│     - 达到限制 → 退出（max_rounds/max_budget/deadline）   │
│     - 异常 → 退出（circuit_breaker/fatal_error）          │
│     - 有工具调用 → 继续下一轮                             │
│                                                          │
└──────────────────────────────────────────────────────────┘

                    

Parámetros del bucle

8 condiciones de salida

Mecanismo de disyuntor

Evita que los fallos consecutivos del LLM provoquen reintentos infinitos:

Clasificación de errores y estrategia de reintento:

Eventos de streaming

El proceso de ejecución del Agent notifica a la UI en tiempo real mediante eventos de streaming:

Los eventos de los subagentes se transmiten a la interfaz de UI del Agent padre.

Calibración de tokens EMA

El motor utiliza la media móvil exponencial (EMA) para calibrar dinámicamente la precisión de la estimación de tokens:

Después de cada llamada al LLM, el factor de calibración se actualiza con el consumo real de tokens, garantizando que la estimación del presupuesto de contexto sea cada vez más precisa.

Instantáneas de sesión

Admite la persistencia del estado de la sesión para evitar la pérdida de progreso ante interrupciones inesperadas:

Las instantáneas se almacenan como archivos JSON y usan escritura atómica (.tmp + rename) para evitar la corrupción de archivos. Mediante resumeSessionId se puede reanudar una sesión interrumpida.

Qué significa para el usuario

Agent Loop es la capacidad de sentir que "el Agent está trabajando de forma continua". Cuando dices "ayúdame a refactorizar la estructura del código de este proyecto", el Agent no se detiene tras darte una sola sugerencia: navega automáticamente por los archivos, analiza la estructura, los modifica uno a uno y ejecuta pruebas, hasta completar la tarea.

Fenómenos que puedes observar:

• El Agent llama a varias herramientas de forma consecutiva (listar archivos → leer archivos → modificar archivos → ejecutar pruebas), y las llamadas a herramientas aparecen una tras otra en la interfaz
• Si el Agent falla 5 veces seguidas (por ejemplo, por un timeout de la API), se detendrá 60 segundos en lugar de reintentar infinitamente: verás una pausa tras la cual el Agent te informará de que ha encontrado un problema
• Por defecto ejecuta como máximo 25 rondas; las tareas extremadamente complejas pueden detenerse tras 25 rondas e informarte de que "se ha alcanzado el número máximo de rondas"

Qué puedes hacer:

• Pulsar el botón Detener en cualquier momento para abortar la ejecución del Agent
• Si el Agent se desvía de la dirección correcta, abórtalo y dale instrucciones más precisas
• Para tareas especialmente complejas, puedes pedir al Agent que primero elabore un plan antes de ejecutar ("elabora primero un plan y ejecútalo después de que yo lo confirme")

Documentos relacionados

• Estrategia de compresión de contexto en 5 capas — Explicación detallada de la gestión de contexto
• Sistema de memoria tridimensional — Inyección y consulta de memoria
• Interacción conversacional de Work — Experiencia del Agent Loop en la interfaz de usuario