OpenAI 에이전트 API vs 응답 API vs 에이전트 SDK vs 에이전트킷: 어떤 것을 선택하여 구축할까

이 네 가지 이름은 서로 다른 계층에 있으며, 이들을 가르는 한 가지 질문이 있습니다: 누가 에이전트 루프를 실행하는가? Responses API는 모델 호출이며, 귀하의 코드가 그 주변에서 루프를 실행합니다. Agents SDK는 TypeScript 및 Python 라이브러리로, 그 러너가 애플리케이션 내에서 루프를 실행합니다. 2026년 9월 10일부터 공개 베타 중인 Agents API는 OpenAI의 Codex 하네스를 대신 실행하고 세션과 (선택적으로) 샌드박스를 유지합니다. AgentKit은 Agent Builder, ChatKit, Connector Registry, Evals를 묶은 2025년 10월 번들이며, Agent Builder는 2026년 11월 30일에 종료될 예정입니다.

9월 29일 DevDay에서 Agents API에 컴퓨터 사용 기능이 추가되면서 (DevDay 2026 요약 참조), 이름 문제가 더욱 무시하기 어려워졌습니다. 아래에는 루프, 컴퓨팅, 상태, 가격 및 성숙도에 대한 비교, 결정표, 그리고 수동으로 구현한 Responses 루프에서 마이그레이션 경로가 나와 있습니다. 세션 및 승인에 대한 실습 안내는 OpenAI Agents API 가이드를 참조하십시오. 어떤 것을 선택하든, HTTP 인터페이스는 Apidog에서 테스트할 수 있습니다.

OpenAI 에이전트 옵션 비교

출처: OpenAI의 에이전트 런타임 비교, Agents API 개요, 및 사용 중단 페이지.

누가 루프를 실행하는가

이것이 다른 대부분의 행을 결정하는 핵심입니다. Responses API: 귀하가 실행합니다. 웹 검색, 파일 검색, 코드 인터프리터 및 원격 MCP와 같은 호스팅 도구는 단일 요청 내에서 여러 호출을 실행할 수 있지만, 귀하의 자체 함수는 귀하에게 다시 돌아옵니다. 모델이 함수를 호출하면, function_call 항목을 받고, 이를 실행한 다음, 다음 요청에서 동일한 call_id를 가진 function_call_output을 보냅니다. 중단 시점, 기록 저장 방법 (응답은 기본적으로 저장됩니다; store: false로 끄는), 그리고 context_management 및 compact_threshold를 사용하여 긴 컨텍스트를 압축하는 시점을 귀하가 결정합니다. Responses API 가이드와 함수 호출 가이드는 이 루프를 다룹니다. Agents SDK: 귀하의 프로세스가 실행합니다. OpenAI의 문서는 SDK의 러너가 "에이전트 루프와 핸드오프를 처리한다"고 명시하며, 귀하의 서버는 배포, 도구 구현, 상태 저장 및 승인 결정을 소유합니다. 샌드박스 에이전트의 경우, 명령은 Unix-local, Docker 또는 호스팅 제공업체 워크스페이스에서 실행되는 동안 하네스는 귀하의 인프라에 유지될 수 있으므로 인증, 감사 로그 및 사람의 검토는 컨테이너 외부에 유지됩니다. Agents API: OpenAI가 실행합니다. 관리형 하네스는 세션, 오케스트레이션, 컨텍스트 압축 및 복구를 처리하며, 서브 에이전트, 도구 검색 및 프로그래밍 방식 도구 호출을 추가합니다. 원격 MCP 서버는 OpenAI에 의해 직접 호출됩니다. 귀하의 코드는 여전히 함수 도구를 처리합니다: 세션이 required_actions에서 function_call을 보고할 때, 귀하는 turn_id 및 call_id를 포함하는 agent.session.input.tool_result 이벤트를 반환합니다. 동일한 작업을 두 가지 방식으로:

# Responses API: 하나의 모델 호출; 귀하의 코드가 루프를 소유합니다
curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "reasoning": {"effort": "low"},
    "tools": [{"type": "web_search"}],
    "input": "Summarize the breaking changes in the latest Node.js release."
  }'

# Agents API: 영구적인 세션; OpenAI가 루프를 소유합니다
curl https://api.openai.com/v1/agents/sessions \
  -H "OpenAI-Beta: agents=v1" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": {"model": "gpt-6-astra", "tools": [{"type": "web_search"}]},
    "environment": {"type": "none"},
    "input": "Summarize the breaking changes in the latest Node.js release."
  }'

Agents API 문서의 예시들은 gpt-6-astra를 사용합니다; 다른 모델이 허용되는지에 대해서는 언급하지 않으므로, gpt-6.1-sol로 교체하기 전에 확인하십시오.

컴퓨팅, 상태 및 비용

컴퓨팅. Agents API는 전체 세션에 대한 샌드박스를 프로비저닝하고 관리할 수 있습니다: environment.type을 openai_hosted, self_hosted, 또는 none으로 설정합니다. SDK의 경우, 샌드박스 제공업체를 선택하고 비용을 지불합니다. Responses의 경우, 호스팅된 도구를 제외하고 코드는 귀하가 실행하는 곳에서 실행됩니다. 상태. Agents API 세션은 OpenAI 측에 구성, 턴 및 항목을 보유하므로, 후속 조치는 동일한 세션 ID에 대한 하나의 이벤트입니다. Responses의 경우 previous_response_id를 연결하거나 Conversations를 사용합니다. SDK의 경우 상태는 귀하의 저장소 또는 SDK 세션에 있습니다. 비용. 각 옵션이 동일한 모델을 호출하므로 토큰 가격은 어디에서나 동일합니다. Agents API는 "추가 비용 없음"을 청구하지만, 호스팅된 컨테이너는 20분 세션당 $0.03 (1GB)에서 $0.48 (16GB)입니다. SDK의 추가 비용은 귀하의 자체 호스팅 비용입니다. AgentKit 설명에 따르면 AgentKit은 별도 구독이 없습니다. 데이터. Agents API는 미국 데이터 상주만 지원하며 Zero Data Retention을 지원하지 않습니다 (자체 호스팅 샌드박스를 사용하더라도). OpenAI의 데이터 제어 페이지는 /v1/agents를 ZDR-적격이 아니며, 삭제될 때까지 상태가 유지된다고 명시하고 있습니다. 반면 /v1/responses는 제한 사항이 있는 ZDR-적격이며 eu.api.openai.com과 같은 지역 엔드포인트에서 사용할 수 있습니다. ZDR 또는 EU 상주가 요구사항이라면, 현재 Agents API는 사용할 수 없습니다.

2026년 말 AgentKit: 남은 것은 무엇인가

AgentKit은 2025년 10월 6일 네 가지 구성 요소로 출시되었습니다. 각 구성 요소의 현재 상황은 다음과 같습니다:

• Agent Builder: 2026년 6월 3일 사용 중단 발표; 2026년 11월 30일 종료 예정. OpenAI의 마이그레이션 가이드는 워크플로우를 Agents SDK 코드로 내보내거나, Business, Enterprise 또는 Edu에서 ChatGPT Workspace Agent로 재구성합니다.
• Evals: 기존 Evals는 2026년 10월 31일에 읽기 전용이 되며, 대시보드와 API는 11월 30일에 종료될 예정입니다.
• ChatKit: 임베디드 채팅을 위해 계속 사용할 수 있습니다.
• Connector Registry: OpenAI 제품 전반에 걸쳐 커넥터 및 MCP 서버를 위한 관리자 패널.

AgentKit 가이드에 명시된 바와 같이, AgentKit을 통한 영구적이고 코드 우선적인 경로는 Agents SDK입니다.

어떤 것을 기반으로 구축할 것인가

AWS에서는 OpenAI 기반 Bedrock Managed Agents가 Agents API의 핵심 기능을 AWS에서 기본적으로 실행할 수 있도록 합니다. 코드 우선 경로의 MCP 연결에 대해서는 OpenAI 에이전트와 MCP 서버를 참조하십시오.

자체 Responses 루프에서 Agents API로 이동

Responses에 루프를 구축했고 OpenAI가 이를 실행하기를 원한다면:

1. 구성 요소 매핑. 지침, 모델 및 도구를 agent로 이동; 귀하의 컨테이너를 environment로; 귀하의 대화 저장소를 세션 ID로.
2. 원격 MCP 서버를 agent.tools로 이동. 토큰은 프롬프트가 아닌 vault_ids에 연결된 볼트에 보관하십시오.
3. 함수 처리 다시 작성. function_call_output 루프를 agent.session.requires_action (스트림) 또는 agent.session.action_required (웹훅)에 대한 핸들러로 교체하여 agent.session.input.tool_result를 반환하도록 합니다. 서브 에이전트는 함수 도구를 호출할 수 없으므로, 이를 주 에이전트에 유지하십시오.
4. 압축 코드 삭제. 하네스가 컨텍스트를 자동으로 압축합니다.
5. 이벤트로 전환. 턴 결과 (agent.session.turn.completed, agent.session.turn.failed, agent.session.turn.cancelled)를 스트림하거나 웹훅을 사용하십시오. 유휴 세션이 성공을 의미하지는 않습니다.
6. 제약 조건 확인. 미국 상주만, ZDR 없음, 베타 헤더.

두 가지를 하나의 Apidog 프로젝트에 유지

전환하기 전에, 이전 버전과 새 버전을 함께 실행하십시오. 하나의 Apidog 프로젝트에서 Responses 폴더와 Agents API 폴더를 생성하고 {{OPENAI_API_KEY}} 및 모델 변수를 공유하는 환경을 사용하십시오. 동일한 프롬프트를 둘 다에 보내고, 상태 코드 및 필수 출력 필드를 확인하고, Agents API 스트림을 SSE 요청으로 열어 턴 이벤트를 관찰하십시오. 실행을 테스트 시나리오로 저장하고 Apidog CLI로 CI에서 실행하면, 베타 변경 사항이 실패한 검사로 나타날 수 있습니다. 운영 AI 에이전트 신뢰성 가이드는 무엇을 확인해야 하는지 다룹니다. 설정하려면 Apidog를 다운로드하십시오.

자주 묻는 질문

Agents API가 Responses API를 대체하나요? 사용 중단은 발표되지 않았습니다. OpenAI의 에이전트 개요는 Agents API, Agents SDK 및 Responses API를 다양한 요구 사항에 대한 현재 옵션으로 나열합니다. OpenAI AgentKit이 사용 중단되었나요? 부분적으로 그렇습니다. Agent Builder 및 Evals는 2026년 11월 30일에 종료될 예정이며, ChatKit은 계속 사용할 수 있습니다. Agents SDK가 Agents API를 사용하나요? 아닙니다. SDK는 귀하의 애플리케이션에서 실행되며; Agents API는 OpenAI 서비스 내에서 관리형 하네스를 실행합니다. Assistants API는 어떻게 되었나요? OpenAI의 사용 중단 페이지는 2026년 8월 26일 제거를 설정했으며, 개발자들에게 Responses 및 Conversations API를 사용하도록 안내합니다. 어떤 옵션이 가장 저렴한가요? 토큰 가격은 모두 동일합니다. 차이점은 Agents API의 호스팅 컨테이너와 SDK 또는 Responses를 사용한 자체 호스팅 비용입니다.

이번 주에 한 가지 경로를 선택하십시오

누가 루프를 실행해야 하는지에 따라 선택한 다음, 앱을 작성하기 전에 요청으로 증명하십시오. 새로 시작한다면, 하나의 Agents API 세션을 시도하고 Apidog에서 현재 Responses 설정과 출력을 비교해 보십시오.