如何快速上手OpenAI Agents SDK：10分钟创建你的第一个智能体助手

OpenAI Agents SDK是一个轻量级且功能强大的框架，专为构建多智能体工作流和语音智能体而设计。通过这个终极工具包，即使是新手也能在短短10分钟内创建自己的第一个智能体助手，开启AI应用开发之旅。## 📋 准备工作：环境搭建步骤在开始创建智能体之前，我们需要先完成基础环境的搭建。请确保你的系统中已经安装了Node.js和pnpm包管理器。首先，克隆项目仓库到本地：```

甄旖昀Melanie

634人浏览 · 2026-05-11 10:25:23

甄旖昀Melanie · 2026-05-11 10:25:23 发布

如何快速上手OpenAI Agents SDK：10分钟创建你的第一个智能体助手

【免费下载链接】openai-agents-js A lightweight, powerful framework for multi-agent workflows and voice agents 项目地址: https://gitcode.com/gh_mirrors/ope/openai-agents-js

OpenAI Agents SDK是一个轻量级且功能强大的框架，专为构建多智能体工作流和语音智能体而设计。通过这个终极工具包，即使是新手也能在短短10分钟内创建自己的第一个智能体助手，开启AI应用开发之旅。

📋 准备工作：环境搭建步骤

在开始创建智能体之前，我们需要先完成基础环境的搭建。请确保你的系统中已经安装了Node.js和pnpm包管理器。

首先，克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/ope/openai-agents-js
cd openai-agents-js

然后安装项目依赖：

pnpm install

这个步骤会安装所有必要的依赖项，包括核心的@openai/agents包，为后续的智能体开发做好准备。

🔍 OpenAI Agents SDK核心架构解析

OpenAI Agents SDK采用了模块化的设计，让开发者能够轻松构建复杂的智能体系统。核心架构主要包含以下几个部分：

图：OpenAI Agents SDK的架构示意图，展示了智能体在沙箱环境中的工作流程

Server/Agent Harness：智能体的启动和管理中心
Sandbox：安全的执行环境，包含Agent Loop、MCPs/Tools和Filesystem
Gateway Service：处理外部数据访问和安全控制

这种架构设计确保了智能体能够安全、高效地运行，同时提供了丰富的工具和服务支持。

🚀 10分钟创建第一个智能体助手

现在，让我们通过一个简单的示例来创建你的第一个智能体助手。我们将使用项目中提供的基础示例作为起点。

步骤1：创建基础智能体文件

在examples/basic/目录下，创建一个名为hello-world.ts的文件。这个文件将包含我们智能体的基本代码。

步骤2：编写智能体代码

以下是一个简单的智能体示例，它只能用俳句（haiku）来回应：

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

async function main() {
  const agent = new Agent({
    name: 'Assistant',
    instructions: 'You only respond in haikus.',
  });

  const result = await run(
    agent,
    'Tell me about recursion in programming. Quickly responding with a single answer is fine.',
  );
  console.log(result.finalOutput);
  // 示例输出：
  // Function calls itself,
  // Looping in smaller pieces,
  // Endless by design.
}

main().catch((error) => {
  console.error(error);
  process.exit(1);
});

这段代码创建了一个名为"Assistant"的智能体，并限制它只能用俳句回应。然后我们运行这个智能体，询问关于编程中递归的问题。