메인 콘텐츠로 건너뛰기
AutoGen은 AI 에이전트와 애플리케이션을 구축하기 위한 Microsoft의 프레임워크입니다. 대화형 AI용 컴포넌트(AgentChat), 멀티 에이전트 핵심 기능(Core), 외부 서비스 인테그레이션(Extensions)을 제공해 복잡한 멀티 에이전트 시스템을 더 쉽게 만들 수 있도록 지원합니다. 또한 AutoGen은 코드 없이 에이전트 프로토타입을 만들 수 있는 Studio도 제공합니다. 자세한 내용은 AutoGen 공식 문서를 참조하세요.
이 가이드는 AutoGen에 대한 기본적인 이해가 있다고 가정합니다.
Weave는 AutoGen과 통합되어 멀티 에이전트 애플리케이션의 실행을 트레이스하고 시각화할 수 있도록 도와줍니다. Weave를 초기화하기만 하면 autogen_agentchat, autogen_core, autogen_ext 내 상호작용을 자동으로 추적할 수 있습니다. 이 가이드에서는 AutoGen과 함께 Weave를 사용하는 다양한 예제를 살펴봅니다.

사전 요구 사항

시작하기 전에 AutoGen과 Weave가 설치되어 있는지 확인하세요. 또한 사용하려는 LLM 제공업체용 SDK도 필요합니다(예: OpenAI, Anthropic).
API 키를 환경 변수로 설정하세요:

기본 설정

트레이스 수집을 시작하려면 스크립트 시작 부분에서 Weave를 초기화하세요.

단순한 모델 클라이언트 트레이스하기

Weave는 AutoGen 내의 모델 클라이언트에 직접 이루어지는 call을 트레이스할 수 있습니다.

클라이언트 create Call 트레이싱

이 예제에서는 OpenAIChatCompletionClient의 단일 Call을 트레이싱하는 방법을 보여줍니다.
autogen-simple-client.png

스트리밍을 사용하는 클라이언트 create call 트레이싱

Weave는 스트리밍 응답 트레이스도 지원합니다.
autogen-streaming-client.png

Weave는 캐시된 call을 기록합니다

AutoGen의 ChatCompletionCache를 사용할 수 있으며, Weave는 이러한 상호작용을 트레이스해 응답이 캐시에서 온 것인지 새 call에서 온 것인지 보여줍니다.
autogen-cached-client.png

도구 call을 사용하는 에이전트 트레이싱

Weave는 에이전트와 그 도구 사용을 트레이스하여, 에이전트가 도구를 어떻게 선택하고 실행하는지 가시성을 제공합니다.
autogen-agent-tools.png

GroupChat 트레이스 - 라운드 로빈

RoundRobinGroupChat과 같은 그룹 채팅에서의 상호작용은 Weave가 트레이스하므로, 에이전트 간 대화 흐름을 트레이스할 수 있습니다.
round_robin_group_chat.png

메모리 트레이스

AutoGen의 메모리 컴포넌트는 Weave로 트레이스할 수 있습니다. 가독성을 높이기 위해 @weave.op()를 사용해 메모리 오퍼레이션을 하나의 트레이스로 묶을 수 있습니다.
autogen-memory.png

RAG 워크플로 트레이스

ChromaDBVectorMemory와 같은 메모리 시스템을 사용한 문서 인덱싱 및 검색을 포함해, Retrieval Augmented Generation(RAG) 워크플로는 트레이스할 수 있습니다. RAG 프로세스에 @weave.op() 데코레이터를 적용하면 전체 흐름을 시각화하는 데 도움이 됩니다.
RAG 예제에는 chromadb가 필요합니다. pip install chromadb로 설치하세요.
autogen-rag.png

에이전트 런타임 트레이스

Weave는 SingleThreadedAgentRuntime와 같은 AutoGen의 에이전트 런타임 내부 오퍼레이션을 트레이스할 수 있습니다. 런타임 실행 함수를 @weave.op()로 감싸면 관련 트레이스를 함께 묶을 수 있습니다.
autogen-runtime.png

워크플로 트레이싱 (순차적)

에이전트 상호작용의 순서를 정의하는 복잡한 에이전트 워크플로를 트레이스할 수 있습니다. 전체 워크플로에 대한 상위 수준의 트레이스를 제공하려면 @weave.op()를 사용하세요.
autogen-sequential-workflow.png

코드 실행기 트레이스

Docker 필요 이 예제는 Docker를 사용해 코드를 실행하므로 모든 환경에서 작동하지 않을 수 있습니다(예: Colab에서는 직접 실행되지 않을 수 있음). 사용해 보려면 로컬에서 Docker가 실행 중인지 확인하세요.
Weave는 AutoGen 에이전트의 코드 생성과 실행을 트레이스합니다.
autogen-codegen.png

더 알아보기

이 가이드는 Weave를 AutoGen과 통합하기 위한 출발점입니다. Weave UI에서 에이전트 상호작용, 모델 call, 도구 사용의 자세한 트레이스를 확인해 보세요.