Witty-Insight与ATIF格式：如何导出标准化AI轨迹数据

Witty-Insight与ATIF格式如何导出标准化AI轨迹数据【免费下载链接】witty-insightThe witty-insight is an eBPF-based observability framework for tracing agent execution pipelines.项目地址: https://gitcode.com/openeuler/witty-insight前往项目官网免费下载https://ar.openeuler.org/ar/Witty-Insight是基于eBPF的可观测性框架能够追踪代理执行管道。其中ATIFAgent Trajectory Interchange Format格式是导出标准化AI轨迹数据的关键本文将详细介绍如何使用Witty-Insight导出符合ATIF v1.6标准的AI轨迹数据。什么是ATIF格式ATIFAgent Trajectory Interchange Format是一种用于标准化AI代理轨迹数据的格式当前Witty-Insight支持的版本为ATIF v1.6。它定义了一套数据结构能够完整记录AI代理的交互历史、工具调用、观测结果和性能指标等关键信息。ATIF格式的核心优势在于提供了统一的数据交换标准使得不同AI代理系统产生的轨迹数据能够相互兼容和分析。通过ATIF格式开发者可以更方便地对AI代理的行为进行调试、评估和优化。ATIF格式的核心结构ATIF v1.6格式主要包含以下几个核心数据结构AtifDocument这是ATIF格式的根文档包含整个代理运行的元数据和轨迹数据。主要字段包括schema_versionATIF格式版本固定为ATIF-v1.6session_id整个代理运行的唯一标识符agent代理的配置信息steps交互步骤的数组代表完整的交互历史final_metrics整个轨迹的汇总指标AtifAgent用于描述代理系统的标识和配置信息包括代理名称、版本、使用的LLM模型等。AtifStep代表一个单独的交互步骤可以是系统提示、用户消息或代理响应。每个步骤包含来源、消息内容、工具调用、观测结果和性能指标等信息。AtifToolCall与AtifObservationAtifToolCall记录代理调用的工具或函数信息包括调用ID、函数名称和参数。AtifObservation则记录工具调用后的环境反馈或结果。AtifStepMetrics与AtifFinalMetricsAtifStepMetrics记录单个步骤的LLM操作指标如输入令牌数、输出令牌数等。AtifFinalMetrics则是整个轨迹的汇总统计信息。Witty-Insight中的ATIF实现在Witty-Insight项目中ATIF功能主要通过以下模块实现ATIF核心模块src/atif/mod.rs提供ATIF v1.6数据结构和转换逻辑数据结构定义src/atif/schema.rs定义了与ATIF v1.6 JSON模式对应的Rust类型转换逻辑src/atif/converter.rs实现从AgentSight SQLite GenAI数据到ATIF格式的转换如何导出ATIF格式数据Witty-Insight提供了多个端点用于导出ATIF格式数据主要包括导出单个轨迹通过以下端点可以将单个追踪一次用户查询的调用链导出为ATIF v1.6轨迹文档Exports a single trace as an ATIF v1.6 trajectory document.导出完整会话如果需要导出完整会话所有追踪可以使用Exports a full session (all traces) as an ATIF v1.6 trajectory document.导出特定对话的LLM调用还可以针对特定对话导出所有LLM调用Exports all LLM calls for a conversation as an ATIF v1.6 trajectory document.ATIF数据的应用场景导出的ATIF格式数据可以用于多种场景AI代理行为分析通过完整记录的交互步骤分析AI代理的决策过程和行为模式性能优化利用ATIF中的令牌使用和耗时指标优化LLM调用效率跨平台数据交换由于ATIF是标准化格式可以在不同的AI代理系统之间共享和分析轨迹数据调试与问题诊断通过详细的工具调用和观测结果快速定位AI代理的问题所在总结ATIF格式为AI轨迹数据提供了标准化的解决方案而Witty-Insight作为基于eBPF的可观测性框架通过完善的ATIF实现使得开发者能够轻松导出和分析AI代理的运行轨迹。无论是进行性能优化、行为分析还是跨平台数据交换ATIF格式都能发挥重要作用。如果你想深入了解ATIF格式的实现细节可以查看项目中的src/atif/目录其中包含了完整的ATIF数据结构定义和转换逻辑。【免费下载链接】witty-insightThe witty-insight is an eBPF-based observability framework for tracing agent execution pipelines.项目地址: https://gitcode.com/openeuler/witty-insight创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考