1. 项目概述
在AI应用开发中,我们经常面临一个关键挑战:如何在保持AI自动化能力的同时,确保对关键操作的控制权。Spring AI Alibaba框架提供的人工介入(Human-in-the-Loop)机制,正是为解决这一矛盾而生。这个功能允许开发者在AI执行特定操作前插入人工审批环节,特别适合需要严格控制的业务场景。
我最近在一个内容审核系统中实际应用了这个功能。系统需要自动生成营销文案,但直接发布存在风险。通过引入人工介入机制,我们实现了AI生成内容后自动暂停,等待人工审核通过后才发布的流程。这不仅降低了违规风险,还提高了内容质量。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心原理与设计思路
2.1 人工介入的工作原理
Spring AI Alibaba的人工介入机制本质上是一个Hook(钩子)系统。当AI智能体执行到配置了审批的工具时,框架会:
- 暂停当前执行流程
- 保存执行状态
- 抛出中断信号
- 等待外部系统提供审批结果
- 根据审批结果决定继续执行、修改执行或终止
这种设计有三大优势:
- 非侵入式:不需要修改工具本身的代码
- 可配置:可以精确控制哪些工具需要审批
- 状态保持:执行上下文会被完整保存,恢复时不会丢失信息
2.2 何时使用人工介入
根据我的经验,以下场景特别适合引入人工介入:
敏感操作控制
- 数据库删除/修改
- 支付/转账操作
- 权限变更
内容质量把关
- 自动生成的文章/文案发布
- 客服自动回复确认
- 法律文书生成
合规性要求
- 金融行业的交易确认
- 医疗健康建议审核
- 未成年人相关内容过滤
3. 环境准备与项目配置
3.1 依赖配置详解
在pom.xml中,我们需要两个核心依赖:
xml复制<dependencies>
<!-- 框架核心 -->
<dependency>
<groupId>com.alibaba.cloud.ai</groupId>
<artifactId>spring-ai-alibaba-agent-framework</artifactId>
<version>1.1.2.0</version>
</dependency>
<!-- 通义千问模型支持 -->
<dependency>
<groupId>com.alibaba.cloud.ai</groupId>
<artifactId>spring-ai-alibaba-starter-dashscope</artifactId>
<version>1.1.2.0</version>
</dependency>
</dependencies>
注意:如果你使用其他大模型(如ChatGPT),需要替换为对应的starter。例如使用OpenAI则需要引入spring-ai-openai-spring-boot-starter。
3.2 模型接入配置
在application.properties中配置模型访问密钥:
properties复制# 通义千问API密钥
spring.ai.dashscope.api-key=your-api-key-here
# 设置默认模型
spring.ai.dashscope.chat.model=qwen-max
如果不想将密钥放在配置文件中,也可以通过环境变量注入:
java复制DashScopeApi dashScopeApi = DashScopeApi.builder()
.apiKey(System.getenv("AliQwen_API"))
.build();
4. 核心实现步骤
4.1 工具类开发
我们以一个诗歌创作工具为例:
java复制public class PoetTool implements BiFunction<String, ToolContext, String> {
private int callCount = 0;
@Override
public String apply(
@ToolParam(description = "触发工具调用的原始用户查询") String userQuery,
ToolContext context) {
callCount++;
System.out.println("诗歌工具被调用,请求内容: " + userQuery);
return "春风
