SuperAPI AI 工具集

netra-best-practices

智能体与模型

查看项目

更新于 10-15 23:45

技能介绍

用途:作为端到端指南,帮助集成、运行和改进基于 Netra 的 AI 系统。

主要能力与流程:

  1. 检测项目语言:按顺序检查信号文件,pyproject.toml、setup.py、requirements.txt、Pipfile 判定为 Python;package.json、tsconfig.json、bun.lockb 判定为 TypeScript/JavaScript。若同时存在(monorepo)需询问用户;都未找到也需询问。之后只使用对应语言的参考,不得混用。
  2. 安装:安装 netra-sdk 前先检测包管理器,按优先级:uv.lock 用 uv add netra-sdk;poetry.lock 用 poetry add netra-sdk;pyproject.toml(无上述锁文件)用 pip install netra-sdk;requirements.txt 用 pip install netra-sdk;yarn.lock 用 yarn add netra-sdk;pnpm-lock.yaml 用 pnpm add netra-sdk;package-lock.json 用 npm install netra-sdk;bun.lockb 用 bun add netra-sdk;未找到则先询问。不要运行多个安装命令,也不要全局安装。
  3. 加载参考:Python 参考位于 references/python/,包括 instrumentation.md(LLM 应用插桩)、evaluation.md(评估/测试套件)、simulation.md(多轮模拟)、custom-metrics.md(自定义指标:计数器、直方图、仪表)。TypeScript 参考位于 references/typescript/,包括 instrumentation.md、evaluation.md、simulation.md,custom-metrics.md 目前 TS 不支持自定义指标。
  4. 防幻觉规则:不得使用官方文档未列出的枚举值;不得混用 Python 与 TypeScript 约定——Python 用 snake_case(as_type、module_name、app_name),TypeScript 用 camelCase(asType、moduleName、appName);Python 插桩集合写作 {InstrumentSet.OPENAI},TypeScript 写作 new Set([NetraInstruments.OPENAI]);生命周期不同:Python 的 Netra.init(...) 同步,TypeScript 的 await Netra.init(...) 异步且必须 await;Python 用 with Netra.start_span(...) as span: 自动关闭,TypeScript 必须在 finally 中手动调用 span.end()。不确定 API 时走文档获取流程,不要猜测。
  5. 文档回退:若参考文件未覆盖用例,先获取 https://docs.getnetra.ai/llms.txt 索引,找到相关页面后再获取详细指南。

适用场景:为 Python 或 TypeScript/JavaScript 的 LLM 应用接入 Netra 插桩、评估、模拟与自定义指标。

限制:TypeScript 暂不支持自定义指标;语言与包管理器未识别时需先询问用户;反馈可提交至 https://github.com/KeyValueSoftwareSystems/netra-skills/issues/new。