OpenAI Agents SDK 퀵스타트 — 첫 파이썬 에이전트

OpenAI Agents SDK 퀵스타트 — 첫 파이썬 에이전트

SDK 개념을 코드로 옮기면 금방 익숙해져요. 핵심 원리는 에이전트가 도구를 호출하고 스스로 반복한다는 점이에요. 몇 줄만으로 기능하는 에이전트부터 조립해볼게요.

출처: https://openai.github.io/openai-agents-python/quickstart/

from agents import Agent, Runner

agent = Agent(name="Helper", instructions="You are a helpful assistant.")
result = Runner.run_sync(agent, "Write a haiku about recursion in programming.")
print(result.final_output)

구성 요소를 정리하면요.

  • Agent: 시스템 프롬프트(instructions)와 도구, 모델 설정 등을 담는 컨테이너예요.
  • Runner: 에이전트를 실제로 실행해 모델과 대화하고, 도구 호출을 이어서 처리해요. run_sync는 동기 실행, run은 비동기 실행이에요.
  • result.final_output: 에이전트가 마지막으로 낸 출력 문자열이에요.

도구를 붙이려면 파이썬 함수에 @function_tool 데코레이터를 달고 tools=[...]로 넘기면 돼요. 모델을 바꾸고 싶다면 model="gpt-4o-mini"처럼 지정할 수 있어요.

더 알아보기