ADR遥测数据解析统一 schema 设计与应用【免费下载链接】ADRADR secures enterprise AI agents through observability, security benchmarking, and threat detection. Deployed at Uber.项目地址: https://gitcode.com/GitHub_Trending/adr10/ADRADR 作为企业级 AI 代理安全防护工具通过遥测数据收集、安全基准测试和威胁检测保障 AI 代理安全。其中遥测数据解析是实现 AI 代理可观测性的关键环节而统一的 schema 设计则是确保不同来源遥测数据有效整合与分析的基础。统一 schema 的核心价值在复杂的 AI 代理生态中不同平台如 Claude Code、Cursor、Cline、Codex、Warp 等生成的日志格式各异这给后续的安全分析和威胁检测带来极大挑战。ADR 遥测数据解析通过统一的 schema 设计将这些异构日志格式标准化为企业提供一致、可靠的 AI 代理行为数据。统一 schema 设计带来的核心价值包括数据一致性消除不同 AI 代理平台日志格式差异确保数据结构统一分析高效性为安全分析和威胁检测提供标准化数据输入扩展性保障便于新 AI 代理平台日志的集成与解析AgentEventADR 遥测数据的核心 schemaADR 遥测数据解析的核心 schema 定义在 Sensor/adr_sensor/schemas/agent_event_schema.py 文件中其中AgentEvent类是整个遥测数据模型的基础。AgentEvent 的核心结构AgentEvent类定义了遥测数据的统一结构主要包含以下关键部分核心字段包括时间戳timestamp、来源平台source和会话 IDsession_id聊天历史以ChatMessage列表形式存储完整对话记录元数据包含用户 ID、项目路径、模型信息等上下文数据会话上下文可选的会话相关上下文信息分块字段支持大型会话数据的分块处理UUID自动生成的事件唯一标识符辅助数据结构为完整描述 AI 代理行为AgentEvent还引用了两个辅助数据结构ChatMessage表示对话中的单条消息包含角色role、内容content和工具使用列表toolsToolUsage记录 AI 代理调用的工具信息包括工具名称、类型、参数、结果和状态等数据解析流程与实现ADR 遥测数据解析通过一系列解析器将不同来源的日志转换为符合AgentEventschema 的数据。所有解析器均继承自 Sensor/adr_sensor/parsers/base_parser.py 中定义的BaseParser抽象基类。解析器实现ADR 目前支持多种 AI 代理平台的日志解析主要解析器包括Claude 解析器Sensor/adr_sensor/parsers/claude_parser.pyCursor 解析器Sensor/adr_sensor/parsers/cursor_parser.pyCline 解析器Sensor/adr_sensor/parsers/cline_parser.pyCodex 解析器Sensor/adr_sensor/parsers/codex_parser.pyWarp 解析器Sensor/adr_sensor/parsers/warp_parser.py每个解析器负责将特定平台的日志格式转换为统一的AgentEvent对象实现了异构数据的标准化处理。数据验证与处理AgentEvent类提供了多种方法确保数据质量和可用性has_meaningful_content()过滤无意义内容如空对话、单一错误消息等get_non_null_fields()仅返回具有有意义值的字段get_summary()生成事件的人类可读摘要get_content_hash()计算事件内容的哈希值用于变更检测统一 schema 的应用场景ADR 遥测数据的统一 schema 设计为企业 AI 代理安全提供了坚实基础主要应用场景包括安全监控与威胁检测标准化的遥测数据使安全团队能够建立统一的监控指标和检测规则及时发现异常行为和潜在威胁。例如通过分析ToolUsage数据可以识别 AI 代理是否调用了未授权工具或执行了可疑操作。合规审计统一的 schema 确保了 AI 代理行为数据的一致性和完整性为合规审计提供了可靠依据。企业可以轻松跟踪 AI 代理的使用情况确保符合内部政策和外部法规要求。性能优化通过分析标准化的遥测数据企业可以识别 AI 代理的性能瓶颈优化资源分配提升整体效率。例如通过统计工具调用频率和成功率可以评估工具集成的有效性。安全基准测试在 Detection/benchmark/agentdojo/ 目录下的基准测试框架中统一 schema 为不同 AI 代理的安全性能评估提供了标准化的数据输入确保评估结果的客观性和可比性。总结ADR 遥测数据解析的统一 schema 设计是实现企业 AI 代理可观测性和安全性的关键。通过AgentEvent及其相关数据结构ADR 成功解决了异构 AI 代理日志的标准化问题为安全监控、威胁检测、合规审计和性能优化提供了一致、可靠的数据基础。随着 AI 代理技术的不断发展ADR 的统一 schema 设计将继续发挥重要作用帮助企业有效管理和保护其 AI 代理生态系统。如需了解更多实现细节可参考 Sensor/README.md 或直接查看源代码实现。【免费下载链接】ADRADR secures enterprise AI agents through observability, security benchmarking, and threat detection. Deployed at Uber.项目地址: https://gitcode.com/GitHub_Trending/adr10/ADR创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考