SDK OpenAI-Agents-JS 在JS里构建可编排AI智能体

一、项目介绍

用 JS/TS 写 AI 智能体，最烦的是“会话、工具调用、多智能体协作全要自己接”：你想让 Agent 调工具、跑沙箱、多角色配合，却要在底层循环里反复造轮子。
OpenAI Agents SDK for JavaScript 是一个轻量、可编排的智能体开发包。它提供 Agent、run、工具、handoff（转交）、guardrails 等原语，让你用很少代码搭出会调用工具、可多智能体协作的 JS 应用，并与 OpenAI 模型深度打通。

二、项目基本信息

三、核心优势

• 极简 API：Agent + run 几行即可跑起来
• 原生支持工具调用与多智能体 handoff
• 内置沙箱（sandbox）Agent，安全执行代码
• 与 OpenAI 模型与生态无缝衔接
• TypeScript 友好，类型完整

四、适用场景

适合用 JavaScript/TypeScript 构建 AI 智能体、需要工具调用与多智能体协作的 Web 与 Node 开发者。

五、安装教程

当前最新版本 latest。按下方命令安装（如遇网络问题可切换镜像源或代理）：

# 安装 SDK 与校验库
npm install @openai/agents zod

常见报错：依赖缺失时先升级运行环境（Node、Python、Go、JDK 等）到项目要求版本；网络超时多为镜像或代理问题，可重试或换源。权限类报错请确认已登录对应平台账号。

六、使用示例

下面是一段可直接参考的真实示例：

import { Agent, run } from '@openai/agents';
const agent = new Agent({
  name: 'Assistant',
  instructions: 'You are a helpful assistant.',
});
const result = await run(agent, '用一句话介绍 TypeScript');
console.log(result.finalOutput);

七、常见问题

问：只能用 OpenAI 模型吗？答：SDK 面向 OpenAI 模型设计，也支持兼容接口。问：能在浏览器跑吗？答：提供面向 Web 的构建，也可在 Node 中使用沙箱 Agent。

八、总结

OpenAI-Agents-JS 用一个清晰的设计，把把复杂能力封装成可嵌入的基座这件反复劳动变成了可复用、可维护的能力。它不追求大而全，而是把核心痛点解决得足够扎实——这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰，不妨按上面的安装与使用步骤试一试，把它接进自己的工作流。