Skip to main content
Human-in-the-Loop 让你可以在智能体执行过程中插入人工审核环节。当智能体准备调用工具时,你可以先暂停让用户确认,再决定是否继续。

两个暂停时机

智能体的执行分为”推理”和”行动”两个阶段,你可以选择在不同时机暂停: 推理后暂停:模型决定要调用哪些工具后,在实际执行前暂停。此时你可以看到工具名称和参数,让用户决定是否允许执行。 行动后暂停:工具执行完毕后,在进入下一轮推理前暂停。此时你可以看到执行结果,让用户决定是否继续。

典型场景:敏感操作确认

以下示例展示如何在执行删除文件、发送邮件等敏感操作前,先让用户确认:

处理暂停和恢复

当智能体暂停时,返回的消息会包含待执行的工具信息。你需要展示给用户,并根据用户选择决定下一步:

API 速查

暂停方法
  • PostReasoningEvent.stopAgent() — 推理后暂停
  • PostActingEvent.stopAgent() — 行动后暂停
恢复方法
  • agent.call() — 继续执行待处理的工具
  • agent.call(toolResultMsg) — 提供自定义的工具结果后继续
判断暂停原因
  • response.getGenerateReason() 返回 REASONING_STOP_REQUESTEDACTING_STOP_REQUESTED