SuperAPI AI 工具集

truefoundry-tracing

通用与其它

查看项目

更新于 10-16 06:43

技能介绍

用途:为应用添加基于 OpenTelemetry 的追踪与可观测性,使用 TrueFoundry 追踪平台(由 Traceloop SDK 提供支持),捕获 LLM 调用、工作流和自定义 span。适用于搭建追踪项目、安装 Traceloop SDK,并为 Python 或 TypeScript 应用做埋点。

主要能力:创建追踪项目与项目下应用;检测应用类型与所用 LLM 库;安装 SDK;为代码埋点;为多步骤应用(智能体、RAG 管道)添加装饰器;生产环境配置采样。支持 Python 与 TypeScript/JavaScript,可识别 openai、anthropic、langchain、llama-index、litellm、cohere、bedrock、vertexai、transformers 等库。

使用方式:先运行 status 技能验证 TFY_BASE_URL 与 TFY_API_KEY;如需直接调用 API,将 TFY_API_SH 指向本技能的 scripts/tfy-api.sh。列出项目:$TFY_API_SH GET /api/ml/v1/tracing-projects;创建项目:$TFY_API_SH POST /api/ml/v1/tracing-projects '{"name": "my-tracing-project"}';创建应用:$TFY_API_SH POST /api/ml/v1/tracing-projects/PROJECT_ID/applications '{"name": "my-app"}'。Python 安装 pip install traceloop-sdk;TypeScript 安装 npm install @traceloop/node-server-sdk。埋点时 Traceloop.init() 必须位于入口文件最顶部、任何 LLM 库导入之前,api_endpoint 为 <TFY_BASE_URL>/api/otel,headers 需含 Authorization 与 X-TFY-TRACING-PROJECT-FQN。可选使用 @workflow、@task、@agent、@tool 装饰器及 withWorkflow 等 TS 版本;生产环境可用 ParentBased(TraceIdRatioBased) 配置采样。

限制与排错:若 tracing API 返回 404,可改用 TrueFoundry UI 创建项目并回填 FQN。Trace 导出 401 需检查密钥有效性;无 Trace 出现首先确认 init 在 LLM 导入之前、api_endpoint 以 /api/otel 结尾、FQN 完全匹配,可临时设 disable_batch=True 排查。ImportError 需执行 pip install traceloop-sdk。其他价格、平台细节暂未提供。