用途：介绍 Opper 官方统一 SDK（Python 与 TypeScript 均发布为 opperai 包，Agent 能力内置于 SDK，无独立 opperai-agents 包）。
主要能力：兼容端点做一次性结构化任务（输入→带类型输出，推荐 OpenAI SDK 指向 https://api.opper.ai/v3/compat 并配合 response_format）；流式输出（stream: true，标准 OpenAI SSE 语义）；多轮对话（消息数组）；Agent SDK（Agent、tool、Conversation、Hooks、mcp）支持工具调用、多步推理、多智能体与外部 MCP 工具，agent.run(...) 单次执行、agent.stream(...) 实时进度；知识库/RAG 通过 opper.knowledge.*。
安装与认证：pip install opperai（Python，运行时依赖 httpx）；npm install opperai（TypeScript，零运行时依赖，zod 与 @modelcontextprotocol/sdk 为可选 peer）。两者从环境读取 OPPER_API_KEY，也可在构造器传入 api_key / apiKey。
模型：每次调用传 model: "provider/name"；普通计划需显式指定模型，Control Plane 可设默认模型规则后省略。可用 GET https://api.opper.ai/v3/models 发现模型，链接 opper.ai/models 供用户浏览，勿硬编码模型列表。
限制与注意：opper.call / opper.stream 属旧 /call 接口，正在停用，勿在新项目使用，迁移至 compat + response_format；TS 使用 Zod 需 v4；示例中不少入门文件仍演示旧接口，仅作旧代码参考；安装副本可能过期，会话内应比对 https://skills.opper.ai/versions.json。