google / google/adk-python-community

feat: post-execution audit trail pattern to complement AgentGovernancePlugin

Đang mở
#142 0 bình luận 0 reaction 0 người được giao Xem trên GitHub
Ngôn ngữ chính
Python
Star
182
Fork
75
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

Mô tả

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.

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Hướng nghiên cứu

Bắt đầu bằng cách đọc AgentGovernancePlugin được mô tả trong #141 và xác định quyết định của nó về các lệnh gọi công cụ được phép liên quan như thế nào đến việc xử lý sau khi thực thi. So sánh tham số audit_backend được đề xuất hoặc hook đi kèm với các trường bản ghi bắt buộc: tool name, args hash, output hash và timestamp. Được coi là hoàn thành khi có đặc tả đã thống nhất hoặc bản triển khai nháp cho bằng chứng sau khi thực thi có thể được xác minh độc lập.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ
python
Lĩnh vực
security
Loại issue
Tính năng
Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức độ hoạt động
Ít trao đổi
Độ rõ ràng
Cần làm rõ
Mức phù hợp với người mới
35/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.