langgragh的state设计；
state是智能体中所有节点均可访问的共享内存。
State该放什么数据
判断标准
- 需要跨节点传递的 → 放进去
- 能从已有数据推导出来的 → 不放，用的时候现算
state示例：
class EmailAgentState(TypedDict):# 原始邮件数据（后续无法重建，必须存）email_content: strsender_email: stremail_id: str# 分类结果（多个下游节点都要读）classification: EmailClassification | None# 外部查询结果（查一次很贵，存起来复用）search_results: list[str] | Nonecustomer_history: dict | None# 生成内容（需要经过 human_review 节点，必须持久化）draft_response: str | Nonemessages: list[str] | None
最重要的原则：State 只存原始数据，不存格式化文本
这是文档里强调最多的一点，举个例子：
❌ 错误做法：把 prompt 存进 State
class BadState(TypedDict):prompt_for_draft: str # "客户邮件：xxx\n分类结果：xxx\n请起草回复..."
✅ 正确做法：存原始数据，节点内现组装 prompt
class GoodState(TypedDict):email_content: str # 原始邮件classification: dict # 原始分类结果search_results: list[str] # 原始搜索结果
一句话总结：State 是数据仓库，不是消息队列，存的是事实，不是指令。
langgragh本地的流程控制机制interrupt()；
人机交互重点方法interrupt()
interrupt()的本质
它不是网络请求、不是数据库查询，它做的事情是：
把当前 State 序列化存进 checkpointer
抛出一个特殊异常（GraphInterrupt）
LangGraph 框架捕获这个异常，停止图的执行
整个过程是同步的，没有任何 IO 等待，所以不需要 await。
停止图执行流程
interrupt({...})↓
1. 把传入的数据包装成 GraphInterrupt 异常对象
2. raise 这个异常
3. LangGraph 框架层捕获它
4. 把当前 State 写入 checkpointer（才是真正的 IO，可能是写数据库）
5. 把 interrupt 的数据暴露给调用方（你的业务代码）
6. 停止图执行
所以 interrupt() 更像是一个检查点标记，告诉框架"在这里暂停，等外部信号"，而不是它自己去发请求等响应。
本质上就是把一个长流程拆成了两次独立的 HTTP 请求，靠 thread_id + checkpointer 把中间状态串起来。
这也是为什么 checkpointer 必须用持久化存储（比如你之前研究的 PostgresSaver），用 MemorySaver 的话进程一重启 State 就全丢了。
重启被打断的工作流
前端发一个普通的 POST 请求就行，关键是带上 thread_id，后端拿到后调用 app.invoke(Command(resume=...), config)。