OpenAI Agents API 공식 발표 — 요약

개요

OpenAI가 2026년 9월 10일 Agents API를 공개 베타로 출시했다. Codex와 ChatGPT for Work를 수백만 명 규모로 운영하며 쌓은 노하우 — 장기 실행 에이전트가 실제로 잘 작동하려면 무엇이 필요한지 — 를 개발자들에게 API로 제공한다.

“유용한 에이전트는 컨텍스트를 관리하고, 도구를 효율적으로 사용하고, 서브에이전트를 조율하는 강력한 하네스(harness)가 필요하다. 또한 며칠 동안 안정적으로 실행될 수 있는 인프라와, 파일을 다루고 코드를 실행하고 중간 결과를 저장할 수 있는 환경이 필요하다.”

제공 범위

• Agents API는 모든 개발자에게 공개 베타로 제공되며 추가 요금 없음
• 모델 토큰, 도구, OpenAI 호스팅 샌드박스 사용량만 과금
• 빠른 시작(quickstart) 및 API 개요 문서 제공
• 일반 출시(GA)로 향하면서 피드백 기반 빠른 반복 예정

4가지 핵심 개념

1. Agent: 모델, 지침, 도구, MCP 서버로 구성된 구성
2. Environment: 에이전트가 파일 접근, 스킬 로드, 명령 실행을 하는 선택적 샌드박스
3. Session: 작업에 응답하고 입력 처리하며 여러 턴에 걸쳐 지속되는 내구성 있는 에이전트 인스턴스
4. Events and items: 에이전트로 전송되는 입력과 에이전트가 생성하는 출력

세션 수명주기 (4단계)

1. 세션 생성 + 작업 부여
2. 스트리밍 또는 웹훅으로 진행 상황 추적
3. 새 작업으로 계속하거나 현재 턴을 조정(steer)
4. 완료 후 세션 및 산출물 관리

주요 기능

• 자동 컨텍스트 압축: 세션이 컨텍스트 한계에 가까워지면 이전 작업을 요약하여 보존 — 개발자가 자체 압축 로직 구현 불필요
• 도구 검색(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

관련 노트

• Agents API (OpenAI) — 공식 발표를 유지·확장하는 canonical Agents API 엔티티