서론: 어떤 도구인가
OpenAI Agents SDK는 코드로 에이전트형 AI 앱을 만드는 도구입니다. 공식 문서는 모델이 추가 컨텍스트와 도구를 사용하고, 다른 에이전트로 핸드오프하며, 스트리밍과 실행 추적을 남기는 앱을 만들 수 있다고 설명합니다. OpenAI는 2026년 4월 15일 발표에서 업데이트된 Agents SDK가 파일 검사, 명령 실행, 코드 편집, 장기 작업을 제어된 샌드박스 환경에서 수행하는 개발 흐름을 지원한다고 안내했습니다.
Meta 광고 전문 폴라애드 관점에서는 광고 성과 CSV, 캠페인 메모, 브랜드 가이드를 입력 파일로 두고 “제공된 파일 근거만 사용해 주간 리포트 초안 작성” 같은 내부 리포팅 흐름에 적용할 수 있습니다.
모델·가격 비교표
아래 수치는 2026년 5월 1일 확인한 OpenAI 공식 모델·가격 페이지의 API 기준 표기입니다. 실제 적용 전에는 가격 페이지와 각 모델 페이지를 다시 확인해야 합니다. 도구 사용료는 모델 토큰 비용과 별도로 과금될 수 있습니다.
| 모델 ID | 입력 가격 | 출력 가격 | 컨텍스트 | 최대 출력 | 활용 기준 |
|---|---|---|---|---|---|
| gpt-5.2 | $1.75 / 1M tokens | $14.00 / 1M tokens | 400K | 128K tokens | 복잡한 분석·에이전트 작업 |
| gpt-5.1 | $1.25 / 1M tokens | $10.00 / 1M tokens | 400K | 128K tokens | 일반 에이전트·리포트 작성 |
| gpt-5-mini | $0.25 / 1M tokens | $2.00 / 1M tokens | 400K | 128K tokens | 정형 요약·초안 생성 |
| gpt-5-nano | $0.05 / 1M tokens | $0.40 / 1M tokens | 400K | 128K tokens | 분류·짧은 요약 |
설치와 설정 방법
공식 Quickstart 기준으로 Python 환경에서 시작할 수 있습니다.
- 프로젝트 폴더를 만듭니다.
python -m venv .venv로 가상환경을 만듭니다.source .venv/bin/activate로 활성화합니다.pip install openai-agents로 Agents SDK를 설치합니다.export OPENAI_API_KEY=sk-...로 API 키를 환경변수에 설정합니다.
OpenAI 발표의 가격·가용성 섹션은 새 Agents SDK 기능이 API 고객에게 일반 제공되며, 토큰과 도구 사용량을 기준으로 하는 표준 API 가격을 사용한다고 설명합니다.
사용법 예시: 리포트 초안 에이전트
공식 Quickstart는 Agent와 Runner를 사용해 에이전트를 실행합니다. 마케팅 리포트용으로는 지시문을 좁게 잡고, 근거 파일명을 남기도록 요구하는 방식이 적합합니다.
import asyncio
from agents import Agent, Runner
agent = Agent(
name="Marketing Report Assistant",
instructions="Use only provided campaign files. Cite source filenames."
)
async def main():
result = await Runner.run(
agent,
"Summarize weekly campaign changes and list follow-up questions."
)
print(result.final_output)
if __name__ == "__main__":
asyncio.run(main())
파일을 읽거나 출력물을 저장해야 하는 업무라면 샌드박스 에이전트를 검토할 수 있습니다. OpenAI 발표는 네이티브 샌드박스 실행이 파일, 도구, 의존성이 필요한 작업 환경을 제공하고, Manifest 추상화를 통해 로컬 파일 마운트와 출력 디렉터리 정의를 지원한다고 설명합니다.
장단점과 운영 체크리스트
장점
- 코드 우선 방식으로 에이전트 앱을 구성할 수 있습니다.
- 도구 실행, 핸드오프, 스트리밍, 실행 추적을 사용할 수 있습니다.
- 샌드박스 실행은 파일 읽기·쓰기, 의존성 설치, 코드 실행이 필요한 작업에 활용할 수 있습니다.
주의할 점
- 파일 기반 리포트라도 숫자와 출처 검수는 사람이 마지막에 확인해야 합니다.
- 새 하네스와 샌드박스 기능은 Python에서 먼저 출시되었고, TypeScript 지원은 향후 릴리스로 계획되어 있습니다.
- 비용은 모델, 토큰, 도구 사용량에 따라 달라집니다.
체크리스트
- 입력 파일 범위와 출력 파일 위치를 정했는가
- 에이전트 지시문에 “제공 파일만 사용” 같은 근거 제한을 넣었는가
- 모델 ID와 예상 토큰 비용을 공식 페이지에서 확인했는가
- 실행 추적에서 도구 호출과 최종 답변을 검토했는가
- 광고주에게 전달하기 전 숫자와 출처 파일명을 대조했는가
결론
Agents SDK는 마케팅 리포트, 내부 조사, 파일 기반 초안 작성처럼 여러 단계를 거치는 업무를 코드로 구성할 때 사용할 수 있습니다. 2026년 기준으로는 모델·가격·SDK 지원 범위를 공식 문서에서 확인한 뒤, 작은 리포트 자동화부터 적용하는 방식이 현실적입니다. Meta 광고 전문 폴라애드는 AI 기반 광고 운영과 리포팅 구조 설계가 필요하신 분들을 위해 홈페이지 상담폼과 전화 상담을 운영합니다.
