에이전트를 만들기 위한 새 도구들 — Responses API와 Agents SDK

OpenAI 가 개발자와 기업이 AI 에이전트를 더 쉽고 안정적으로 만들 수 있도록 새 API 와 SDK 를 냈다. AI 시스템이 사용자 대신 독립적으로 작업하게 하는 ‘에이전트’ 개발을 지원하며, 더 강력한 추론과 멀티모달 인터페이스, 안전성 기술을 결합했다.

여기서 짚어 둘 것은 그동안 각자 직접 조립하던 것들이 어디까지 표준 부품이 됐는가 다. 웹 검색을 붙이고, 문서를 검색하게 하고, 여러 에이전트가 서로 일을 넘기게 만드는 일 — 이것들이 이번에 API 안으로 들어왔다.

새로 나온 것은 둘이다.

Responses API — Chat Completions API 의 간단함과 Assistants API 의 도구 활용 기능을 결합했다. 웹 검색, 파일 검색, 컴퓨터 사용 기능을 제공한다
Agents SDK — 단일 에이전트와 다중 에이전트 워크플로를 오케스트레이션한다

이로써 에이전트의 핵심 로직, 오케스트레이션, 인터랙션이 단순해지고 구현이 빨라진다.

Responses API

OpenAI 의 기본 도구들을 써서 에이전트를 만들 수 있는 새 API 다. Chat Completions API 의 간결함과 Assistants API 의 도구 활용을 합쳐, 다단계 작업을 더 유연하게 처리한다.

웹 검색, 파일 검색, 컴퓨터 사용 같은 새 내장 도구 지원
일관된 인터페이스 설계로 다중 모델 호출과 도구 사용을 쉽게 통합
스트리밍 이벤트 지원, 간편한 텍스트 출력(access output text) 제공
OpenAI 내 데이터 저장 가능, 성능 평가와 추적 기능 강화
기본적으로 사용자 비즈니스 데이터를 학습에 쓰지 않음

새 프로젝트에는 Responses API 를 먼저 쓰는 것이 권장되며, 기존 Chat Completions API 및 Assistants API 와도 무리 없이 연동된다.

내장 도구 세 가지

웹 검색(Web Search) — GPT-4o 및 GPT-4o-mini 에서 제공되며 실시간 정보를 검색한다. 쇼핑 추천 시스템, 실시간 연구 보조, 여행 예약 에이전트 같은 데 쓴다. ChatGPT 검색과 같은 모델을 쓰며 신뢰할 수 있는 정보와 출처를 함께 준다.

파일 검색(File Search) — 대량의 문서에서 관련 정보를 빠르게 찾는다. 고객 지원 챗봇이 FAQ 에서 답을 찾거나, 법률 보조 AI 가 판례를 참조하거나, 코드 문서를 검색해 개발을 돕는 식이다. 몇 줄의 코드로 구현할 수 있고 벡터 저장소(Vector Store)를 활용한다.

컴퓨터 사용(Computer Use) — 에이전트가 마우스와 키보드를 움직여 브라우저 기반 작업을 한다. 품질 보증 테스트 자동화, 데이터 입력 자동화, 온라인 지도에서 기업 정보를 모으는 연구 도구 같은 데 쓴다. 초기 연구 미리보기로 제공되며 안전을 위한 여러 보호 장치가 있다.

기존 API 는 어떻게 되나

Chat Completions API 는 계속 지원되지만 Responses API 에서만 제공되는 기능들이 생길 것이다. Assistants API 는 Responses API 로 기능이 통합되며 2026년에 서비스가 종료된다.

Agents SDK

다중 에이전트 기반 애플리케이션을 더 쉽게 만들 수 있는 오픈소스 SDK 다.

에이전트 구성 — LLM 을 쉽게 설정하고 필요한 도구를 연결한다
핸드오프(Handoff) — 에이전트 사이의 역할 전환이 가능하다
보안 가이드라인(Guardrails) — 입력과 출력을 검증해 안전성을 확보한다
트레이싱 및 관찰(Tracing & Observability) — 실행 과정을 시각화하고 디버깅한다

고객 지원 자동화, 다단계 연구 프로세스, 코드 검토 및 분석, 영업 및 고객 관계 관리 같은 데 쓸 수 있다. Responses API 및 Chat Completions API 와 함께 쓸 수 있고 앞으로 다른 모델과도 연동될 예정이다.

남는 이야기

OpenAI 는 에이전트 기술이 업무 생산성을 크게 끌어올릴 것으로 보고 있고, 앞으로도 에이전트 개발을 지원하는 플랫폼을 강화할 계획이다. 새 모델, API 통합, 도구 개선을 계속 이어 간다고 한다.

Responses API

내장 도구 세 가지

기존 API 는 어떻게 되나

Agents SDK

남는 이야기

링크