结构化日志是智能体安全工具的最低要求
扫描 AI 智能体的攻击面会产生大量嘈杂的并行 HTTP 流量。没有结构化日志，就无法回答事件中的基本问题：哪条路由失败、影响哪个租户、延迟是多少，以及使用哪个关联标识符。我通过向 agentic_security 提交 PR #338 （于 2026-09-01 合并），为扫描 API 路由添加了结构化日志。
在 BeyondTrust 的工作经历让我更加确信一个简单原则：无法观测的安全产品，也无法有效运维。智能体系统同样如此——如果无法记录扫描过程，就无法保护智能体。
改了什么
扫描 API 层现在会在每条请求路径上输出结构化日志记录，提供足够的上下文用于 SIEM 接入和事后分析，同时避免泄露秘密信息。这关闭了 issue #199 ，也让项目更贴近生产安全团队实际审查流量的方式。
为什么为开源项目贡献可观测性改进很重要
寻找零信任或平台工程师的招聘人员，应关注让系统能够被运维的提交，而不只是新功能。结构化日志并不耀眼，但正是这种工作让 Fortune 100 企业的部署保持可审计。
结论
如果你在 CI 或预发布环境中运行智能体安全扫描，应先要求结构化日志，再要求更炫目的仪表盘。这个 PR 正在将 agentic_security 推向这个方向。
常见问题
结构化日志解决什么问题？
扫描路由输出结构化日志，用于 SIEM 中的关联分析，而不是临时拼凑的文本。
是哪个 PR？
PR #338 已于 2026-09-01 合并。
为什么智能体扫描需要日志？
突发的多步骤扫描需要关联标识符和结构化字段，才能进行审查。
与生产环境有什么关系？
自主智能体平台需要与传统 API 相同的可观测性基础。
本文是对一项已合并开源贡献的独立评论。
Frequently Asked Questions
结构化日志解决什么问题？
扫描路由输出结构化日志，用于 SIEM 中的关联分析，而不是临时拼凑的文本。
是哪个 PR？
PR #338 已于 2026-09-01 合并。
为什么智能体扫描需要日志？
突发的多步骤扫描需要关联标识符和结构化字段，才能进行审查。
与生产环境有什么关系？
自主智能体平台需要与传统 API 相同的可观测性基础。