SuperAPI AI 工具集

opik-instrument

智能体与模型

查看项目

更新于 10-16 05:03

技能介绍

用途:为现有应用接入 Opik 追踪,并在 Opik 中确认真实 trace 已产生,返回可访问的 trace 链接。仅做代码编辑不算成功。

主要能力:判断语言(Python/TypeScript)与 LLM 框架并选择对应原生集成;优先使用框架原生集成,仅在编排/工具等未覆盖处添加手动 @opik.track 跨度;按项目包管理器安装必需的 Opik 包;推断安全代表路径运行;通过 SDK 或可选 MCP 验证 trace 落库。

使用方式:入口为 /opik-instrument 或 /opik-instrument <path>。配置检查用 opik configure(Python)或 npx opik-ts configure(TypeScript),验证用 opik healthcheck。脚本结束需 flush(opik.flush_tracker() / await client.flush())。

适用场景:已有 Python/TypeScript 应用需快速接入 Opik 追踪;框架含 openai/anthropic/langchain/langgraph/crewai/dspy 等。

限制:不在激活阶段迁移提示词、加线程或扩大跨度;不重复埋点;不运行不安全的代表路径;需 LLM 供应商凭证,缺失会阻塞;无法安全验证时停止并返回单一后续步骤。装饰器顺序按框架而定。SDK 细节见 opik 技能引用文件,未安装则参考官方文档。