17 · 状态图与主流 Agent 框架
先理解状态、节点和边，再选择 SDK。
本站原创入门导读与合成教学示例。原始资料核实：2026-09-05。建议先读：16 · 检索与问答如何分开评估。
理解概念
状态图把任务表示为状态与转移。节点负责可检查的一步，边决定下一步去哪里，状态保存跨节点共享的数据。图适合有分支、暂停与恢复的流程，但并非所有简单任务都需要复杂框架。
选框架时看结构化工具、状态持久化、重试、人工审批、追踪与测试接口，而不是只看示例代码短不短。OpenAI Agents SDK 是一个官方实现参考；其他图编排或声明式工具应通过同一组实验比较。业务数据与工具接口独立于框架，可降低迁移成本。
一个最小例子
代码
起点：validate_input
合法 → retrieve
不合法 → ask_user → validate_input
retrieve → draft → validate_citations
引用正确 → completed
引用失败 → repair（最多 1 次）→ validate_citations
仍然失败 → needs_review
每个节点输入、输出为可序列化状态；终态明确区分完成与待人工处理。
动手练习
把第 15 篇的 RAG 流程画成节点与边。定义每个节点可以修改的字段，模拟一次恢复，确认已经完成的收费调用不会无条件重复。
验收与预期结果
能列出所有终态；错误不会返回起点无限循环。框架替换后仍可运行同一测试集与假模型。
- 我能解释输入、过程与结果。
- 我保留了一个失败例与运行记录。
常见误区
框架默认追踪可能记录完整输入，需明确脱敏与保留策略。框架内置重试不能替代业务幂等。
延伸阅读
以下是相关方向的原始资料；本站练习不是官方课程作业或逐字翻译。
理解需要时间，记录让每一步都有迹可循。
回到学习路线图