快速了解 OpenAI Agents SDK (JS)

OpenAI Agents SDK 的 TypeScript 和 JavaScript 移植版，提供相同的 agent、交接、审批和追踪功能。它还支持通过 WebRTC 在浏览器中运行的实时语音 agent；Temporal 持久化集成仍仅支持 Python。

适用于： 希望使用 OpenAI agent 基础功能（包括浏览器中的实时语音）的 Node 和 TypeScript 应用。

关键信息

维护者

OpenAI

语言

TypeScript, JavaScript

许可证

MIT

最新版本

0.18.0 · 2026年9月10日

代码仓库

openai/openai-agents-js · 3,882 个 stars

托管选项

OpenAI Agent Builder (AgentKit) + ChatKit

Agent Builder 已弃用，将于 2026 年 11 月 30 日停止服务；ChatKit 将继续提供。

快速入门

安装软件包、设置凭据，然后运行官方文档中的最简 agent。这里使用的模型 ID 与文档一致，但你的账户可能尚未启用这些模型。

npm install @openai/agents zod

需要 OPENAI_API_KEY

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 in programming.',
);
console.log(result.finalOutput);

快速入门来源

功能

近期更新

• 现在需要 Zod v4。
• 新增沙盒 agent（@openai/agents/sandbox）和实时 agent（@openai/agents/realtime）。

同一语言的替代方案