org.noear.solon.ai.agent.react.intercept

类 HITLInterceptor

java.lang.Object

org.noear.solon.ai.agent.react.intercept.HITLInterceptor

所有已实现的接口:

AgentInterceptor, ReActInterceptor, ChatInterceptor, ToolInterceptor, org.noear.solon.flow.intercept.FlowInterceptor

@Preview(value="3.9.1")
public class HITLInterceptor
extends java.lang.Object
implements ReActInterceptor

工业级人工介入拦截器 (Human-in-the-Loop Interceptor)

该拦截器通过 ReAct 协议的生命周期钩子实现流程管控：

• onAction 阶段：判定拦截逻辑。若无决策则抛出中断异常挂起任务；若已有决策则执行修正、跳过或拒绝。
• onObservation 阶段：增强反馈逻辑。在工具执行成功后，将人工备注（Comment）注入观测结果，修正 AI 的下一轮认知。

从以下版本开始:

3.9.1

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	HITLInterceptor.HITLSensitiveStrategy
static interface	HITLInterceptor.InterventionStrategy 介入判定策略接口

构造器概要

构造器

构造器和说明
HITLInterceptor()

方法概要

限定符和类型	方法和说明
void	onAction(ReActTrace trace, java.lang.String toolName, java.util.Map<java.lang.String,java.lang.Object> args) 动作节点：调用功能工具 (Action) 前触发 可用于权限控制、参数合法性预检
void	onObservation(ReActTrace trace, java.lang.String toolName, java.lang.String result) 观察节点：工具执行返回结果 (Observation) 后触发
HITLInterceptor	onSensitiveTool(java.lang.String... toolNames) 快速注册敏感工具（使用默认敏感策略）
HITLInterceptor	onTool(java.lang.String toolName, HITLInterceptor.InterventionStrategy strategy) 注册工具介入策略

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 org.noear.solon.ai.agent.react.ReActInterceptor

onAgentEnd, onAgentStart, onModelEnd, onModelStart, onPlan, onReason, onThought

从接口继承的方法 org.noear.solon.flow.intercept.FlowInterceptor

interceptFlow, onNodeEnd, onNodeStart

从接口继承的方法 org.noear.solon.ai.chat.interceptor.ChatInterceptor

interceptCall, interceptStream, onPrepare

从接口继承的方法 org.noear.solon.ai.chat.interceptor.ToolInterceptor

interceptTool

构造器详细资料

HITLInterceptor

public HITLInterceptor()

方法详细资料

onTool

public HITLInterceptor onTool(java.lang.String toolName,
                              HITLInterceptor.InterventionStrategy strategy)

注册工具介入策略

onSensitiveTool

public HITLInterceptor onSensitiveTool(java.lang.String... toolNames)

快速注册敏感工具（使用默认敏感策略）

onAction

public void onAction(ReActTrace trace,
                     java.lang.String toolName,
                     java.util.Map<java.lang.String,java.lang.Object> args)

从接口复制的说明: ReActInterceptor

动作节点：调用功能工具 (Action) 前触发

可用于权限控制、参数合法性预检

指定者:

onAction 在接口中 ReActInterceptor

onObservation

public void onObservation(ReActTrace trace,
                          java.lang.String toolName,
                          java.lang.String result)

从接口复制的说明: ReActInterceptor

观察节点：工具执行返回结果 (Observation) 后触发

指定者:

onObservation 在接口中 ReActInterceptor