SuperAPI AI 工具集

nemo-relay-export-atif-trajectories

智能体与模型

查看项目

更新于 10-16 02:34

技能介绍

用途:当需要以 ATIF 文档形式获取执行轨迹(而非实时 OTLP span)时使用本技能,可将 NeMo Relay 事件导出为 ATIF v1.7 轨迹数据,供回放、分析或交换。

主要能力与语义:LLM start 事件转为 user steps,尽量从 LLMRequest.content 提取消息内容;LLM end 事件转为 agent steps,含响应内容、模型元数据、token 指标、reasoning 字段及受支持工具调用形态下的 tool_calls;tool start 事件被跳过,因为 tool 调用由前一个 LLM end 响应提升而来;tool end 事件转为 system observations,按函数名与可用源调用 ID 关联到提升的 tool 调用;带数据的 mark 事件转为 system steps,scope 起止为结构事件不产出步骤;scope 嵌套成为导出步骤的 ancestry 元数据,嵌套 agent scope 成为内嵌 subagent_trajectories 及父轨迹中的 subagent_trajectory_ref 观察;事件负载转为步骤输入、输出、tool 调用内容或观察内容。导出器保持事件收集顺序,通过生命周期配对重建轨迹。导出不清空缓冲区,并发 agent 共享进程时每次运行使用独立导出器,或运行间调用 clear()。

默认用法:创建带 session 与 agent 元数据的 AtifExporter;在插桩工作前注册;运行作用域内的 tool 与 LLM 活动;调用 export() 或 export_json();运行间 clear() 并在结束时注销。

限制与注意:ATIF 导出的是目前已收集的完整事件缓冲区;连续 tool observations 可合并为一个 system observation 步骤;轨迹反映经 sanitize guardrail 清理后的事件负载,而非原始密钥;response codec 可改进 LLM end 标注但不改变调用方可见的 LLM 响应。用于评估前请确认 schema_version 为 ATIF-v1.7、agent 元数据正确、预期 LLM/tool 步骤齐全、tool observations 位于 tool calls 之后、且不含敏感字段。相关技能:nemo-relay-setup-observability、nemo-relay-instrument-calls、nemo-relay-debug-runtime-integration。具体安装命令与配置细节暂未提供。