---
title: "OpenAI Agents SDK (JS)：功能、版本和快速入门 · DotsAgent"
description: "OpenAI 维护的 OpenAI Agents SDK (JS)：许可证、最新版本、MCP 支持、持久化运行、人工审批、追踪和评测，并附有可复制的快速入门。"
url: https://dotsagent.io/zh/frameworks/openai-agents-js
---

框架 · OpenAI

# 快速了解 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](https://github.com/openai/openai-agents-js) · 3,882 个 stars
- **托管选项**: [OpenAI Agent Builder (AgentKit) + ChatKit](https://developers.openai.com/api/docs/guides/agent-builder)Agent Builder 已弃用，将于 2026 年 11 月 30 日停止服务；ChatKit 将继续提供。

## 快速入门

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

`安装`

```
npm install @openai/agents zod
```

需要 OPENAI_API_KEY

`TypeScript`

```
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);
```

[快速入门来源](https://openai.github.io/openai-agents-js/)

## 功能

| 支持任意模型 | — | 通过 @openai/agents-extensions 接入非 OpenAI 提供商 |
| --- | --- | --- |
| MCP 客户端 | — | — |
| MCP 服务器 | — | — |
| 多 agent | — | 交接和将 agent 用作工具 |
| 持久化运行 | — | 可序列化的运行状态，但没有官方持久化引擎 |
| 人工审批 | — | — |
| 追踪 | — | — |
| 评测 | — | — |

## 近期更新

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

## 同一语言的替代方案

- [Claude Agent SDK](https://dotsagent.io/zh/frameworks/claude-agent-sdk)

- [Google ADK](https://dotsagent.io/zh/frameworks/google-adk)

- [LangGraph](https://dotsagent.io/zh/frameworks/langgraph)

- [LlamaIndex](https://dotsagent.io/zh/frameworks/llamaindex)

- [Mastra](https://dotsagent.io/zh/frameworks/mastra)

- [Vercel AI SDK](https://dotsagent.io/zh/frameworks/vercel-ai-sdk)

## 来源

1. [openai.github.io](https://openai.github.io/openai-agents-js/)/openai-agents-js/
2. [registry.npmjs.org](https://registry.npmjs.org/@openai%2fagents)/@openai%2fagents
3. [api.github.com](https://api.github.com/repos/openai/openai-agents-js)/repos/openai/openai-agents-js

为 AI agent 开发者提供的独立参考资料。与此处提及的任何厂商均无关联。

© 2026 DotsAgent · 事实核查日期：2026年10月1日