Framework openai-agents-js OpenAI官方的TypeScript智能体开发库

一、项目介绍

在 TypeScript 侧做智能体，过去要么自己用底层 SDK 拼工具调用与循环，要么引入体积庞大的框架。轻量项目想要几行代码跑起一个能调用工具的 Agent，却常被样板代码劝退。
OpenAI Agents JS 是官方出品的 TypeScript 智能体库，提供 Agent、run、tool、handoff 等轻量原语，让你用少量代码定义智能体、给它挂工具和子智能体，并在 Node.js 或 Cloudflare Workers 上运行。它把编排循环从你手里收走，只留清晰的组合接口。

二、项目基本信息

三、核心优势

• 官方出品：与 OpenAI 模型与生态对齐
• 轻量原语：Agent / run / tool / handoff 组合清晰
• TypeScript 优先：类型体验完整，前端到边缘都能用
• 多运行时：支持 Node.js 22 加与 Cloudflare Workers
• 可组合：工具与子智能体（handoff）即插即用

四、适用场景

适合在 TypeScript 全栈、前端、边缘函数（Workers）中构建能调用工具、能多智能体交接的轻量 Agent。

五、安装教程

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

npm install @openai/agents zod

常见报错：依赖缺失时先升级运行环境（如 Node、Python、.NET、JDK）到项目要求版本；网络超时多为镜像或代理问题，可重试或换源。

六、使用示例

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

import { Agent, run } from '@openai/agents';

const agent = new Agent({
  name: 'Assistant',
  instructions: 'You are a helpful assistant.',
});
const result = await run(agent, 'Write a haiku about recursion.');
console.log(result.finalOutput);

七、常见问题

问：必须直连 OpenAI 吗？答：库面向 OpenAI 模型与接口设计，需相应的 API Key。问：能和前端一起打包吗？答：支持 Node.js 与 Cloudflare Workers（需开启 nodejs_compat）。

八、总结

openai-agents-js 用一个清晰的设计，把把一类应用范式标准化这件事从重复劳动变成了可复用、可维护的工程能力。它不追求大而全，而是把核心痛点解决得足够扎实，这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰，不妨按上面的安装与使用步骤试一试，把它接进自己的工作流。