返回目录 / Agent 安全
校验恢复Agent运行前保存的工具调用未被篡改
当暂停后的工具调用会在恢复时执行,验证session中保存的调用参数完整性,阻断被修改的调用。
目标
保护需确认或恢复的函数工具调用,避免session存储被改写后执行不同参数。
步骤
- 列出哪些调用会因用户输入、授权或恢复而延后执行,并评估session store写权限。 [integrity]
- 在
App(plugins=[ToolCallIntegrityPlugin(secret_key=load_key())])注册插件,密钥至少32随机字节并从secret manager读取。 [integrity] - 限定密钥来源与轮换权限,避免把完整性密钥放在可被session编辑者读取的位置。 [integrity]
- 在隔离测试中修改保存调用的参数,确认恢复前验证失败且handler未执行。 [integrity]
验证方式
篡改的调用在副作用发生前被拒绝;合法调用可恢复执行,且密钥不进入日志。
故障处理
若工具直接作为工作流节点,该插件可能不覆盖该路径;依据来源限制另加节点级完整性保护。
权限边界
前置条件
- Python 3.11+、与固定提交兼容的 google-adk 安装、隔离测试环境
- 已配置的模型提供商凭据(真实推理需要;不要写入代码或日志)
权限边界
- 仅访问获准的测试数据;按用户范围隔离session与凭证;任何外部副作用先经人工授权
限制
内容依据固定提交中的Google ADK实现;不同版本、模型或远端服务可能有不同接口与事件语义。上线前验证权限、数据保留和失败恢复。
固定上游来源
- 仓库
- google/adk-python
- 文件路径
- docs/guides/plugins/tool_call_integrity_plugin/index.md
- 固定提交
e9b74d36140f2594b24c481fb7a3825b2cb01e96- 来源检查
- 2026-10-14 · 已按固定上游来源核对
仓库指标
以下数字属于上游仓库整体,不代表单个 Skill 或指南的点赞/热度。
- Stars
- 未取得
- Forks
- 未取得
- 观测时间
- 未取得
尚未取得指标快照。
许可证: Apache-2.0