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

类 HITL

java.lang.Object

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

@Preview(value="3.9.1")
public class HITL
extends java.lang.Object

HITL (Human-in-the-Loop) 交互助手

提供面向业务层（如 Controller 或 Service）的便捷 API。主要用于：

• 任务探知：通过 getPendingTask(org.noear.solon.ai.agent.AgentSession) 获取当前会话中被拦截的挂起任务。
• 决策回填：通过 approve/reject/skip 提交人工干预指令，驱动 Agent 恢复执行。

从以下版本开始:

3.9.1

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	DECISION_PREFIX 决策状态存储前缀
static java.lang.String	LAST_INTERVENED 最近一次被拦截的任务存储 Key

构造器概要

构造器

构造器和说明
HITL()

方法概要

限定符和类型	方法和说明
static void	approve(AgentSession session, java.lang.String toolName) 快捷批准工具执行
static void	approve(AgentSession session, java.lang.String toolName, java.lang.String comment) 快捷批准工具执行
static void	clear(AgentSession session, HITLTask task) 清理状态
static HITLDecision	getDecision(AgentSession session, HITLTask task)
static HITLDecision	getDecision(AgentSession session, java.lang.String toolName)
static HITLTask	getPendingTask(AgentSession session) 获取会话中当前挂起的任务信息
static boolean	isHitl(AgentSession session)
static void	reject(AgentSession session, java.lang.String toolName) 快捷拒绝工具执行（使用默认拒绝意见）
static void	reject(AgentSession session, java.lang.String toolName, java.lang.String comment) 快捷拒绝工具执行（带具体意见）
static void	skip(AgentSession session, java.lang.String toolName) 快捷跳过工具执行（使用默认拒绝意见）
static void	skip(AgentSession session, java.lang.String toolName, java.lang.String comment) 快捷跳过工具执行（带具体意见）
static void	submit(AgentSession session, java.lang.String toolName, HITLDecision decision) 提交人工决策

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

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

字段详细资料

DECISION_PREFIX

public static final java.lang.String DECISION_PREFIX

决策状态存储前缀

另请参阅:

常量字段值

LAST_INTERVENED

public static final java.lang.String LAST_INTERVENED

最近一次被拦截的任务存储 Key

另请参阅:

常量字段值

构造器详细资料

HITL

public HITL()

方法详细资料

clear

public static void clear(AgentSession session,
                         HITLTask task)

清理状态

submit

public static void submit(AgentSession session,
                          java.lang.String toolName,
                          HITLDecision decision)

提交人工决策

参数:

session - Agent 会话

toolName - 工具名称

decision - 决策实体（包含同意、拒绝理由或修正参数）

approve

public static void approve(AgentSession session,
                           java.lang.String toolName)

快捷批准工具执行

approve

public static void approve(AgentSession session,
                           java.lang.String toolName,
                           java.lang.String comment)

快捷批准工具执行

reject

public static void reject(AgentSession session,
                          java.lang.String toolName)

快捷拒绝工具执行（使用默认拒绝意见）

reject

public static void reject(AgentSession session,
                          java.lang.String toolName,
                          java.lang.String comment)

快捷拒绝工具执行（带具体意见）

skip

public static void skip(AgentSession session,
                        java.lang.String toolName)

快捷跳过工具执行（使用默认拒绝意见）

skip

public static void skip(AgentSession session,
                        java.lang.String toolName,
                        java.lang.String comment)

快捷跳过工具执行（带具体意见）

isHitl

public static boolean isHitl(AgentSession session)

getPendingTask

public static HITLTask getPendingTask(AgentSession session)

获取会话中当前挂起的任务信息

返回:

挂起的任务实体，若无挂起则返回 null

getDecision

public static HITLDecision getDecision(AgentSession session,
                                       HITLTask task)

getDecision

public static HITLDecision getDecision(AgentSession session,
                                       java.lang.String toolName)