개요
OpenAI가 2026년 9월 10일 Agents API를 공개 베타로 출시했다. Codex와 ChatGPT for Work를 수백만 명 규모로 운영하며 쌓은 노하우 — 장기 실행 에이전트가 실제로 잘 작동하려면 무엇이 필요한지 — 를 개발자들에게 API로 제공한다.
“유용한 에이전트는 컨텍스트를 관리하고, 도구를 효율적으로 사용하고, 서브에이전트를 조율하는 강력한 하네스(harness)가 필요하다. 또한 며칠 동안 안정적으로 실행될 수 있는 인프라와, 파일을 다루고 코드를 실행하고 중간 결과를 저장할 수 있는 환경이 필요하다.”
제공 범위
- Agents API는 모든 개발자에게 공개 베타로 제공되며 추가 요금 없음
- 모델 토큰, 도구, OpenAI 호스팅 샌드박스 사용량만 과금
- 빠른 시작(quickstart) 및 API 개요 문서 제공
- 일반 출시(GA)로 향하면서 피드백 기반 빠른 반복 예정
4가지 핵심 개념
- Agent: 모델, 지침, 도구, MCP 서버로 구성된 구성
- Environment: 에이전트가 파일 접근, 스킬 로드, 명령 실행을 하는 선택적 샌드박스
- Session: 작업에 응답하고 입력 처리하며 여러 턴에 걸쳐 지속되는 내구성 있는 에이전트 인스턴스
- Events and items: 에이전트로 전송되는 입력과 에이전트가 생성하는 출력
세션 수명주기 (4단계)
- 세션 생성 + 작업 부여
- 스트리밍 또는 웹훅으로 진행 상황 추적
- 새 작업으로 계속하거나 현재 턴을 조정(steer)
- 완료 후 세션 및 산출물 관리
주요 기능
- 자동 컨텍스트 압축: 세션이 컨텍스트 한계에 가까워지면 이전 작업을 요약하여 보존 — 개발자가 자체 압축 로직 구현 불필요
- 도구 검색(Tool Search): 필요할 때만 관련 도구 정의 로드 → 토큰 사용량/비용 절감, 모델 캐시 보존
- 프로그램 도구 호출: 병렬 실행, 체이닝, 결과 필터링/결합 → 대량 데이터 처리 후 관련 결과만 컨텍스트로 반환
- 멀티 에이전트: 복잡한 작업을 독립 조각으로 분해, 서브에이전트에 위임하여 병렬 작업, 메인 에이전트가 조율 및 결과 통합
- MCP, 커스텀 함수, 웹 검색 내장 도구 지원
- OpenAI 호스팅, 셀프 호스팅, 파트너 샌드박스 또는 샌드박스 없음 선택 가능
샌드박스 환경 옵션
- OpenAI 호스팅 샌드박스: Codex와 ChatGPT를 구동하는 동일 샌드박스 인프라 사용. 파일, 패키지, 스킬, 플러그인으로 구성 가능
- 셀프 호스팅: 자체 환경에서
codex exec-server실행, 제한 키로 등록, WebSocket 연결 (모든 연결 아웃바운드) - 파트너 샌드박스: Blaxel, Cloudflare, Daytona, DigitalOcean, E2B, Modal, Oracle, Runloop, Vercel
아키텍처 설계 원칙
- 하네스(통제 평면)와 샌드박스(실행 환경)가 분리됨
- OpenAI가 하네스를 호스팅하고 진화시킴
- 개발자는 에이전트의 계산과 파일 저장 위치를 선택
- 세션 상태는 API 측에서 유지 — 클라이언트 브라우저 탭이 사라져도 작업 계속 가능
예제 코드 (JavaScript)
import OpenAI from "openai";
const client = new OpenAI();
const session = await client.beta.agents.sessions.create({
agent: {
model: "gpt-6-astra",
tools: [
{
type: "mcp",
server_label: "observability",
transport: {
type: "http",
server_url: "https://observability.example.com/mcp",
},
},
],
multi_agent: { enabled: true, max_concurrent_subagents: 3 },
},
vault_ids: ["vault_YOUR_VAULT_ID"],
environment: {
type: "openai_hosted",
capability_directories: ["/workspace/capabilities/skills"],
},
input: "Investigate service-api's elevated 5xx rate over the last 30 minutes. " +
"Delegate deployment, error, and dependency analysis to subagents. " +
"Save findings, evidence, and recommended mitigation in /workspace/outputs.",
});출처: OpenAI 공식 블로그 (2026-09-10) — raw/articles/2026-09-13-openai-agents-api-official-announcement.md
출시 포스트
OpenAI의 Steve Coffey(@stevendcoffey)가 2026-09-11 04:26 KST에 출시 포스트를 올렸다(조회 약 200만). Agents API를 “Codex 하네스가 뒷받침하는, 클라우드에서 에이전트를 만드는 완전히 새로운 방법”이라고 소개하며 “좋아하는 도구와 커넥터를 가져와 어떤 샌드박스든 연결하고 Astra가 요리하게 하라”고 썼다. 스레드에서는 개발팀과 초기 채택사(Ciridae, llmh, SafetyKit, Hypha AI, deepsense.ai, Nash 등)를 언급했다.
관련 노트
- Agents API (OpenAI) — 공식 발표를 유지·확장하는 canonical Agents API 엔티티