人机交互

📚 学习目标

学完这篇文章后，你将能够：

使用 interrupt 函数暂停图的执行
在暂停期间获取上下文信息
使用 Command 恢复（Resume）图的执行
实现一个“敏感操作需人工审批”的工作流

前置知识

在开始学习之前，建议先阅读：

记忆与持久化
注意：人机交互功能必须配合 Checkpointer 使用。

1️⃣ 什么是 Human-in-the-loop？

全自动的 AI Agent 效率很高，但在某些场景下（如转账、发送邮件、发布代码），我们希望有人类介入把关。

LangGraph 允许我们在图的任意位置暂停（Interrupt），等待人类用户的输入（如“批准”或“拒绝”），然后再恢复（Resume）执行。

2️⃣ 实现暂停 (Interrupt)

我们使用 interrupt 函数来触发暂停。通常是在执行敏感操作之前的节点或条件边中调用。

import { interrupt } from '@langchain/langgraph';

const shouldContinue = (state) => {
    const lastMessage = state.messages[state.messages.length - 1];
    
    // 如果 LLM 想要调用工具
    if (lastMessage.tool_calls?.length) {
        
        // 🚨 触发中断！
        // 参数是可以传递给前端/调用者的任何数据
        const review = interrupt({
            question: "允许 AI 调用工具吗？",
            tool_call: lastMessage.tool_calls[0]
        });
        
        // ⚠️ 代码执行到这里会立即停止，状态被保存
        // 只有当图被"恢复"时，才会继续执行下面的代码
        
        // review 变量将包含人类在恢复时传入的数据
        if (review === 'approve') {
            return 'tools'; // 批准，去执行工具
        } else {
            return END;     // 拒绝，结束流程
        }
    }
    
    return END;
}

3️⃣ 恢复执行 (Resume)

当图处于中断状态时，我们需要使用 Command 对象告知 LangGraph 继续执行，并传入人类的反馈。

import { Command } from '@langchain/langgraph';

// 1. 第一次运行：触发中断
// 必须要传入 checkpointer 和 thread_id
await graph.invoke({ messages: [input] }, config);
console.log("图已暂停，等待审批...");

// ... 这里可以是等待 API 请求，或者前端用户的点击 ...

// 2. 恢复执行
// 使用相同的 input（或 null）和 config
// 传入 Command 对象，resume 字段的值会被赋给 interrupt 函数的返回值
await graph.invoke(
    new Command({ resume: 'approve' }), 
    config
);