概述
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 审批在以下条件下触发:- 工具不在白名单中
- Auto-Run 模式为 “Ask Everytime”
- 工具标记为需要确认
交互流程
中断与恢复
当工具需要审批时,Agent 的执行会被中断,状态通过 Checkpointer 持久化保存。用户审批后,Agent 从断点恢复继续执行。 用户审批决策类型:
被拒绝的工具会附加系统消息,明确告知 Agent 不要重试该工具。
更多关于中断恢复的技术细节,请参阅 Agent Loop 和 Runtime 文档。