ADK-Python人类介入循环实战：从自动决策到人工审核的完整指南
项目地址: https://gitcode.com/GitHub_Trending/ad/adk-python 你是否在部署AI Agent时遭遇过这些痛点？自动审批超额报销单、误批超长假期申请、敏感操作缺乏人工把关？ADK-Python的人类介入循环功能彻底解决这些问题，让AI决策既高效又安全。本文将通过真实代码案例，详解如何在30分钟内实现从自动处理到人工审核的完整流程，掌握human_in_loop工具配置、审批阈值设定和多场景干预策略。
核心场景与架构设计
ADK-Python的人类介入循环（Human-in-the-Loop）机制允许在关键节点暂停AI决策流程，等待人工审核后再继续。典型应用场景包括：
- 财务审批：超过$1000的报销单需经理确认
- 资源申请：超过3天的假期申请触发人工审核
- 敏感操作：数据删除、权限变更等高危行为需二次验证
项目核心实现位于contributing/samples/human_in_loop/和contributing/samples/human_tool_confirmation/目录，通过ToolContext对象和LongRunningFunctionTool工具实现流程挂起与恢复。
快速上手：15行代码实现基础审核流程
以下代码片段来自contributing/samples/human_in_loop/agent.py，展示如何构建一个带金额阈值审核的报销处理Agent：
root_agent = Agent(
model='gemini-2.5-flash',
name='reimbursement_agent',
instruction="""
处理员工报销流程：
- 金额<100美元：自动批准
- 金额>100美元：调用ask_for_approval()获取经理批准
- 收到批准后执行reimburse()完成打款
""",
tools=[reimburse, LongRunningFunctionTool(func=ask_for_approval)],
)
这个Agent会根据金额自动分流：小额报销直接处理，大额支出则生成审批工单（如reimbursement-ticket-001）并进入待审核状态。
进阶配置：动态阈值与交互式确认
更复杂的场景需要动态调整审核阈值和交互方式。contributing/samples/human_tool_confirmation/agent.py展示了如何实现：
1. 阈值函数定义
async def confirmation_threshold(amount: int, tool_context: ToolContext) -> bool:
"""超过1000美元需要人工确认"""
return amount > 1000
2. 工具确认配置
FunctionTool(
reimburse,
require_confirmation=confirmation_threshold, # 动态阈值判断
)
3. 交互式审批流程
tool_context.request_confirmation(
hint='请通过FunctionResponse批准或拒绝请假申请',
payload={'approved_days': 0},
)
当员工申请超过2天假期时，系统会自动触发经理审批流程，通过tool_confirmation.payload传递审批结果。
UI界面集成与操作流程
ADK提供可视化界面支持人工审核操作，开发人员可通过assets/adk-web-dev-ui-function-call.png所示界面进行审批操作：
完整操作流程：
- AI Agent处理请求并遇到审核阈值
- 系统生成审核工单并暂停执行
- 管理人员在Web界面查看详情并决策
- 审批结果通过
ToolContext返回Agent - Agent根据审批结果继续执行后续流程
最佳实践与常见问题
阈值设置策略
- 财务类：金额>月均支出10%触发审核
- 人力资源：假期>团队平均工时触发审核
- 运维操作：影响范围>5台服务器触发审核
常见问题解决
- 审核状态丢失：确保启用ResumabilityConfig
- 审批超时处理：设置
timeout参数并实现自动升级流程 - 多角色审批：使用sub_agents_config实现多级审核
完整示例代码和更多场景配置可参考官方示例库，建议结合src/google/adk/tools/tool_context.py源码理解上下文传递机制。
通过ADK-Python的人类介入循环，你可以构建既智能又可控的AI Agent系统，在保持自动化效率的同时，确保关键决策经过人工验证，特别适合企业级应用中对安全性和合规性有严格要求的场景。立即克隆项目https://link.gitcode.com/i/8a14b6d0087234469d1a1dcbbda399ab，开启你的可控AI之旅！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
