OpenAI Agents API 런칭 – 지속 가능한 클라우드 에이전트를 위한 관리형 하네스

TL;DR

OpenAI의 Agents API는 코드를 실행하고 도구에 접근하며 세션 간 상태를 유지할 수 있는 지속 가능한 에이전트를 빌드하기 위한 관리형 클라우드 호스팅 하네스를 제공합니다. OpenAI 호스팅 및 자체 호스팅 모두 가능한 사전 환경을 제공합니다.

Agents API란 무엇인가

Agents API는 새로운 OpenAI 관리형 엔드포인트로, 에이전트 하네스를 구축하고 운영하는 복잡성을 추상화합니다. 이는 Codex 런타임을 프로비저닝하고 세션 상태를 관리하며, 컨텍스트 압축을 처리하고 내장된 도구(웹 검색, 함수 호출, MCP 연결, 플러그인, 벌트)를 제공합니다. 개발자는 에이전트의 모델, 지침, 도구, 그리고 선택적 사전 환경 설정만 정의하면 됩니다.

핵심 개념 (자체 포함)

에이전트 – 모델(예: gpt-6-astra), 시스템 지침, 그리고 에이전트가 호출할 수 있는 도구의 조합입니다.
환경 – 선택적 사전 환경(OpenAI 호스팅 또는 자체 호스팅)으로, 파일 시스템, 기능 디렉터리, 코드 또는 외부 명령 실행 기능을 제공합니다.
세션 – 지속 가능한 에이전트 인스턴스로, 전환 간 상태를 유지합니다. 이벤트 스트리밍, 웹훅 사용, 전환 중 에이전트 조정이 가능합니다.
이벤트 및 항목 – 세션을 통해 흐르는 고유한 입력(사용자 메시지, 도구 호출)과 출력(응답, 아티팩트)입니다.

"Agents API는 OpenAI가 관리하는 API를 통해 애플리케이션에 Codex 하네스에 접근할 수 있게 해줍니다. OpenAI는 세션, 오케스트레이션, 컨텍스트 압축, 복구를 관리하지만, 애플리케이션은 도구를 제공하고 실행 환경을 선택합니다." – OpenAI 문서

빠른 시작 개요 (자체 포함)

세션 생성 – 에이전트 정의와 환경 설정을 제공합니다. OpenAI가 사전 환경을 프로비저닝합니다.
작업 제출 – 환경이 준비되면 첫 번째 사용자 메시지가 전환을 시작합니다.
진행 상황 모니터링 – 이벤트 스트리밍 또는 웹훅 콜백을 통해 에이전트가 완료되었거나 추가 입력이 필요한 시점을 알 수 있습니다.
계속 또는 조정 – 동일한 세션에 추가 입력을 전송하거나 현재 전환 중 에이전트를 안내할 수 있습니다.

API는 이후 전환에 재사용할 수 있는 session.id를 반환하여, 사고 대응, 데이터 분석, 코드 리뷰와 같은 장기 실행 워크플로우를 가능하게 합니다.

가격 모델 (자체 포함)

모델 사용량 – 선택한 모델의 표준 요금제에 따라 청구됩니다(예: gpt-6-astra).
도구 사용량 – OpenAI의 표준 도구 요금제에 따라 청구됩니다.
사전 환경 호스팅 – 내장 도구 항목에 나와 있는 컨테이너 요금제에 따라 청구됩니다.
데이터 거주지 – 현재 미국에 한정됨. 자체 호스팅 사전 환경을 사용하더라도 Zero Data Retention (ZDR)을 지원하지 않습니다.

예제 세션 생성 (자체 포함)

아래는 자체 호스팅 사전 환경, 웹 검색, MCP 도구를 사용하며 최대 4개의 동시 하위 에이전트를 허용하는 세션을 생성하는 최소한의 Python 예제입니다:

from openai import OpenAI

client = OpenAI()

session = client.beta.agents.sessions.create(
    agent={
        "model": "gpt-6-astra",
        "instructions": "OpenAI 문서 MCP와 웹 검색을 사용하여 기술적 질문에 정확하게 답변하세요. 유용할 경우 독립적인 연구 작업을 하위 에이전트에게 위임하세요.",
        "tools": [
            {"type": "programmatic_tool_calling"},
            {"type": "mcp", "server_label": "openai_docs", "transport": {"type": "http", "server_url": "https://developers.openai.com/mcp"}},
            {"type": "web_search"},
        ],
        "multi_agent": {"enabled": True, "max_concurrent_subagents": 4},
    },
    environment={
        "type": "self_hosted",
        "workspace_directory": "/workspace",
        "capability_directories": ["/workspace/capabilities/skills"],
    },
    input=[
        {"role": "user", "content": [{"type": "input_text", "text": "MCP 서버를 OpenAI 에이전트에 연결하는 방법을 조사하고, 최근 업데이트를 확인한 후 추천 설정을 요약하세요."}]}]
)
print(session.id)

동일한 요청은 JavaScript, Go, Java, Ruby 또는 원시 curl로도 표현할 수 있으며, 문서는 언어별 스크립트를 제공합니다.

주목할 만한 커뮤니티 반응 (자체 포함)

추상화의 성숙도 – 사용자들은 OpenAI가 에이전트에 대한 올바른 추상화를 계속해서 개선하고 있다고 지적합니다. 관리형 하네스는 개발자가 자체 오케스트레이션, 메모리, 컨텍스트 관리 계층을 구축하지 않아도 되게 합니다.

"에이전트 as a service는 필요한 도구를 연결할 수 있게 해주지만, 여전히 메모리와 컨텍스트 관리와 같은 하네스의 깊은 부분을 캡슐화하고 지속적으로 개선할 수 있게 해줍니다." – bluesnowmonkey
자체 호스팅의 매력 – 자체 호스팅 사전 환경을 사용할 수 있다는 점은 벤더 종속성에 우려를 느끼는 팀에게 큰 장점으로 여겨집니다.

"그 안에 숨겨져 있지만, 사전 환경을 자체 호스팅할 수 있다는 점을 주목하세요… 이는 훨씬 더 매력적으로 만듭니다." – 6thbit
종속성에 대한 우려 – 몇몇 사용자는 데이터 거주지, ZDR 미지원, 개인 OpenAI 구독을 API와 함께 사용할 수 없다는 점에 대해 우려를 표합니다.

"이 API와 함께 개인 구독을 사용할 수 없기 때문에, 아마도 가장 큰 기업들만 진정으로 사용할 수 있을 것입니다." – krashidov
기존 도구와의 비교 – 일부는 Agents API가 기존 Responses API 또는 LangGraph 같은 SDK와 겹친다고 주장하지만, 다른 이들은 이 API가 OpenAI의 더 지속 가능한 경쟁 우위로 이어질 수 있는 계단이라고 보기도 합니다.

"일반적인 LLM 엔드포인트와 에이전트/하네스 사이의 경계는 의미 없어질 것이라고 생각합니다… 컴퓨터를 주고 끝내면 됩니다." – brap
사용 사례 검증 – 초기 도입자들은 사고 대응 봇, Slack 어시스턴트, 데이터 분석 에이전트, GitHub 이슈 조사기 등을 구축하며 API의 유연성을 입증했습니다.

Agents API vs. DIY 하네스 사용 시기 (자체 포함)

시나리오	Agents API의 장점	DIY / SDK의 장점
빠른 프로토타이핑	사전 환경 생명 주기 관리 필요 없음. OpenAI가 모든 것을 프로비저닝합니다.	환경, 맞춤형 도구, 비용 최적화에 대한 완전한 제어.
기업 준수	관리형 보안, 사전 환경 격리, OpenAI 호스팅 모니터링.	기업 방화벽 뒤에 사전 환경을 호스팅하고 엄격한 데이터 현지화 규칙을 충족할 수 있음.
수천 개의 병렬 에이전트로 확장	OpenAI가 오케스트레이션, 다중 에이전트 동시성, 세션 지속성을 처리합니다.	자체 스케줄러 및 확장 계층을 구축해야 합니다.
세밀한 비용 제어	모델, 도구, 컨테이너별로 명확한 청구.	컨테이너를 즉시 종료하고 유휴 요금을 피할 수 있음.

미해결 질문 및 오픈소스 대안 (자체 포함)

Zero Data Retention – API는 ZDR을 지원하지 않습니다. 엄격한 데이터 삭제가 필요한 개발자는 자체 하네스를 구축해야 합니다.
모델 종속성 – 현재 OpenAI 모델에 종속되어 있습니다. 경쟁사들은 모델에 관계없이 플러그인을 제공하는 유사한 관리형 하네스를 제공할 수 있습니다(예: Flue, Eve, FastAgent).
커뮤니티 SDK – OpenAI Agents SDK는 API를 모방하지만, 로컬 호스팅에 더 큰 유연성을 제공합니다. 많은 사용자가 더 엄격한 제어를 위해 SDK를 선호한다고 보고합니다.
가격 명확성 – 사전 환경 청구 방식(최소 시간, 종료 의미)에 대해 여전히 질문이 남아 있습니다.

결론 (자체 포함)

OpenAI의 Agents API는 사전 환경 프로비저닝, 세션 지속성, 다중 에이전트 오케스트레이션을 추상화한 턴키형 관리형 에이전트 하네스를 제공합니다. 자체 인프라를 구축하지 않고도 빠르게 에이전트 기능을 출시하고 싶은 팀에게 특히 유용하며, 보다 강력한 보안을 원하는 경우 선택적 자체 호스팅 사전 환경을 제공합니다. 커뮤니티 피드백은 편의성에 대한 기대와 벤더 종속성, 데이터 거주지, 가격 투명성에 대한 경계를 동시에 드러냅니다. 개발자는 규모, 준수, 비용 제어 요구 사항에 따라 관리형 서비스와 DIY SDK를 비교해야 합니다.