Agents
Agents
에이전트는 도구를 사용해 작업을 계획하고 완료하고, 다른 에이전트와 협력하며, 단계를 거쳐 맥락을 유지할 수 있어요. 시작점 선택과 런타임 비교(Agents API, Agents SDK, Responses API)를 다루는 개요예요.
출처: 문서
본문
에이전트는 도구를 사용해 작업을 계획하고 완료하고, 다른 에이전트와 협력하며, 단계를 거쳐 맥락을 유지할 수 있어요. 오케스트레이션이 어디에서 실행되길 원하는지와 작업 사이의 상태를 누가 관리해야 하는지에 따라 런타임을 선택하세요.
시작점 선택하기
| 여러분이 원하는 것 | 여기서 시작 |
|---|---|
| OpenAI가 관리하는 Codex harness로 에이전트 실행 | Agents API |
| 재사용 가능한 에이전트, 도구, 핸드오프로 애플리케이션의 에이전트 루프 제어 | Agents SDK |
| 모델 응답으로 직접 작업하고 통합 제어 | Responses API |
| 임베드된 채팅 경험 추가 | ChatKit |
에이전트 런타임 옵션 비교
| Agents API | Agents SDK | Responses API | |
|---|---|---|---|
| 용도 | OpenAI가 에이전트를 관리하고 진행 상황을 저장하는 장기 실행 작업 | 커스텀 도구와 워크플로우로 애플리케이션에서 에이전트 구축 | 모델을 직접 호출하거나 처음부터 에이전트 구축 |
| 에이전트가 실행되는 곳 | OpenAI가 관리형 Codex harness를 실행 | SDK가 애플리케이션 안에서 실행 | 애플리케이션(선택적으로 호스팅된 오케스트레이션 포함) |
| 에이전트 통합 노력 | 낮음 | 중간 | 높음 |
| 작업 간 상태 | 저장된 세션 설정, 턴, 아이템 | 여러분의 저장소와 SDK 세션, 또는 Responses 대화 상태 | 수동 히스토리, 응답 체이닝, 또는 Conversations |
| 도구 실행 | 서비스 연결 도구, 애플리케이션 함수 핸들러, 선택적 샌드박스 | 애플리케이션에서 설정한 도구와 통합 | 호스팅 도구와 여러분의 애플리케이션이 실행하는 도구 |
| 실행 환경 | OpenAI 호스팅 샌드박스, 자체 호스팅 샌드박스, 또는 샌드박스 없음 | 여러분의 런타임과 샌드박스 제공자 통합 | 여러분의 자체 실행 환경 |
| 여기서 시작 | Agents API overview | Agents SDK overview | Responses guide |
Agents API는 Codex harness를 실행하고 기반 에이전트 인프라를 관리하므로, 여러분은 에이전트가 무엇을 하는지에 집중할 수 있어요. 자동 컨텍스트 압축(automatic context compaction), 다중 에이전트 오케스트레이션, 프로그래매틱 도구 호출, MCP 서버 지원을 포함해요. Architecture를 참고하세요.
Agents SDK는 애플리케이션에 배포, 저장, 승인, 런타임 통합에 대한 제어권을 줘요. 그 러너(runner)가 에이전트 루프와 핸드오프를 처리해요. Running agents를 참고하세요.
도구, 스킬, 프롬프트 캐싱 추가하기
도구 설계, 재사용 가능한 스킬, 프롬프트 캐싱은 에이전트 워크플로우 전반에 적용돼요. 이들의 설정과 수명 주기는 API마다 다를 수 있어요.
- Function calling, MCP, 호스팅 기능에 대해서는 Using tools로 시작하세요.
- JavaScript로 오케스트레이션하고 각 API에 대한 설정을 보려면 Programmatic Tool Calling을 읽으세요.
- 재사용 가능한 지침과 지원되는 로딩 메커니즘은 Skills를 사용하세요.
- 공유 캐싱 동작은 Prompt caching을, 세션 회계는 Agents API observability and usage를 읽으세요.
Agents API 세션, SDK 세션, Responses conversation, 샌드박스는 서로 다른 리소스예요. 선택한 런타임에 대한 상태 및 정리 지침을 따르세요.
더 알아보기 (Learn more)
관련 문서: Agents SDK 개요와 Agents API 아키텍처를 참고하세요.