Repolode
openai

openai/openai-agents-python

도구, 핸드오프, 가드레일, 세션, 트레이싱을 활용해 멀티 에이전트 워크플로를 구축하는 경량 Python 프레임워크로, OpenAI와 100개 이상의 LLM을 제공자에 구애받지 않고 지원합니다.

스타
30,164
포크
5,079
열린 이슈
23
마지막 커밋
10시간 전

어떤 프로젝트인가요?

OpenAI Agents SDK는 에이전트를 구축하기 위한 Python 프레임워크입니다. 에이전트는 지침, 도구, 가드레일, 핸드오프로 구성된 LLM이며, 핸드오프를 통해 다른 에이전트에 작업을 위임합니다. OpenAI Responses API와 Chat Completions API는 물론 100개 이상의 다른 LLM도 지원하므로 특정 제공자에 종속되지 않습니다.

텍스트 에이전트 외에도 SDK에는 장시간 작업을 컨테이너 안에서 수행하는 샌드박스 에이전트, WebSocket을 통한 저지연 음성 및 멀티모달 세션을 지원하는 실시간 에이전트, 음성-텍스트 변환과 에이전트 워크플로, 텍스트-음성 변환을 연결하는 음성 파이프라인이 포함됩니다. 세션은 여러 실행에 걸친 대화 기록을 관리하며, 기본 제공되는 휴먼 인 더 루프 훅을 사용하면 사람이 에이전트 실행에 개입할 수 있습니다.

트레이싱은 에이전트 실행 기록을 남겨 개발자가 워크플로를 확인하고 디버깅하며 최적화할 수 있게 합니다. JavaScript/TypeScript 버전은 별도의 자매 저장소에서 관리됩니다.

핵심 기능

  • 01지침, 도구, 가드레일, 핸드오프로 구성하는 에이전트
  • 02OpenAI Responses API와 Chat Completions API 및 100개 이상의 다른 LLM 지원
  • 03워크스페이스에서 파일을 살펴보고, 명령을 실행하고, 패치를 적용하는 샌드박스 에이전트
  • 04WebSocket 기반 음성 파이프라인을 지원하는 실시간 및 음성 에이전트
  • 05세션 대화 기록 자동 관리 및 기본 제공 트레이싱

활용 사례

  • 전문 에이전트가 위임받은 하위 작업을 처리하는 멀티 에이전트 시스템 구축
  • 음성 인식, 에이전트, 음성 합성을 결합한 음성 어시스턴트 제작
  • 샌드박스에서 파일을 읽고 명령을 실행해야 하는 코딩 또는 리서치 에이전트 실행
  • 기본 제공 트레이싱으로 프로덕션 환경의 에이전트 실행을 디버깅하고 모니터링

빠른 시작

  1. 1

    가상 환경 만들기

    python -m venv .venv
  2. 2

    가상 환경 활성화하기

    source .venv/bin/activate
  3. 3

    openai-agents 패키지 설치하기

    pip install openai-agents
  4. 4

    OPENAI_API_KEY 환경 변수를 설정한 다음 텍스트 에이전트 실행하기

사용 전 알아둘 점

  • Python 3.10 이상이 필요합니다.
  • 예제를 실행하려면 OpenAI API 키(OPENAI_API_KEY)가 필요합니다.

토픽

자주 묻는 질문

openai-agents-python은(는) 무엇인가요?
도구, 핸드오프, 가드레일, 세션, 트레이싱을 활용해 멀티 에이전트 워크플로를 구축하는 경량 Python 프레임워크로, OpenAI와 100개 이상의 LLM을 제공자에 구애받지 않고 지원합니다. OpenAI Agents SDK는 에이전트를 구축하기 위한 Python 프레임워크입니다. 에이전트는 지침, 도구, 가드레일, 핸드오프로 구성된 LLM이며, 핸드오프를 통해 다른 에이전트에 작업을 위임합니다. OpenAI Responses API와 Chat Completions API는 물론 100개 이상의 다른 LLM도 지원하므로 특정 제공자에 종속되지 않습니다.
openai-agents-python은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
openai-agents-python은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
openai-agents-python은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. openai-agents-python의 마지막 커밋은 2026년 10월 20일입니다.
openai-agents-python은(는) 어디에 사용할 수 있나요?
전문 에이전트가 위임받은 하위 작업을 처리하는 멀티 에이전트 시스템 구축 음성 인식, 에이전트, 음성 합성을 결합한 음성 어시스턴트 제작 샌드박스에서 파일을 읽고 명령을 실행해야 하는 코딩 또는 리서치 에이전트 실행 기본 제공 트레이싱으로 프로덕션 환경의 에이전트 실행을 디버깅하고 모니터링
openai-agents-python는 어떻게 설치하나요?
가상 환경 만들기: python -m venv .venv 가상 환경 활성화하기: source .venv/bin/activate openai-agents 패키지 설치하기: pip install openai-agents OPENAI_API_KEY 환경 변수를 설정한 다음 텍스트 에이전트 실행하기
openai-agents-python은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/openai/openai-agents-python

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트