OpenAI Agents SDK

만든 곳 OpenAI

도구·핸드오프·가드레일을 갖춘 OpenAI의 경량 에이전트 SDK

웹사이트 ↗ 저장소 ↗ 문서 ↗

v0.18.32026-07-17PythonMIT

#agents #tools #handoffs #python

28.1k 완전 무료 오픈소스

문서버전 1.0 · 업데이트 2026년 6월 28일

개요

OpenAI Agents SDK는 에이전트·도구·에이전트 간 핸드오프·가드레일이라는 몇 가지 기본 요소로 에이전트를 만드는 경량 프레임워크입니다.
OpenAI의 Swarm 실험을 잇는 프로덕션 지향 후속작으로, 트레이싱이 내장되어 있고 표면적이 작습니다.

flowchart LR
  input[input] --> r[Runner]
  r --> agent[Agent]
  agent --> tools[tools / handoffs]
  agent --> out[final output]

코드 샘플 탭에서 최소 단일 에이전트 실행을 보여줍니다.

언제 쓰면 좋은가

더 큰 오케스트레이션 프레임워크를 도입하지 않고, OpenAI API에 가까운 얇고 조합 가능한 에이전트 루프를 원할 때 — 특히 도구 사용·멀티 에이전트 핸드오프· 가드레일에 적합합니다.

예제

Python · run an agent

언제 쓰나

무거운 프레임워크 없이 에이전트·도구·핸드오프·가드레일 같은 기본 요소만 원할 때 쓰는 작고 의견 없는 코어.

흐름

지시문(과 선택적 도구)으로 Agent를 정의하면, Runner가 루프를 실행해 최종 출력을 돌려줍니다.

구조

flowchart LR
  input[input] --> r[Runner]
  r --> agent[Agent]
  agent --> tools[tools / handoffs]
  agent --> out[final output]

from agents import Agent, Runner

agent = Agent(name="Assistant", instructions="You are concise and helpful.")
result = Runner.run_sync(agent, "Summarize what an AI agent is in one sentence.")
print(result.final_output)

예제

OpenAI Agents SDK — 구현 샘플

실제로 실행 가능한 미니 프로젝트입니다. 받아서 Docker로 실행해 보세요.

GitHub에서 samples/openai-agents-sdk_1 보기 ↗

2026년 6월 28일

OpenAI Agents SDK — 구현 샘플

아주 작은 OpenAI Agents SDK 샘플입니다. 에이전트를 정의해 프롬프트를 실행합니다.

설정

cd samples/openai-agents-sdk_1
cp .env.sample .env
# .env 편집: OPENAI_API_KEY 설정(필요하면 MODEL도)

Docker로 실행

cd samples/openai-agents-sdk_1
docker build -t aas-openai-agents .
docker run --rm --env-file .env aas-openai-agents "Summarize AI agents in one sentence."

Docker로 실행 (DooD를 쓰는 devcontainer에서)

Docker-outside-of-Docker에서는 포그라운드 docker run이 아무것도 출력하지 않을 수 있습니다 — detached로 실행하고 로그를 따라가세요:

docker logs -f "$(docker run -d --env-file .env aas-openai-agents "Summarize AI agents in one sentence.")"

로컬에서 실행

cd samples/openai-agents-sdk_1
pip install -r requirements.txt
python app.py "Summarize AI agents in one sentence."

실행 결과

모델과 실행마다 결과가 달라집니다 — LLM은 비결정적입니다. gpt-4o-mini로 실행한 한 예입니다:

An AI agent is an autonomous system that perceives its environment, makes decisions based on that information, and acts to achieve specific goals.

파일

.env.sample

# Copy to `.env` and add your OpenAI API key.
#   cp .env.sample .env
OPENAI_API_KEY=

MODEL=gpt-4o-mini

app.py

"""OpenAI Agents SDK: define an agent and run it.

Run:
    docker build -t aas-openai-agents .
    docker run --rm --env-file .env aas-openai-agents "Summarize AI agents in one sentence."
"""

import os
import sys

from dotenv import load_dotenv
from agents import Agent, Runner

load_dotenv()

MODEL = os.environ.get("MODEL", "gpt-4o-mini")


def main() -> None:
    prompt = " ".join(sys.argv[1:]) or "Summarize what an AI agent is in one sentence."
    agent = Agent(name="Assistant", instructions="You are concise and helpful.", model=MODEL)
    print(Runner.run_sync(agent, prompt).final_output)


if __name__ == "__main__":
    main()

Dockerfile

FROM python:3.13-slim

ENV PYTHONUNBUFFERED=1

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY app.py .

ENTRYPOINT ["python", "app.py"]