---
title: "OpenAI Agents SDK (JS): 기능, 버전, Quickstart · DotsAgent"
description: "OpenAI의 OpenAI Agents SDK (JS): 라이선스, 최신 버전, MCP 지원, 내구성 있는 실행, 사람의 승인, 추적 및 평가 기능을 확인하고 복사해 쓸 수 있는 Quickstart를 살펴보세요."
url: https://dotsagent.io/ko/frameworks/openai-agents-js
---

프레임워크 · OpenAI

# OpenAI Agents SDK (JS) 한눈에 보기

OpenAI Agents SDK의 TypeScript 및 JavaScript 포트로, 동일한 에이전트, 핸드오프, 승인 및 트레이싱 기능을 제공합니다. 브라우저에서 WebRTC를 통해 실행되는 실시간 음성 에이전트가 추가되었으며, Temporal 내구성 통합은 여전히 Python 전용입니다.

**추천 용도:**  브라우저에서 실시간 음성 기능을 포함한 OpenAI의 에이전트 프리미티브를 사용하려는 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개
- **호스팅 옵션**: [OpenAI Agent Builder (AgentKit) + ChatKit](https://developers.openai.com/api/docs/guides/agent-builder)Agent Builder는 지원 중단 예정이며 30 November 2026에 종료됩니다. ChatKit은 계속 제공됩니다.

## Quickstart

패키지를 설치하고 인증 정보를 설정한 다음, 공식 문서에서 가장 간단한 에이전트를 실행하세요. 모델 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);
```

[Quickstart 출처](https://openai.github.io/openai-agents-js/)

## 기능

| 모든 모델 | — | @openai/agents-extensions를 통한 비 OpenAI 제공자 지원 |
| --- | --- | --- |
| MCP 클라이언트 | — | — |
| MCP 서버 | — | — |
| 멀티 에이전트 | — | 핸드오프 및 도구로 사용하는 에이전트 |
| 내구성 있는 실행 | — | 직렬화 가능한 실행 상태를 제공하지만, 퍼스트파티 내구성 엔진은 없습니다. |
| 사람의 승인 | — | — |
| 트레이싱 | — | — |
| Evals | — | — |

## 최근 변경 사항

- 이제 Zod v4가 필요합니다.
- 샌드박스 에이전트(@openai/agents/sandbox)와 실시간 에이전트(@openai/agents/realtime)가 추가되었습니다.

## 같은 언어로 만든 대안

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

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

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

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

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

- [Vercel AI SDK](https://dotsagent.io/ko/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 에이전트를 만드는 개발자를 위한 독립적인 참고 자료입니다. 여기에 언급된 어떤 업체와도 제휴 관계가 없습니다.

© 2026 DotsAgent · 정보 확인일: 2026년 10월 1일