메인 콘텐츠로 건너뛰기
AutoGen은 AI 에이전트와 애플리케이션을 구축하기 위한 Microsoft의 프레임워크입니다. 대화형 AI용 컴포넌트(AgentChat), 멀티 에이전트 핵심 기능(Core), 외부 서비스 인테그레이션(Extensions)을 제공해 복잡한 멀티 에이전트 시스템을 더 쉽게 만들 수 있도록 지원합니다. 또한 AutoGen은 코드 없이 에이전트 프로토타입을 만들 수 있는 Studio도 제공합니다. 자세한 내용은 AutoGen 공식 문서를 참조하세요.
이 가이드는 AutoGen에 대한 기본적인 이해가 있다고 가정합니다.
Weave는 AutoGen과 통합되어 멀티 에이전트 애플리케이션의 실행을 트레이스하고 시각화할 수 있도록 도와줍니다. Weave를 초기화하면 autogen_agentchat, autogen_core, autogen_ext 내 상호작용을 자동으로 추적합니다. 이 가이드에서는 AutoGen과 함께 Weave를 구성하는 방법을 안내하고, 모델 클라이언트, 도구를 사용하는 에이전트, 그룹 채팅, 메모리, RAG 워크플로, 에이전트 런타임, 순차 워크플로, 코드 실행기를 다루는 예시를 보여줍니다. 이 가이드를 마치면 Weave에서 AutoGen 애플리케이션의 상세한 트레이스를 캡처해 에이전트 동작을 디버그하고, LLM 사용을 모니터링하며, 복잡한 워크플로 전반에서 에이전트가 어떻게 상호작용하는지 이해할 수 있습니다.

사전 요구 사항

시작하기 전에 AutoGen과 Weave가 설치되어 있어야 합니다. 또한 사용하려는 LLM 제공업체용 SDK도 필요합니다(예를 들어 OpenAI 또는 Anthropic).
모델 클라이언트가 다음 예시에서 사용하는 LLM 공급자에 인증할 수 있도록 API 키를 환경 변수로 설정하세요:

기본 설정

트레이스 수집을 시작하려면 스크립트 시작 부분에서 Weave를 초기화하세요. Weave를 초기화하면 스크립트의 나머지 부분에서 이루어지는 AutoGen Call이 자동으로 계측됩니다.
이 스니펫을 실행하면 Weave가 autogen-demo 프로젝트로 트레이스를 전송하도록 설정되고, 이후 스크립트에서 발생하는 모든 AutoGen 활동이 Weave에 의해 자동으로 캡처됩니다.

모델 클라이언트용 트레이스

다음 섹션에서는 단일 Call, 스트리밍 응답, 캐시된 응답을 포함하여 Weave가 AutoGen 내의 모델 클라이언트에 직접 이루어지는 Call을 어떻게 트레이스하는지 설명합니다.

클라이언트 create Call 트레이스

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

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

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

캐시된 클라이언트 call의 트레이스

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

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

이 섹션에서는 Weave가 에이전트와 그 도구 사용을 트레이스하여, 에이전트가 도구를 어떻게 선택하고 실행하는지에 대한 가시성을 제공하는 방식을 보여줍니다. 다음 예시에서는 날씨 도구를 정의하고 이를 AssistantAgent에 연결합니다.
autogen-agent-tools.png

라운드 로빈 GroupChat의 트레이스

RoundRobinGroupChat과 같은 그룹 채팅에서의 상호작용은 Weave가 트레이스하므로, 에이전트 간 대화 흐름을 트레이스할 수 있습니다. 더 쉽게 확인할 수 있도록 모든 에이전트 턴을 하나의 상위 트레이스 아래로 그룹화하려면 그룹 채팅 함수를 @weave.op로 래핑하세요. 이 단계는 선택 사항이지만 권장됩니다.
round_robin_group_chat.png

메모리용 트레이스

AutoGen의 메모리 컴포넌트는 Weave로 트레이스할 수 있습니다. 가독성을 높이기 위해 @weave.op()를 사용하여 메모리 오퍼레이션을 하나의 트레이스로 묶으면, 메모리 add 및 조회 Call이 이를 사용하는 에이전트 run과 함께 표시됩니다.
autogen-memory.png

RAG 워크플로의 트레이스

Weave는 ChromaDBVectorMemory와 같은 메모리 시스템을 사용한 문서 인덱싱 및 검색을 포함한 Retrieval Augmented Generation(RAG) 워크플로를 트레이싱할 수 있습니다. 인덱싱, 검색, 그리고 그에 따른 LLM Call이 하나의 트레이스에 함께 표시되도록 전체 흐름을 시각화하려면 RAG 프로세스를 @weave.op()으로 데코레이팅하세요.
이 RAG 예시를 사용하려면 chromadb가 필요합니다. pip install chromadb로 설치하세요.
autogen-rag.png

에이전트 런타임의 트레이스

Weave는 SingleThreadedAgentRuntime와 같은 AutoGen의 에이전트 런타임 내부의 오퍼레이션을 트레이스할 수 있습니다. 런타임 실행 함수를 @weave.op()으로 감싸면 관련된 트레이스를 그룹화하여 런타임 run 중에 호출되는 메시지 핸들러의 전체 실행 순서를 확인할 수 있습니다.
autogen-runtime.png

순차적 워크플로를 위한 트레이스

에이전트 상호작용의 순서를 정의하는 복잡한 에이전트 워크플로를 트레이스할 수 있습니다. 각 에이전트의 기여가 단일 상위 Call 아래에 중첩되도록 전체 워크플로에 대한 상위 수준의 트레이스를 제공하려면 @weave.op()를 사용하세요. 다음 예시에서는 개념 추출기, 작성기, 형식 지정 및 교정 에이전트, 그리고 사용자 에이전트를 체인으로 연결해 완성도 높은 마케팅 카피를 생성합니다.
autogen-sequential-workflow.png

코드 실행기를 위한 트레이스

Docker 필요 이 예시에는 Docker를 사용한 코드 실행이 포함되어 있어 모든 환경(예: Colab)에서 작동하지 않을 수 있습니다. 이 예시를 사용해 보려면 로컬에서 Docker가 실행 중인지 확인하세요.
Weave는 AutoGen 에이전트의 코드 생성 및 실행 과정을 트레이스합니다. assistant 에이전트가 생성한 코드와 해당 코드가 실행될 때 executor 에이전트가 반환하는 출력을 모두 확인할 수 있습니다.
autogen-codegen.png

더 알아보기

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