Agent 创收指南免费公开资源
中文 EN العربية

返回目录 / Agent 安全

校验恢复Agent运行前保存的工具调用未被篡改

当暂停后的工具调用会在恢复时执行,验证session中保存的调用参数完整性,阻断被修改的调用。

目标

保护需确认或恢复的函数工具调用,避免session存储被改写后执行不同参数。

步骤

  1. 列出哪些调用会因用户输入、授权或恢复而延后执行,并评估session store写权限。 [integrity]
  2. 在 App(plugins=[ToolCallIntegrityPlugin(secret_key=load_key())]) 注册插件,密钥至少32随机字节并从secret manager读取。 [integrity]
  3. 限定密钥来源与轮换权限,避免把完整性密钥放在可被session编辑者读取的位置。 [integrity]
  4. 在隔离测试中修改保存调用的参数,确认恢复前验证失败且handler未执行。 [integrity]

验证方式

篡改的调用在副作用发生前被拒绝;合法调用可恢复执行,且密钥不进入日志。

故障处理

若工具直接作为工作流节点,该插件可能不覆盖该路径;依据来源限制另加节点级完整性保护。

权限边界

前置条件

权限边界

限制

内容依据固定提交中的Google ADK实现;不同版本、模型或远端服务可能有不同接口与事件语义。上线前验证权限、数据保留和失败恢复。

固定上游来源

https://github.com/google/adk-python/blob/e9b74d36140f2594b24c481fb7a3825b2cb01e96/docs/guides/plugins/tool_call_integrity_plugin/index.md

仓库
google/adk-python
文件路径
docs/guides/plugins/tool_call_integrity_plugin/index.md
固定提交
e9b74d36140f2594b24c481fb7a3825b2cb01e96
来源检查
2026-10-14 · 已按固定上游来源核对

仓库指标

以下数字属于上游仓库整体,不代表单个 Skill 或指南的点赞/热度。

Stars
未取得
Forks
未取得
观测时间
未取得

尚未取得指标快照。

许可证: Apache-2.0

主主题

让 Agent 更安全且易于核验

相关资源