SuperAPI AI 工具集

opik-connect

编程与开发

查看项目

更新于 10-15 20:14

技能介绍

用途:Opik Connect(本地运行器)用于把本地运行的智能体与 Opik 浏览器界面配对,从而在 Opik UI 中触发本地智能体执行。

主要能力:支持 Python 与 TypeScript。Python 侧用 @track(entrypoint=True) 包装服务端点,例如 FastAPI 路由;可用 @track(entrypoint=True, name="fantastic_agent") 自定义智能体名称。TypeScript 侧使用 track() 并显式传入 params(必需,因为 TS 编译会剥离参数名与类型);若省略 params,则所有参数按 string 类型处理。

使用方式:先从 Opik UI 获取配对码,然后运行 opik connect --pair <CODE> python3 echo_app.py(Python)或 opik connect --pair <CODE> npx tsx summarise.ts(TypeScript)。配对后,entrypoint 会注册为智能体,UI 根据 Python 类型提示或 TypeScript 的 params 显示输入表单,来自 UI 或 Optimizer 的任务会触发运行。

限制与排错:找不到 entrypoint 时,需添加 entrypoint=True(Python)或 entrypoint: true(TS);配对码无效时,因配对码会过期,需重新获取;连接被拒绝时,检查 Opik 服务器(OSS)或 API key(Cloud)。