🧩 主流 Agent 框架实战
框架选型方法
主流 Agent 框架实战专题：用 5 个核心问题讲清原理、取舍与落地。
一句话定位
LangGraph、Agents SDK、ADK、AutoGen、CrewAI、LlamaIndex 等框架选型。 先比较控制流、状态、持久化、追踪、部署和生态，再比较 API 写法。
核心原理与问题解析
如何做框架无关架构？
把业务状态、工具接口、模型网关、评测数据和领域规则定义在独立层，框架只负责适配与编排。Trace 使用统一语义，避免数据只能由某框架反序列化。
继续想： 最难迁移的部分是什么？；如何做适配器测试？
什么时候应该手写 Agent Loop？
只有流程简单、团队需要完全控制或框架成本大于收益时。手写后仍要补 Schema、状态、重试、HITL、Trace 和评测，不能把 while 循环当生产系统。
继续想： 最小循环要多少代码？；何时迁移到图框架？
框架选型 PoC 应比较什么？
用同一任务和数据比较成功率、代码复杂度、状态恢复、HITL、Trace、测试、延迟、成本、部署和升级；至少模拟工具失败与中断恢复。
继续想： PoC 多久合适？；如何避免只比 Hello World？
如何评价框架的可观测性？
看能否追踪模型、工具、检索、状态、Handoff、Token 和错误，是否支持自定义 span、脱敏、OpenTelemetry 导出和跨服务关联，而不只看一个漂亮 UI。
继续想： Trace Schema 如何统一？；采样后怎样保留错误？
框架排行榜有参考价值吗？
只能提供候选。框架适配的是团队、业务与运维约束，真正比较必须用自己的任务、故障和部署环境；生态热度不能替代可恢复性和评测能力。
继续想： 如何评估社区风险？；托管平台与开源框架怎么选？
工程落地检查
- 用同一个小业务闭环做选型 PoC
- 业务状态与框架对象解耦
- 封装模型、工具和存储适配层
- 验证中断恢复、升级和迁移
- 锁版本并保留 Trace 级回归
常见误区
- 按热度或代码行数选框架
- 把框架 Demo 当生产架构
- 核心业务到处依赖框架私有类型
对应面试题
K12 如何做框架无关架构？ · K13 什么时候应该手写 Agent Loop？ · K14 框架选型 PoC 应比较什么？ · K16 如何评价框架的可观测性？ · K20 框架排行榜有参考价值吗？