用途:Opper Node/TypeScript SDK(包名 opperai)用于在 TypeScript 应用中构建 AI 功能,通过声明式任务描述获得模型结果,并支持结构化输出、知识库语义检索、流式输出与追踪。
安装与配置:使用 npm add opperai(或 pnpm/yarn/bun 对应命令),并设置环境变量 export OPPER_HTTP_BEARER="your-api-key",API Key 来自 platform.opper.ai。
主要能力:opper.call() 是核心接口,可传入 name、instructions、input,并获得结果;outputSchema 支持 JSON Schema 结构化输出,通过 result.jsonPayload 读取。可定义 inputSchema/outputSchema 实现类型安全交互;支持 model 参数选择模型(如 anthropic/claude-4-sonnet,可用提供商前缀包括 openai/、anthropic/、google/ 等);examples 提供少样本示例;opper.stream() 支持按 token 流式返回;parentSpanId 与 tags 支持追踪、过滤与成本归因。
使用方式与注意:所有方法均为 async,必须 await;缺少 httpBearer 将无法认证,应使用 OPPER_HTTP_BEARER 环境变量;JSON Schema 字段默认可选,需显式写 required;SDK 提供 errors 模块(如 OpperError、BadRequestError)用于错误处理。函数 CRUD 与版本、知识库与 RAG、追踪、流式、从 OpenRouter 迁移等细节见资料中的 references 文档。相关技能包括 opper-node-agents(自主智能体)与 opper-python-sdk(Python)。若内容可能过期,可优先查阅已安装包 node_modules/opperai/、源码仓库与官方文档。具体收费与价格资料暂未提供。