如何用 Witty-Insight 快速导出 AI 轨迹数据ATIF v1.6 完整指南【免费下载链接】witty-insightThe witty-insight is an eBPF-based observability framework for tracing agent execution pipelines.项目地址: https://gitcode.com/openeuler/witty-insight不同代理系统的轨迹数据格式各异调试起来头疼怎么办Witty-Insight 是一款基于 eBPF 的可观测性框架它能追踪 AI 代理的完整执行管道并把记录的 AI 轨迹数据按标准的 ATIF 格式导出。免费下载请前往官网 ar.openeuler.org。一分钟看懂 ATIF v1.6标准格式统一了什么 ATIFAgent Trajectory Interchange Format是一套面向 AI 代理轨迹的标准化 JSON 数据结构。它的作用很直接让任何代理系统的交互记录共用同一副骨架不同来源的数据都能被同一套工具解析。具体而言它统一了四类信息交互历史——谁先说话、模型如何回应工具调用——代理调用了哪个工具、传了什么参数观测结果——调用之后环境返回了什么反馈性能指标——每一步消耗了多少 token。Witty-Insight 目前支持 ATIF v1.6版本号会写入文档的 schema_version 字段。格式一旦统一轨迹数据就不再被锁死在某个系统里可以直接流入通用的分析工具。ATIF v1.6 字段分层速查元数据、步骤与指标 ️一份 ATIF 文档按三层来读从上到下一层比一层细层次代表字段作用文档级元数据schema_version、session_id、agent标明格式版本固定 ATIF-v1.6、运行唯一标识、代理名称/版本/默认模型步骤级source、message、tool_calls、observation一帧一帧记录交互过程指标级prompt_tokens、completion_tokens、final_metrics统计 token 用量与步骤数中间的步骤层是轨迹的主体。AtifStep 可以理解为轨迹里的一个动作帧source 标明它出自谁system、user 还是 agentmessage 承载对话内容agent 帧还可以携带 tool_calls调用 ID、函数名、参数和 observation工具执行后的环境反馈。指标层分两级AtifStepMetrics 记录单步的 prompt_tokens、completion_tokens 等用量AtifFinalMetrics 则把整条轨迹的 token 总量、步骤总数汇总到一起便于快速评估整体开销。导出 ATIF 轨迹的三种粒度单轨迹、会话与对话 按你想查看的范围有三种导出粒度返回的都是 ATIF v1.6 JSON 文档。导出单个轨迹——trace 指一次用户查询对应的完整调用链GET /api/export/atif/trace/{trace_id}Exports a single trace as an ATIF v1.6 trajectory document.导出完整会话——session 覆盖一次代理运行内的全部轨迹GET /api/export/atif/session/{session_id}Exports a full session (all traces) as an ATIF v1.6 trajectory document.导出单个对话的 LLM 调用——只想核对某轮 LLM 交互细节时最省事GET /api/export/atif/conversation/{conversation_id}Exports all LLM calls for a conversation as an ATIF v1.6 trajectory document.导出之后AI 轨迹数据的四个用武之地 导出后的轨迹数据可以立刻派上用场行为分析回放步骤序列看清代理每一步的决策路径性能调优对照 token 用量与步骤数找出开销异常的环节跨系统交换标准化的 ATIF 格式可直接进入其他平台的分析流水线问题诊断把工具调用和观测结果放在一起看定位代理出错的起点。四类用法共用同一份数据源一次导出、多处复用。Witty-Insight 把看不见的代理执行管道变成了可阅读、可交换的标准轨迹数据。想深入数据结构定义与转换实现可以查看源码目录 src/atif/其中 schema.rs 承载字段定义converter.rs 负责把 GenAI 记录转换成 ATIF 文档。【免费下载链接】witty-insightThe witty-insight is an eBPF-based observability framework for tracing agent execution pipelines.项目地址: https://gitcode.com/openeuler/witty-insight创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
