SuperAPI AI 工具集

opik

智能体与模型

查看项目

更新于 10-15 20:14

技能介绍

用途:为代码添加 Opik 追踪或集成,对 LLM 应用进行埋点,并查阅 Opik SDK 参考。

核心概念:trace 表示一次完整执行路径(一次用户请求到一次响应);span 是 trace 内的单个操作,构成层级结构。有效 span 类型仅有 general(自定义操作、编排)、llm(LLM API 调用)、tool(工具/函数执行、数据检索)、guardrail(安全/校验检查),不要使用 retrieval 等其他类型。

Python 用法:用 @opik.track 装饰函数,可指定 name 与 type,嵌套调用自动生成子 span;脚本中调用 opik.flush_tracker() 刷新。TypeScript 用法:创建 new Opik({ projectName }) 客户端,用 client.trace 与 trace.span 手动记录,最后 await client.flush()。

集成:有框架专用集成时应优先使用,可自动捕获 token、模型、成本等更多细节。常见模式包括包装客户端(如 from opik.integrations.openai import track_openai)、全局启用(CrewAI、DSPy)、回调(DSPy 的 OpikCallback)、回调/tracer(LangChain、LangGraph、LlamaIndex 的 OpikTracer)、智能体专用(Google ADK 的 OpikTracer 与 track_adk_agent_recursive)。

详细参考文件:tracing-python.md、tracing-typescript.md、tracing-rest-api.md、integrations.md、observability.md。

限制:资料未提供收费、价格、平台支持范围与效果数据,暂未提供。