google / google/adk-python-community

feat: post-execution audit trail pattern to complement AgentGovernancePlugin

未关闭
#142 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

主要语言
Python
星标
184
派生
76
PR 合并指标
30 天内没有已合并 PR

描述

Now that #141 (AgentGovernancePlugin) is merged, the pre-execution governance loop is closed: policy load → tool-call decision → allow/review/block.

The natural next question is post-execution: once the tool call is allowed and executed, is there a standard pattern for recording what actually happened in a tamper-evident way?

The gap: AgentGovernancePlugin captures the decision. Nothing currently captures the outcome — tool name, args hash, output hash, timestamp — in a form that an external auditor can verify independently.

Proposed pattern: an optional audit_backend parameter on AgentGovernancePlugin (or a companion hook) that receives a structured post-execution record after each allowed tool call. Implementations could range from local JSONL to on-chain anchoring (e.g. Mycelium Trails).

This would complete the loop: pre-execution policy check → execution → post-execution evidence. Both sides independently verifiable.

Happy to contribute a spec or draft implementation if there's interest.

贡献指南

打开贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

调研方向

首先阅读 #141 中描述的 AgentGovernancePlugin,并确定其对允许的工具调用所作的决定与执行后处理之间的关系。将提议的 audit_backend 参数或配套 hook 与所需的记录字段进行比较:tool name、args hash、output hash 和 timestamp。当形成了关于可独立验证的执行后证据的共识规范或实现草案时,即视为完成。

由索引模型根据 Issue 内容生成。

评估

技术栈
python
领域
security
Issue 类型
功能
难度
5/5
预计耗时
一周以上
活跃度
冷清
描述清晰度
需要澄清
新手友好度
35/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。