编排器时间线
本文按时间顺序整理默认聊天编排器及其共享运行时基础设施的演进。重点关注聊天运行时选择、阶段编排、模型路由、人与 AI 切换、checkpoint、Skill / MCP / RAG 集成与最终生成约束。
相关当前态文档：
纳入范围
本页优先记录：
- 聊天运行时的选择模型变化
- 顶层编排职责与内部 capability pipeline 的变化
- 模型路由、human takeover、checkpoint、evaluation 复用等运行时能力
本页不单独记录：
- 不改变执行链的 API 包装层调整
- 纯前端控制台改版
- 只影响某个子能力实现但不改变编排边界的微调
当前结论
当前编排器已经从较直接的 LangGraph 聊天流，演进为：
顶层 LangGraph 状态路由 + 共享 RuntimeKernel / CapabilityPipeline + RAG / memory / Skill / MCP / generation 串联 + agent 级运行时选择 + 角色化模型路由 + response grounding + observability
演进时间线
| 日期 | Commit | 主题 | 变化 |
|---|---|---|---|
| 2026-03-04 | af6c02e |
Skill runtime v1 | Skill 进入聊天运行时，编排器开始承担不仅是 RAG + LLM，还要协调能力执行链。 |
| 2026-03-11 | 4988489 |
Chat orchestrator support | 聊天编排器开始显式成为一层可配置运行时，而不只是固定实现。 |
| 2026-03-11 | 86eca6b |
Langfuse 观测 | 编排链路接入 Langfuse tracing，为阶段级可观测性打基础。 |
| 2026-03-12 | 3ecd292 |
LangGraph ReAct runtime plugin | 新增 langgraph_react_agent_v1，让实验性 ReAct 运行时与默认聊天运行时并存。 |
| 2026-03-14 | 7a471f2 |
Checkpoint 与 memory | 编排器新增 runtime checkpoint 和 memory support，运行状态与恢复能力增强。 |
| 2026-03-16 | a79c1d1 |
Role-based model routing | 引入按阶段角色选模型的机制，工具调用与最终生成开始分离用模。 |
| 2026-03-17 | 3d1607f |
Human takeover | 编排器不再只处理 AI_ACTIVE，开始支持 human takeover 与 AI / Human 切换。 |
| 2026-03-19 | 30af75b |
Evaluation ephemeral session | 离线评测 turn 开始通过 ephemeral session 进入同一聊天运行时主链。 |
| 2026-03-20 | 408f4db |
Conversation-defined timer runtime | 对话定义定时任务进入运行时，编排器开始承担 scheduler 相关阶段。 |
| 2026-03-26 | 7ca8b76 |
RAG source visibility toggle | hide_rag_source_filename 进入 chat agent 配置，说明编排器开始更细致地控制“注入给模型的上下文长什么样”。 |
| 2026-03-31 | 09ed8b3 |
Agent-scoped MCP runtime config | MCP runtime config 成为 chat agent 级运行时输入的一部分。 |
| 2026-04-01 | 7ad64b9 |
非成功 MCP outcome 注入生成上下文 | skipped / blocked / failed 等 MCP 结果不再只是日志，也能被注入最终生成上下文。 |
| 2026-04-01 | 0cbdfda |
MCP 控制链收敛 | 共享能力管线进一步整理，MCP 控制链被压缩成 readiness / verification 两阶段。 |
分阶段理解
第一阶段：从单一聊天流升级到能力编排入口
- Skill runtime 进入
- Chat orchestrator support 落地
- 观测体系进入主链路
这一阶段解决的是“编排器不只是输出文字，而是系统能力的统一入口”。
第二阶段：把运行时做成可选、可恢复、可分流
- ReAct 运行时插件化
- checkpoint / memory 加入
- role-based model routing 加入
- human takeover 加入
这一阶段解决的是“同一套聊天系统如何支持不同执行风格、不同模型角色以及人工接管”。
第三阶段：编排器成为共享能力总线
- 评测、定时任务等场景复用同一运行时
- MCP runtime config、RAG 注入策略等 agent 级配置都沿编排器进入
- 非成功工具结果也进入最终生成上下文
这一阶段解决的是“编排器如何承载更多运行时阶段，并把失败、跳过、旁路等状态都变成可消费上下文”。
当前仍保留的边界
- 顶层 LangGraph 节点仍然很少，很多能力阶段发生在
ai_node内部，而不是图上单独节点。 langgraph_react_agent_v1仍是实验运行时，默认仍是chameleon_chat_v1。- 编排器承担统一入口职责，但不少策略已经下沉到共享 capability service，而不是全部堆在 graph 层。
与其他时间线的关系
- RAG 时间线 记录“检索策略怎么变”，本页记录“这些检索阶段何时被接入聊天运行时，以及如何进入最终生成”。
- MCP 时间线 记录“工具调用链怎么变”，本页记录“这些工具阶段在整条聊天链路里的位置和职责变化”。