Skip to main content

概述

HITL(Human in the Loop)机制确保 AI Agent 在执行敏感操作时获得人类确认。Zeus 通过 Auto-Run 模式和工具审批流程,让用户灵活控制 Agent 的自动化程度。

Auto-Run Mode

Auto-Run 模式控制 AI Agent 执行工具的自动化程度。

三种模式

Tool Approval UI

当工具需要审批时,前端显示审批卡片,包含工具名称、参数、当前状态(pending / approved / rejected / running / completed),以及批准和拒绝按钮。

审批决策逻辑

审批决策基于当前 Auto-Run 模式:
  • Run Everything:所有工具自动执行,无需审批
  • Use Allowlist:仅白名单中的工具自动执行,其他工具需要审批
  • Ask Everytime:所有工具都需要用户审批

数据持久化

用户的 Auto-Run 模式设置和工具白名单通过数据库持久化,每个用户拥有独立的配置。白名单按用户和工具名唯一约束,确保不重复。

触发条件

HITL 审批在以下条件下触发:
  1. 工具不在白名单中
  2. Auto-Run 模式为 “Ask Everytime”
  3. 工具标记为需要确认

交互流程


中断与恢复

当工具需要审批时,Agent 的执行会被中断,状态通过 Checkpointer 持久化保存。用户审批后,Agent 从断点恢复继续执行。 用户审批决策类型: 被拒绝的工具会附加系统消息,明确告知 Agent 不要重试该工具。 更多关于中断恢复的技术细节,请参阅 Agent LoopRuntime 文档。