OpenAI Agents SDK (JavaScript/TypeScript)

OpenAI Agents SDK 是一个轻量级但功能强大的框架，用于在 JavaScript/TypeScript 中构建多智能体工作流。它不依赖于特定供应商，支持 OpenAI API 及其他服务。

[!NOTE]
寻找 Python 版本？请查看 OpenAI Agents SDK Python。

核心概念

1. 智能体：配置了指令、工具、防护栏和交接的 LLM。
2. 智能体即工具 / 交接：将特定任务委托给其他智能体。
3. 工具：多种工具让智能体能够执行操作（函数、MCP、托管工具）。
4. 防护栏：可配置的安全检查，用于输入和输出验证。
5. 人工介入：在智能体运行过程中引入人工干预的内置机制。
6. 会话：跨智能体运行的自动对话历史管理。
7. 追踪：智能体运行的内置追踪功能，允许您查看、调试和优化工作流。
8. 实时智能体：构建功能齐全的强大语音智能体。

查看 examples/ 目录以了解 SDK 的实际应用。

快速开始

支持的环境

• Node.js 22 或更高版本
• Deno
• Bun

实验性支持：

• 启用了 nodejs_compat 的 Cloudflare Workers

查看文档 获取更详细的信息。

安装

npm install @openai/agents zod

运行你的第一个智能体

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);
// Code within the code,
// Functions calling themselves,
// Infinite loop's dance.

（运行此代码时，请确保已设置 OPENAI_API_KEY 环境变量）

查看 examples/ 目录以了解 SDK 的实际应用。

致谢

我们要感谢开源社区的卓越工作，特别是：

• zod（模式验证）
• Starlight
• vite 和 vitest
• pnpm
• Next.js

我们致力于将 Agents SDK 构建为一个开源框架，以便社区中的其他人能够扩展我们的方法。

更多详情，请参阅 文档 或探索 examples/ 目录。