用途:为应用接入基于 OpenTelemetry 的追踪与可观测性,依托 TrueFoundry 追踪平台(由 Traceloop SDK 提供支持),捕获 LLM 调用、工作流和自定义 span。
主要能力:创建追踪项目与应用;安装 Python 的 traceloop-sdk 或 TypeScript 的 @traceloop/node-server-sdk;检测项目类型与所用 LLM 库(如 openai、anthropic、langchain 等);在入口文件顶部初始化 Traceloop;可为多步骤应用添加 workflow、task、agent、tool 装饰器;可为高流量生产环境配置采样(如 10% TraceIdRatioBased);提供完整的 Tracing API 参考与错误处理指引。
使用方式:先运行 status 技能确认 TFY_BASE_URL 和 TFY_API_KEY 有效。通过工具调用或直接 API(配合脚本 scripts/tfy-api.sh)列出或创建追踪项目,再创建应用。Python 执行 pip install traceloop-sdk 并写入依赖文件;TypeScript 执行 npm install @traceloop/node-server-sdk。在入口文件最顶部、任何 LLM 库导入之前调用 Traceloop.init()(Python)或 traceloop.initialize()(TypeScript),传入 app_name、api_endpoint(须以 /api/otel 结尾)、Authorization 与 X-TFY-TRACING-PROJECT-FQN 头。
适用场景:需要在 TrueFoundry 上对 LLM 应用、RAG 流水线、代理等进行调用追踪与可观测性建设的场景。
限制:Traceloop.init() 必须在 LLM 库导入之前调用,否则自动插桩无效或追踪缺少 LLM 调用详情;api_endpoint 不能以斜杠结尾;X-TFY-TRACING-PROJECT-FQN 须与项目 FQN 完全一致。若追踪项目 API 返回 404,需改为通过 TrueFoundry UI 创建项目。401 需检查 API Key;无追踪时可用 disable_batch=True 临时排查;生产环境高流量建议配置采样。具体价格、平台支持范围等资料暂未提供。