仪器

人工智能 社区

技能解读

当前原文的自动摘译,尚未人工审校。

第 1 步——范围

如果提供了$ARGUMENTS,则将您的工作范围限制在这些文件或目录中。否则,发现项目根并检测主要应用程序代码。

第 2 步 — 检测语言和框架

扫描代码库以确定: 语言:Python(查找 *.py、pyproject.toml、requirements.txt)或 TypeScript(查找 *.ts、*.tsx、package.json) 正在使用的 LLM 框架 — 搜索这些模式的导入:导入模式 · 框架 · 集成 from openai / import OpenAI · OpenAI · track_openai

入口点参数规则

标有entrypoint=True的函数必须只接受基元类型的参数:基元的str、int、float、bool和list/dict。这是因为: Opik 读取函数的类型提示以在 UI 中构建输入表单 用户将通过本地运行程序在文本字段中手动输入这些值 复杂类型(Pydantic 模型、数据类、请求对象、自定义类)无法在 UI 输入字段中输入

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
人工智能
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tomevault-io · 未声明许可证
上下文用量评级
中等消耗
接入复杂程度
需手动接入
是否需要外部接口密钥
需要 · Vendor-specific
兼容的系统
macOS · Linux · Windows
运行环境要求
Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
  • 读取环境变量
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 步——范围

如果提供了`$ARGUMENTS`,请将您的工作范围限制在这些文件或目录中。否则,发现项目根并检测主要应用程序代码。

02
第 2 步 — 检测语言和框架

扫描代码库以确定: 语言:Python(查找`*.py`、`pyproject.toml`、`requirements.txt`)或 TypeScript(查找`*.ts`、`*.tsx`、`package.json`)正在使用的 LLM 框架 — 搜索这些模式的导入:导入模式·框架·集成`from openai`/ `import OpenAI`·OpenAI·`track_openai`

03
第 3 步 — 识别调用图

查找: 入口点:启动代理的顶级函数(例如,`main`、`run`、`agent`、`handle_message`、路由处理程序或用户的主要编排函数) LLM 调用站点:直接调用 LLM 提供程序的函数 工具函数:检索、搜索、API 调用或其他类似工具的操作 现有配置类:数据类、Pydantic 模型或包含模型名称、温度、提示或其他可调参数的普通类

04
第 4 步 — 添加框架集成

对于每个检测到的框架,在模块级别添加适当的集成。请参阅上面的积分表和`references/integrations.md`了解确切的模式。 Python 示例: TypeScript 示例:

05
第 6 步 — 对话代理:添加 threadid

如果代理处理多轮对话(聊天机器人、支持代理、多步骤助手),则连线`thread_id`:对于单次代理或批处理跳过此操作。

06
第 7 步 — 环境配置

遵循主要 Opik 技能中的设置决策树:如果项目有 `.env` / `.env.local` → 追加 `OPIK_API_KEY`、`OPIK_WORKSPACE`、`OPIK_URL_OVERRIDE`(如果缺失) 如果不存在 `.env` → Python:创建/更新 `~/.opik.config`; TypeScript:创建`.env`或`.env.local`永远不要引入第二个配置机制永远不要覆盖现有值

07
第 8 步 — 安装依赖项

打印安装命令但不自动运行它。让用户决定。 Python:如果需要的话,加上任何集成包(大多数都包含在`opik`中)。 TypeScript:根据需要加上特定于框架的包:`opik-openai`、`opik-vercel`、`opik-langchain`、`opik-gemini`。

08
第 9 步 — 验证

检测后,进行快速审核: [ ] 每个 LLM 调用点都被跟踪(通过集成包装器或 `@opik.track`) [ ] 仅有一个函数具有 `entrypoint=True` [ ] 入口点函数仅接受原始参数(`str`、`int`、`float`、`bool`、 `list`、`dict`) — 没有 Pydantic 模型、数据类或自定义类 [ ] 所有 `get_or_create_config()` 调用和配置字段访问都发生在 `@opik.track` 修饰的函数内部(或其中一个函数的下游)

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。