Runtime Guide
OpenAI Agents SDK를 단순 샘플 코드가 아니라 에이전트 런타임으로 이해하고 싶은 사람을 위한 정리입니다. Agent, Runner, Tools, Handoffs, Guardrails, Sessions, Tracing을 한 구조 안에서 봅니다.
자료 규모
70장 기술 교육 덱
핵심 주제
에이전트 런타임 설계
독자
개발자 · 기획자 · AX 담당자
Overview
왜 지금 Agents SDK를 봐야 하는가
많은 팀이 여전히 에이전트를 프롬프트를 잘 쓰는 문제로 생각합니다. 하지만 실제 제품에서는 도구 호출, 상태 유지, 승인 흐름, 실패 추적, 멀티스텝 제어가 함께 설계돼야 합니다. 이 글은 Agents SDK를 그런 문제를 다루는 런타임 계층으로 설명합니다.
핵심은 “모델을 한 번 잘 부른다”가 아니라, 모델 호출 루프를 누가 소유하고 어떻게 통제하느냐입니다. Agents SDK는 그 루프를 개발자 대신 런타임이 소유하게 만듭니다.
What You Get
이 자료에서 바로 잡히는 것
- Prompt App과 Agent Runtime의 차이
- Responses API 위에 Agents SDK가 올라가는 구조
- Agent, Runner, Tools, Handoffs, Guardrails, Sessions, Tracing의 역할 분담
Runner.run()이 소유하는 실행 루프의 의미- 실무에서 어디서 장애가 나고 무엇을 먼저 설계해야 하는지
Why It Matters
실무적으로 왜 중요한가
실제 프로젝트에서 많이 터지는 문제는 모델 성능보다 루프 설계, 도구 스키마, 상태 관리, 승인 흐름입니다. 이 자료는 그 문제를 API 문서 단위가 아니라 시스템 설계 단위로 설명합니다.
특히 기업 AX, 내부 업무 자동화, 에이전트 제품 설계처럼 “실행을 운영해야 하는” 팀이라면 Agents SDK를 단순 래퍼가 아니라 오케스트레이션 계층으로 보는 관점이 필요합니다.
Attachment
원문 PDF 안내
전체 발표 자료는 하단 첨부 파일에서 바로 내려받을 수 있습니다. Agents SDK를 처음부터 끝까지 한 흐름으로 이해하고 싶은 개발자, 기획자, AX 실무자에게 유용한 자료입니다.