[!info] related notes

• 上层 MOC: Agent MOC, AI Agent Application MOC
• 核心概念: Agent Runtime
• 相关 MOC: Tool Calling Engineering MOC

Agent Runtime MOC

Agent Runtime 不是”while loop 调模型”。它是包住模型的完整执行环境，负责 Run 生命周期、Step 调度、状态管理、Trace 记录、Checkpoint 持久化、超时控制、取消传播、并发管理和权限边界。

这张地图覆盖什么

• Run 和 Step 的生命周期管理
• 状态机与 Checkpoint
• Trace 与可观测性
• 超时、取消、重试控制
• 并发与背压管理
• 沙箱与权限边界
• 事件协议

推荐阅读顺序

1. Agent Runtime — Runtime 的定义与职责边界
2. Run — 一次任务执行的完整生命周期
3. Step — Run 内的单次推理-动作循环
4. Run State — Run 的状态机定义
5. Trace — 执行链路的追踪记录
6. Checkpoint — 状态持久化与恢复
7. Cancellation — 取消传播机制
8. [[sandbox|Sandbox]] — 工具执行的隔离环境
9. Permission Boundary — 权限边界与越权防护

核心概念分组

生命周期

• Run — 一次任务执行的完整生命周期
• Step — Run 内的单次推理-动作循环
• Run State — Run 的状态机（pending → running → completed/failed/cancelled）
• Run Event — Run 过程中产生的各类事件

状态与持久化

• Checkpoint — 状态快照与恢复
• Trace — 执行链路的追踪记录
• Agent Trace Viewer — Trace 的可视化查看

控制与保护

• Timeout Control — 超时控制策略
• Cancellation — 取消传播机制
• Concurrency Control — 并发控制
• Backpressure — 背压管理
• [[sandbox|Sandbox]] — 工具执行的隔离环境
• Permission Boundary — 权限边界

事件协议

• Run Event — Run 事件
• Heartbeat Event — 心跳事件
• AI 应用流式协议 — 流式协议设计

相关 MOC

• Agent MOC
• AI Agent Application MOC
• Tool Calling Engineering MOC