核心概念
interrupt_on 参数——告诉 Agent 哪些工具需要人工审批
Deep Agents 通过 interruptOn 参数为每个工具配置审批策略。当 Agent 调用配置了中断的工具时，执行会自动暂停，等待人工做出决策后继续。
const agent = createDeepAgent({
model: "google-genai:gemini-3.1-pro-preview",
tools: [removeFile, fetchFile, notifyEmail],
interruptOn: {
// true = 允许全部三种决策（approve/edit/reject）
remove_file: true,
// false = 无需中断，Agent 直接执行
fetch_file: false,
// 对象形式 = 自定义允许的决策类型
notify_email: {
allowedDecisions: ["approve", "reject"] // 只允许批准或拒绝
},
},
checkpointer, // 必需！interrupt 依赖 checkpointer 持久化 Agent 状态
});
必须使用 Checkpointer：人机协作依赖
MemorySaver 或其他 checkpointer 来在中断和恢复之间持久化 Agent 状态。如果不配置 checkpointer，中断将无法正常工作。
处理中断
检测中断、展示信息、收集决策、恢复执行——完整流程
当中断触发时，Agent 暂停执行并返回包含 __interrupt__ 的结果。你的代码需要：检测中断、提取信息、获取用户决策、用 Command 恢复。
import { v7 as uuid7 } from "uuid";
import { Command } from "@langchain/langgraph";
// thread_id 用于标识对话线程，checkpointer 按此 ID 存储状态
const config = { configurable: { thread_id: uuid7() } };
// 第一步：发送用户消息，触发 Agent 执行
let result = await agent.invoke({
messages: [{ role: "user", content: "Delete the file temp.txt" }],
}, config);
// 第二步：检查 Agent 是否在工具调用前被中断
if (result.__interrupt__) {
// __interrupt__ 是 LangGraph 的内置字段，包含所有待审批的工具调用
const interrupts = result.__interrupt__[0].value;
const actionRequests = interrupts.actionRequests; // 待审批的工具调用列表
const reviewConfigs = interrupts.reviewConfigs; // 每个工具允许的决策类型
// 创建 工具名称 → 审查配置 的查找映射，方便后续查询
const configMap = Object.fromEntries(
reviewConfigs.map((cfg) => [cfg.actionName, cfg])
);
// 第三步：向用户展示每个待审批操作及其允许的决策
for (const action of actionRequests) {
const reviewConfig = configMap[action.name];
console.log(`工具: ${action.name}`);
console.log(`参数: ${JSON.stringify(action.args)}`);
console.log(`允许的决策: ${reviewConfig.allowedDecisions}`);
}
// 第四步：收集用户的审批决策（按 actionRequests 顺序）
const decisions = [
{ type: "approve" } // 用户批准了删除操作
];
// 第五步：用 Command({ resume }) 恢复 Agent 执行
result = await agent.invoke(
new Command({ resume: { decisions } }),
config // 必须使用相同的 config，否则找不到之前的状态
);
}
关键步骤：调用 Agent → 检查
result.__interrupt__ → 提取 actionRequests → 展示给用户 → 收集 decisions → 用 Command({ resume }) 恢复。整个过程的核心就是"暂停-审批-恢复"。
子 Agent 中断
子 Agent 可以有独立的中断配置，覆盖主 Agent 的设置
使用子 Agent 时，中断可以发生在两个层面：工具调用上（通过 interruptOn 配置）和工具调用内部（通过 interrupt() 函数）。先看第一种。
const agent = createDeepAgent({
tools: [deleteFile, readFile],
interruptOn: {
delete_file: true, // 主 Agent：删除需要审批
read_file: false, // 主 Agent：读取无需审批
},
subagents: [{
name: "file-manager",
description: "Manages file operations",
systemPrompt: "You are a file management assistant.",
tools: [deleteFile, readFile],
interruptOn: {
// 子 Agent 覆盖：读取也需要审批！
delete_file: true,
read_file: true, // 与主 Agent 不同
}
}],
checkpointer
});主 Agent 的规则
delete_file：需要审批read_file：无需审批- 适用于主 Agent 直接调用工具时
子 Agent 的覆盖规则
delete_file：需要审批（不变）read_file：也需要审批（更严格）- 只影响该子 Agent 内部
覆盖逻辑：每个子 Agent 的
interruptOn 是完全覆盖而非合并。如果子 Agent 配置了 interruptOn，主 Agent 的规则不会继承到子 Agent 中。子 Agent 处理中断的方式与主 Agent 完全相同。