OpenAI Agents SDK 의 추적 시스템은 AI 워크플로에 대한 가시성을 제공하며, 중요한 이벤트를 캡처하여 개발자가 애플리케이션을 효과적으로 모니터링하고 디버깅할 수 있도록 돕습니다.
OpenAI Agents SDK란 무엇인가요?
OpenAI Agents SDK는 AI 에이전트 개발을 간소화하는 Python 툴킷입니다. OpenAI의 SWARM 프로젝트의 프로덕션 준비된 진화 버전으로, 지능적이고 협력적이며 안전한 AI 시스템을 구축하기 위한 기능을 제공합니다. 핵심은 특정 지침과 도구로 구성 가능한 LLM 기반 에이전트로, 사용자 정의 역할을 지원하며 OpenAI 모델(o1, o3-mini, gpt-4o) 및 OpenAI 호환 API를 갖춘 타사 모델과 모두 호환됩니다.
OpenAI Agents SDK의 주요 기능
도구 및 기능 확장:
- 함수 호출(Function Calling) :
@function_tool데코레이터를 사용하여 Python 함수를 도구로 변환하며, 자동 스키마 생성 및 Pydantic 검증을 제공합니다. - 내장 에이전트 루프(Built-in Agent Loop) : 도구 호출, 결과 피드백 및 작업 루프를 처리하여 에이전트와 LLM 간의 원활한 상호 작용을 지원합니다.
- 작업 핸드오프(Task Handoffs) : 에이전트가 작업을 다른 전문 에이전트에 위임할 수 있도록 하여 다중 에이전트 협업을 활성화합니다.
보안 및 모니터링 메커니즘:
- 가드레일(Guardrails) : 입력 검사는 유해 콘텐츠를 방지하고, 출력 검증은 응답 품질과 적절성을 보장합니다.
- 추적 도구(Tracing Tools) : 내장 추적 기능은 전체 에이전트 흐름을 시각화하고 모니터링하여 디버깅 및 최적화를 지원합니다.
개발자 친화적 기능:
- Python 네이티브 메서드 : 에이전트 오케스트레이션 및 체이닝을 위해 Python 언어 기능을 활용하여 새로운 추상화를 배울 필요성을 줄입니다.
- 고도로 사용자 정의 가능 : 사용자 정의 도구, 구조화된 출력 유형 및 외부 LLM 제공업체 통합 기능을 제공합니다.
- 경량 설계 : 최소한의 학습 곡선이 필요한 간단하면서도 강력한 프리미티브 세트입니다.
OpenAI Agents SDK의 이점
개발 효율성
- 설정 과정을 간소화하고 에이전트 애플리케이션 개발을 간소화하며 AI 에이전트 개발 진입 장벽을 낮춥니다.
향상된 시스템 기능:
- 복잡한 작업 실행과 효율적인 다중 에이전트 협업을 지원합니다.
- 전문 협업 시스템을 생성하여 복잡한 문제를 해결합니다.
- 외부 LLM 모델을 통합하여 더 큰 유연성을 제공합니다.
보안 및 신뢰성:
- 가드레일은 안전한 AI 상호 작용을 보장합니다.
- AI 에이전트 시스템의 신뢰성과 적절한 동작을 향상시킵니다.
- AI 에이전트 애플리케이션을 프로덕션 환경에 맞게 준비하는 과정을 간소화합니다.
분석 및 최적화:
- 추적 시스템은 에이전트 동작에 대한 통찰력을 제공합니다.
- 사용자 패턴 분석 및 병목 현상 식별을 개선합니다.
- 디버깅 및 워크플로 최적화 기능을 향상시킵니다.
OpenAI Agents SDK 예제
1단계: 에이전트 설정
AccountingAssistant 라는 가상 비서를 만들고 기능에 대한 명확한 지침을 제공하여 에이전트를 초기화합니다.
2단계: 도구 통합
필수 도구를 통합합니다. 여기에는 다음이 포함됩니다:
- 웹 검색 도구: 세금 업데이트 검색.
- API 호출: 재무제표 분석.
- 파일 검색 도구: 관련 문서 찾기.
3단계: 작업 정의
워크플로를 특정 작업으로 세분화합니다:
- 작업 1: 최신 세금 업데이트 검색.
- 작업 2: API를 사용하여 재무 데이터 분석.
- 작업 3: 최신 데이터를 기반으로 보고서 생성.
4단계: 작업 실행
작업을 순차적으로 또는 병렬로 실행합니다. 예시:
Runner.run_sync(agent, "Generate a report based on the latest tax laws and financial data.")
5단계: 모니터링 및 디버깅
추적 도구를 사용하여 작업 실행을 모니터링하고 디버깅을 위한 잠재적 문제를 식별합니다.
Novita AI를 OpenAI Agents SDK와 통합하는 방법
1. Python 환경을 설정하고 Agents SDK를 설치합니다.
python -m venv env
source env/bin/activate
pip install openai-agents
2. Novita API 키를 설정합니다.
3. 핸드오프 예제
import os
from openai import AsyncOpenAI
from agents import (
Agent,
Runner,
set_default_openai_api,
set_default_openai_client,
set_tracing_disabled,
)
BASE_URL = "https://api.novita.ai/v3/openai"
API_KEY = os.getenv("NOVITA_API_KEY")
MODEL_NAME = os.getenv("MODEL_NAME")
# Novita가 responses API를 지원하지 않으므로 chat completions API를 대신 사용합니다.
set_default_openai_api("chat_completions")
set_default_openai_client(AsyncOpenAI(base_url=BASE_URL, api_key=API_KEY))
# 이 예제에서는 추적을 비활성화합니다.
# 사용자 정의 스팬을 사용하려면 다음을 참조하세요. https://openai.github.io/openai-agents-python/tracing/#external-tracing-processors-list
set_tracing_disabled(disabled=True)
agent = Agent(name="Assistant",
instructions="You are a helpful assistant", model=MODEL_NAME)
result = Runner.run_sync(
agent, "Write a haiku about recursion in programming.")
print(result.final_output)
# Code within the code,
# Functions calling themselves,
# Infinite loop's dance.
유연한 추적 기능을 통해 개발자는 내장 기능과 타사 통합을 통해 에이전트 동작을 추적하여 더 나은 성능과 안정성을 보장할 수 있습니다.
자주 묻는 질문
OpenAI Agents SDK에서 어떤 LLM 모델을 사용할 수 있나요?
OpenAI 모델(o1, o3-mini, gpt-4o) 및 Novita AI와 같은 OpenAI 호환 API를 갖춘 타사 모델과 호환됩니다.
OpenAI Agents SDK는 도구 통합을 어떻게 처리하나요?
@function_tool 데코레이터를 사용하여 Python 함수를 도구로 변환하며, 자동 스키마 생성 및 Pydantic 검증 기능을 제공합니다.
OpenAI Agents SDK는 프로덕션 환경에 적합한가요?
예, 가드레일, 포괄적인 추적 및 모니터링 기능과 같은 보안 기능이 포함되어 있습니다.
Novita AI 는 개발자가 간단한 API를 사용하여 AI 모델을 쉽게 배포할 수 있도록 지원하는 AI 클라우드 플랫폼이며, 구축 및 확장을 위한 경제적이고 안정적인 GPU 클라우드도 제공합니다.
