Skip to main content
OpenAI Agents SDK는 OpenAI의 API 위에 에이전트와 멀티 에이전트 워크플로를 구축하기 위한 경량 프레임워크입니다. Weave는 OpenAI Agents SDK로 구축된 에이전트를 자동으로 트레이스하며, 각 에이전트 호출, 하위 에이전트 handoff, 모델 Call 및 도구 Call을 포함합니다. Weave는 캡처된 데이터를 프로젝트의 Agents 뷰에 표시합니다.

Weave로 OpenAI Agents SDK 에이전트 트레이스하기

Weave SDK는 OpenAI Agents SDK for Python을 자동 패치하므로 최소한의 설정만으로 에이전트의 트레이스를 캡처할 수 있습니다. 이 가이드에서는 Weave를 초기화한 다음 OpenAI Agents SDK로 구축한 멀티턴 리서치 에이전트를 실행하는 방법을 설명합니다. 이렇게 하면 Weave가 세션 전체에서 발생하는 모든 에이전트 호출, 모델 Call, 도구 Call을 캡처합니다.

사전 요구 사항

시작하기 전에 다음 항목이 준비되어 있는지 확인하세요.
  • CoreWeave Forge 계정 및 WANDB_API_KEY 환경 변수로 설정된 API 키
  • OpenAI API 키
  • Python 3.10 이상

패키지 설치

스크립트에서 Weave와 SDK를 사용할 수 있도록 개발 환경에 다음 패키지를 설치하세요.

코드에서 Weave 초기화

CoreWeave Forge 팀 이름과 프로젝트 이름을 지정하여 프로젝트에 weave.init을 추가한 다음, 평소처럼 에이전트를 구축하세요. 다음 코드는 wikipedia_search 함수 도구와 Research assistant 에이전트를 정의한 다음, OpenAI Agents SDK의 Runner로 세 가지 질문을 실행하며 Weave가 트레이스를 캡처합니다.
이 예시는 하나의 대화에서 세 개의 턴을 실행합니다. 처음 두 턴은 Wikipedia 조회를 트리거하고, 세 번째 턴은 도구 Call 없이 이전 대화 컨텍스트를 사용하여 요약을 생성합니다. Runner.run을 호출할 때마다 이전 결과의 입력 목록을 다음 요청으로 다시 전달하여 대화를 이어갑니다.

Agents 뷰에서 에이전트 트레이스 확인하기

스크립트가 실행되면 weave.init()이 프로젝트 링크를 출력합니다. Agents 뷰를 열어 다음을 확인하세요:
  • 대화의 턴을 포함하는 세션.
  • 중첩된 chat 및 execute_tool 하위 항목이 있는 invoke_agent span으로 표시되는 각 턴.
  • 각 단계의 전체 입력, 모델, 출력, 토큰 사용량 및 도구 결과.
Weave에서 Agents 데이터를 확인하는 방법에 대한 자세한 내용은 에이전트 활동 확인하기를 참조하세요.
마지막 수정일 2026년 9월 30일