用途:为 Python 智能体与 LLM 应用接入 Opik 观测,记录调用链路、配置与会话信息。
前置:pip install opik && opik configure 获取 API key。
主要能力与用法:
- 用 @opik.track 装饰函数标注追踪范围,可设 entrypoint=True、name 以及 type;span 类型包括 general(默认)、llm、tool、guardrail。
- 继承 opik.AgentConfig 定义配置字段,用 client.create_agent_config_version 创建版本;在 @opik.track 内部调用 client.get_agent_config() 读取配置,选择器支持 latest=True、env="prod"、version="v1",并可用 fallback 兜底。
- 框架集成:track_openai、track_anthropic、OpikTracer(LangChain)、track_crewai;集成与 @opik.track 不要重复包裹。
- 会话线程:在追踪函数内调用 opik.update_current_trace(thread_id=session_id)。
限制与注意事项:脚本退出前需 opik.flush_tracker();entrypoint 参数需类型提示以支持 Local Runner 的 schema 发现;get_agent_config() 必须位于 @opik.track 内,否则报错。资料未提供具体定价与更完整平台说明。