@openai/agents

@openai/agents 是 OpenAI 官方发布的 JavaScript/TypeScript 多 Agent 开发框架（OpenAI Agents SDK），GitHub 星标 3680+。它是一个轻量但功能完备的框架，用于在 JavaScript/TypeScript 环境中构建多 Agent 工作流，支持 OpenAI API 及更多提供商。

该框架的核心概念包括：

1. Agent 类型

• 文本 Agent（Agent）：处理基于文本的工作流，适用于不需要沙箱工作区或实时会话的场景
• 沙箱 Agent（Sandbox Agent）：与文件系统工作区和沙箱环境配对，适合长时间运行的任务，支持 macOS/Linux（UnixLocalSandboxClient）和 Windows（DockerSandboxClient）
• 实时 Agent（Realtime Agent）：低延迟语音交互 Agent，通过 WebRTC 在浏览器中连接麦克风和音频输出

2. 核心功能

• 工具（Tools）：支持函数工具、MCP 工具和托管工具，让 Agent 能够执行具体操作
• 安全护栏（Guardrails）：可配置的安全检查，用于输入输出验证
• 人工介入（Human in the loop）：内置机制，在 Agent 运行过程中引入人工判断
• 会话管理（Sessions）：跨 Agent 运行自动管理对话历史
• 调用追踪（Tracing）：内置追踪功能，可视化调试和优化工作流
• Agent 间转交（Handoffs）：将任务委托给专门的 Agent

3. 支持环境

• Node.js 22 及以上
• Deno
• Bun
• 实验性支持：Cloudflare Workers（需启用 nodejs_compat）

安装方式：

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.");
console.log(result.finalOutput);

适用场景：构建客服机器人、研究助手、代码生成工作流、多步骤自动化任务等。是目前 JavaScript/TypeScript 生态中最完整的官方多 Agent 开发框架。