BBoilerplate

큐레이션

OpenAI Agents SDK

도구 호출·handoff·guardrail·sandbox·tracing을 조합해 멀티에이전트 업무 흐름을 만드는 Python SDK

Python28.4k+
OpenAI Agents SDK 대표 이미지

요약

OpenAI Agents SDK는 여러 에이전트가 도구를 호출하고, 필요한 경우 다른 전문 에이전트로 작업을 넘기며, 실행 결과를 추적하는 Python 프레임워크입니다. OpenAI API뿐 아니라 100개 이상의 다른 LLM도 연결할 수 있습니다.

도구 소개

공식 README 기준으로 Agent, tools, handoffs, guardrails, human-in-the-loop, sessions, tracing을 제공합니다. 파일을 읽고 명령을 실행하며 작업 상태를 유지해야 하는 장기 작업에는 sandbox agent를 사용할 수 있고, 음성·실시간 에이전트 구성도 지원합니다.

사용 포인트

  • 공문·보고서 초안 작성과 검수 역할을 분리하는 멀티에이전트 실습
  • 사내 자료 검색·계산·파일 처리 도구를 에이전트에 연결
  • guardrail과 사람 승인 단계를 넣은 자동화 흐름 설계
  • tracing으로 실패한 handoff와 도구 호출을 찾아 재현

설치와 시작

Python 3.10 이상 환경에서 공식 패키지를 설치합니다.

python -m venv .venv
source .venv/bin/activate
pip install openai-agents

간단한 실행은 OPENAI_API_KEY를 설정한 뒤 Agent와 Runner를 사용합니다. 음성 기능은 openai-agents[voice], Redis 세션은 openai-agents[redis] 선택 그룹으로 설치합니다.

선정 사유

GitHub API에서 28,408 stars와 2026-08-06 최신 push를 확인했고, 공식 README와 OpenAI 공식 문서의 tracing 화면을 직접 확인했습니다. 단순 챗봇을 넘어 역할 분담·승인·관찰 가능성까지 한 흐름에서 교육할 수 있어 업무 자동화 실습 가치가 높습니다.

참고

  • GitHub 저장소
  • 공식 README
  • 공식 문서
  • 이미지 원문
  • Reddit과 국내 사용자·개발자 커뮤니티를 각각 실제 검색했으나 양쪽 모두 HTTP 202 챌린지와 결과 링크 0개로 후보 특정 반응을 검증하지 못했습니다. 익명 반응 요약은 생략했습니다. 정확한 쿼리와 응답은 internal/run-notes/2026-08-06-picks-curation-batch.md에 기록했습니다.