OpenAI Agents API — ZDR·한국 서비스 시기·일반 개발자 사용법 종합

한 줄 결론: openai-agents-api는 오늘 한국에서도 호출은 되지만 저장 위치는 미국이며, ZDR도 한국 리전 일정도 없다 — 일반 개발자는 openai_hosted + restricted 네트워크로 작게 시작하면 된다.

질문

ZDR이란 무엇인가?
Agents API의 한국 서비스 예정일은 언제인가?
일반 개발자는 Agents API를 어떻게 사용할 수 있는가?

ZDR이란

ZDR = Zero Data Retention(무보존) — 요청·응답 데이터를 처리 직후 저장하지 않는 옵션이다. 기본값이 아니며, OpenAI API 적격 고객 대상 계약·설정 조건으로 제공된다. 저장하지 않고 모델 학습에도 사용하지 않는 것이 핵심이다.

Agents API 맥락에서 중요한 이유: openai-agents-api는 ZDR 미지원이 핵심 제약이다. 데이터 거주지는 미국 전용이며, 셀프 호스팅 샌드박스를 선택해도 ZDR 적격이 되지 않는다. 실행 환경이 외부에 있어도 세션 상태가 API 측에 유지되기 때문이다. 즉 규제 지역·저장 금지 요구사항 조직은 도입 불가다.

한국 서비스 예정일: 없음

공개 베타(2026-09-10) 기준으로 다음이 모두 미공개다: GA 일정, SLA, 세션 최대 수명, 미국 외 데이터 거주지·ZDR 지원 시기. 외부 교차 확인도 동일하다 — “OpenAI’s documentation gives no timeline for non-US residency.”

정리하면:

한국 리전 일정은 존재하지 않는다. 한국에서 호출 자체는 가능하나 세션·이벤트·산출물 저장 위치는 미국이다.
볼트 기준 유일한 선행 신호는 OpenAI data controls 페이지의 Agents API 행이 regional 테이블로 이동하는지 여부다.

일반 개발자 사용법

일반 개발자는 관리형 런타임 고객으로 쓴다. 하네스·세션·압축·복구는 OpenAI 담당, 개발자는 도구와 실행 환경만 책임진다.

전제

OpenAI API 키 + 최신 SDK, 베타 헤더 OpenAI-Beta: agents=v1 (SDK 자동 부가)
플랫폼 요금 없음. 과금 3계층: 모델 토큰 + 도구(웹검색 등) + 호스팅 샌드박스 컨테이너
미국 거주지 전용 + ZDR 미지원 — 민감정보 대량 처리가 아니면 개인 개발자는 그대로 쓰면 된다

최소 호출 흐름 (4단계)

Agent 정의 → Environment 선택 → Session 생성+input → 스트림/웹훅 추적·조종:

from openai import OpenAI
 
with OpenAI() as client:
    with client.beta.agents.sessions.create(
        agent={
            "model": "gpt-6-astra",
            "instructions": "Write clean code, run it, and report actual output.",
        },
        environment={"type": "openai_hosted"},
        input="Reproduce failing test in /workspace and propose fix.",
        stream=True,
    ) as events:
        for event in events:
            if event.type == "agent.session.turn.completed":
                break

JS 예시는 openai-agents-api의 ## API 호출 예시 참조 — client.beta.agents.sessions.create() + agent.tools(MCP) + multi_agent + vault_ids + environment 구조 동일.

Environment 선택

none — 도구호출·코드실행 불필요 시. 가장 싸고 단순, 첫 테스트용
openai_hosted — 기본 추천. Linux+Python/Node, 작업 dir /workspace, 산출물은 /workspace/outputs에 불변 게시
self_hosted — 내 머신에서 codex exec-server + restricted key, WebSocket 아웃바운드. 세션 상태는 여전히 API 측 유지 = ZDR 해결 안 됨
파트너 9곳 (Blaxel, Cloudflare, Daytona, DigitalOcean, E2B, Modal, Oracle, Runloop, Vercel) — 실행 위치만 이동

네트워크는 enabled(기본) → 프로덕션에서 disabled/restricted(호스트 1~100개)로 축소. 자세한 자원 4종과 세션 수명주기 4단계는 openai-agents-api 참조.

운영 체크리스트

비밀은 vault_ids로 주입, 스킬은 capability_directories: ["/workspace/capabilities/skills"]
장기 작업의 중요 상태는 파일·DB·/workspace/outputs에 별도 저장 (자동 압축이 완벽 보존 아님)
서브에이전트: multi_agent.enabled + max_concurrent_subagents (최대 6, 동일 FS 공유 → 병렬 쓰기 충돌은 사용자 설계 책임)
측정 지표: 장기 세션 완료율, 압축 후 조건 보존율, 끊김 후 재개 성공률, 멀티 대비 토큰·지연·충돌 횟수
시작점: openai_hosted 1GB ($0.03/20분) + restricted + 공개 저장소·합성 데이터
직접 루프 제어가 필요하면 Agents SDK, 짧은/커스텀 워크플로면 Responses API. 로컬 원형은 codex (openai/codex, Apache-2.0)

description	Agents API의 ZDR 미지원 의미와 한국 리전 일정 부재, 일반 개발자의 환경 선택·호출·운영 기준을 한 노트로 종합한다.
tags	ai-agents, openai, automation, synthesis

LLM Wiki

탐색기