用途:面向 Opik 智能体的生命周期运维,涵盖架构、配置、本地运行、评估、会话线程与生产监控。
主要能力:
- 埋点:使用 @opik.track 并设置 entrypoint=True,配合 opik.AgentConfig 记录智能体运行。
- 配置:把配置外置到 AgentConfig,Opik 以 Blueprints 管理并支持 dev/prod 环境标签;可创建配置版本、按 latest、env="prod" 或 version="v1" 获取,并用 cfg.deploy_to("prod") 晋升。
- 本地运行:opik connect --pair <CODE> <startup_cmd> 与 Opik UI 配对,例如 opik connect --pair ABC123 python3 app.py 或 opik connect --pair ABC123 npx tsx app.ts。Python 用 @track(entrypoint=True) 加类型标注参数;TypeScript 用 track({ entrypoint: true, params: [{name, type}] }, fn)。
- 评估:get_or_create_evaluation_suite 创建评估套件,支持断言与执行策略(如 runs_per_item、pass_threshold),suite.run 执行并检查 results.all_passed。
- 会话线程:在 @opik.track 函数内用 opik.update_current_trace(thread_id=session_id) 关联对话。
- 监控与优化:仪表盘、在线评估、告警、护栏;MaskIDs 做配置 A/B 测试并晋升胜出 Blueprint。
限制与注意:get_agent_config() 必须写在被 @track 装饰的函数内;对话型智能体需接入 thread_id;TypeScript 需显式 params 数组;避免硬编码配置与缺少 entrypoint。参考资料包括 references/agent-patterns.md、references/evaluation.md(含 41 个内置指标)、references/production.md。具体收费与平台细节暂未提供。