用途：使用 Opper TypeScript Agent SDK（@opperai/agents）构建类型安全的 AI 智能体。
主要能力：智能体采用 Think-Act-Observe 循环，反复思考、调用工具并观察结果，直到达成目标后返回校验过的输出，循环上限由 maxIterations 控制（默认 25）。支持用 createFunctionTool 或 @tool 装饰器（配合 extractTools）定义 Zod 校验工具；用 Zod 模式定义结构化输出；可指定 model 或模型回退链；支持把智能体通过 asTool 组合成多智能体；支持 enableStreaming 流式回调；可通过 mcp 与 MCPconfig 连接外部 MCP 服务器；支持 HookEvents 注册生命周期钩子，工具钩子带 toolCallId。run() 返回 result 与 usage（requests、inputTokens、outputTokens、totalTokens）。
使用方式：安装 npm install @opperai/agents（或 pnpm add / yarn add），要求 Node.js 20+，设置 export OPPER_API_KEY="your-api-key"（密钥来自 platform.opper.ai）。定义工具后创建 Agent，调用 await agent.run(...)，注意 run() 与 process() 均为异步需 await。
适用场景：需要多步推理、工具调用、结构化输出、多智能体协作或流式输出的 TypeScript/Node.js 智能体应用。
限制：未提供收费、价格与性能数据。常见错误包括忘记 await、工具缺少清晰名称与 Zod 模式、未设 outputSchema 导致返回非结构化字符串、工具数量过多（建议每个智能体 5-10 个）。相关技能有 opper-node-sdk（单次任务）与 opper-python-agents（Python 版）；内容可能过时，应优先以已安装包 node_modules/@opperai/agents/ 为准，其次为 GitHub 源码与 docs.opper.ai 文档。