에이전트는 도구를 사용해 작업을 계획하고 완료할 수 있습니다. 다른 에이전트와 협업하고 여러 단계에 걸쳐 컨텍스트를 유지할 수도 있습니다. 오케스트레이션을 어디에서 실행할지, 작업 간 상태를 누가 관리할지에 따라 런타임을 선택하세요.
목적에 맞는 가이드 선택하기
| 목적 | 시작 가이드 |
|---|---|
| OpenAI가 관리하는 Codex 하네스로 에이전트 실행 | Agents API |
| 재사용 가능한 에이전트, 도구, 핸드오프를 활용해 애플리케이션에서 에이전트 루프 제어 | Agents SDK |
| 모델 응답을 직접 처리하고 연동 방식 제어 | Responses API |
| 애플리케이션에 채팅 기능 내장 | ChatKit |
에이전트 런타임 비교
| Agents API | Agents SDK | Responses API | |
|---|---|---|---|
| 적합한 용도 | OpenAI가 에이전트를 관리하고 진행 상황을 저장하는 장시간 작업 | 애플리케이션에서 맞춤형 도구와 워크플로우를 갖춘 에이전트 구축 | 모델을 직접 호출하거나 에이전트를 처음부터 구축 |
| 에이전트 실행 위치 | OpenAI가 관리형 Codex 하네스 실행 | 애플리케이션 내에서 SDK 실행 | 애플리케이션에서 실행하며 필요에 따라 호스팅형 오케스트레이션 사용 |
| 에이전트 연동에 필요한 노력 | 적음 | 보통 | 많음 |
| 작업 간 상태 관리 | 세션 설정, 대화 턴, 항목 저장 | 자체 스토리지와 SDK 세션 또는 Responses API의 대화 상태 | 대화 기록 직접 관리, 응답 연결 또는 Conversations 사용 |
| 도구 실행 | 서비스에 연결된 도구, 애플리케이션의 함수 핸들러, 선택적 샌드박스 | 애플리케이션에서 구성한 도구와 연동 기능 | 호스팅형 도구와 애플리케이션이 실행하는 도구 |
| 실행 환경 | OpenAI가 호스팅하는 샌드박스, 자체 호스팅 샌드박스 또는 샌드박스 없이 실행 | 자체 런타임과 샌드박스 제공업체 연동 | 자체 실행 환경 |
| 시작 가이드 | Agents API 개요 | Agents SDK 개요 | Responses API 가이드 |
Agents API는 Codex 하네스를 실행하고 에이전트 인프라를 관리하므로 개발자는 에이전트가 수행할 작업에 집중할 수 있습니다. 자동 컨텍스트 압축, 다중 에이전트 오케스트레이션, 프로그래밍 방식의 도구 호출, MCP 서버를 지원합니다. 아키텍처를 참고하세요.
Agents SDK를 사용하면 애플리케이션에서 배포, 스토리지, 승인, 런타임 연동을 직접 제어할 수 있습니다. SDK의 러너가 에이전트 루프와 핸드오프를 처리합니다. 에이전트 실행을 참고하세요.
도구, 스킬, 프롬프트 캐싱 추가하기
도구 설계, 재사용 가능한 스킬, 프롬프트 캐싱은 다양한 에이전트 워크플로우에 적용됩니다. 구성 방식과 수명 주기는 API마다 다를 수 있습니다.
- 함수 호출, MCP, 호스팅형 기능을 사용하려면 먼저 도구 사용을 참고하세요.
- JavaScript로 오케스트레이션을 구현하는 방법과 API별 설정은 프로그래밍 방식의 도구 호출에서 확인하세요.
- 재사용 가능한 지침을 작성하는 방법과 지원되는 로드 방식은 스킬을 참고하세요.
- 프롬프트 캐싱에서 각 API에 공통으로 적용되는 캐싱 방식을 확인한 다음, Agents API 관측 가능성 및 사용량에서 세션별 사용량 집계 방식을 확인하세요.
Agents API 세션, SDK 세션, Responses API 대화, 샌드박스는 서로 다른 리소스입니다. 선택한 런타임의 지침에 따라 상태를 관리하고 리소스를 정리하세요.