Skip to main content
Colab에서 열기 이 가이드에서는 Weave를 사용하여 Crews와 플로우를 포함한 CrewAI 멀티 에이전트 애플리케이션을 모니터링하고 트레이싱하는 방법을 설명합니다. CrewAI는 자율형 AI 에이전트를 구축하기 위한 Python 프레임워크입니다. LangChain 등 다른 에이전트 프레임워크에 의존하지 않으며, 상위 수준의 Crews와 하위 수준의 플로우라는 두 가지 추상화를 지원합니다. CrewAI 애플리케이션은 여러 에이전트가 함께 동작하는 경우가 많으므로, 에이전트들이 어떻게 협업하고 소통하는지 파악하는 것이 중요합니다. Weave는 CrewAI 애플리케이션의 트레이스를 자동으로 캡처하므로 에이전트의 성능과 상호작용을 모니터링하고 분석할 수 있습니다. 다음 섹션에서는 Crew 트레이싱, 도구 사용 추적, 플로우 트레이싱, 가드레일 함수를 Weave Op으로 래핑하는 방법을 차례로 살펴봅니다.

Crew 시작하기

이 예제를 실행하려면 CrewAI와 Weave를 설치하세요. CrewAI 설치에 대한 자세한 내용은 CrewAI 설치 가이드를 참조하세요.
다음 예시에서는 CrewAI Crew를 생성하고 Weave로 실행을 트레이스합니다. 트레이싱을 활성화하려면 스크립트 시작 부분에서 weave.init()을 호출하세요. weave.init()에 전달하는 인수는 Weave가 트레이스를 로깅할 프로젝트 이름입니다.
Weave는 CrewAI 라이브러리를 통해 이루어지는 모든 Call(에이전트 상호작용, 태스크 실행, LLM Call 포함)을 추적하고 로깅합니다. 트레이스는 Weave 웹 인터페이스에서 확인할 수 있습니다. crew_trace.png
CrewAI는 킥오프 프로세스를 더 세밀하게 제어할 수 있도록 kickoff(), kickoff_for_each(), kickoff_async(), kickoff_for_each_async() 등 여러 메서드를 제공합니다. 이 인테그레이션은 이 모든 메서드의 트레이스 로깅을 지원합니다.

도구 추적

CrewAI 도구를 사용하면 에이전트가 웹 검색, 데이터 분석, 협업, 동료 간 태스크 위임 등의 기능을 활용할 수 있습니다. 인테그레이션은 이러한 도구도 트레이스합니다. 다음 예시에서는 인터넷을 검색해 가장 관련성 높은 결과를 반환하는 도구에 대한 액세스 권한을 에이전트에게 부여하여, 이전 예시에서 생성한 보고서의 품질을 높입니다. 먼저 추가 의존성을 설치하세요:
이 예제에서는 SerperDevTool을 사용해 ‘Research Analyst’ 에이전트가 인터넷에서 관련 정보를 검색할 수 있게 합니다. 이 도구와 API 요구 사항에 대한 자세한 내용은 SerperDevTool 문서를 참조하세요.
인터넷에 액세스할 수 있는 에이전트로 이 Crew를 실행하면 더 적절한 결과를 얻을 수 있습니다. 다음 이미지와 같이 Weave는 도구 사용을 자동으로 트레이스합니다. crew_with_tool_trace.png
이 인테그레이션은 crewAI-tools 저장소에서 제공하는 모든 도구를 자동으로 패치합니다.

플로우 시작하기

다음 예시에서는 CrewAI 플로우를 정의하고 Weave로 트레이스합니다. Crew와 마찬가지로 플로우를 정의하기 전에 weave.init()을 호출하세요. 그러면 Weave가 Flow.kickoff 진입점과 @start, @listen, @router, @or_, @and_ 데코레이터를 자동으로 캡처합니다.
flow.png
이 인테그레이션은 Flow.kickoff 진입점과 사용 가능한 모든 데코레이터(@start, @listen, @router, @or_, @and_)를 자동으로 패치합니다.

Crew 가드레일: 직접 만든 Op 추적하기

태스크 가드레일을 사용하면 CrewAI가 태스크 출력을 다음 태스크로 전달하기 전에 검증하고 변환할 수 있습니다. Python 함수로 에이전트의 실행 결과를 즉석에서 검증할 수 있습니다. 가드레일 함수를 @weave.op로 래핑하면 함수의 입력, 출력, 앱 로직이 캡처되므로 에이전트를 거치면서 데이터가 어떻게 검증되는지 디버그할 수 있습니다. 또한 실험하는 동안 코드 버전이 자동으로 관리되므로 git에 커밋하지 않은 임시 세부 사항까지 캡처됩니다. 다음 예시에서는 생성된 보고서의 길이를 검증하는 가드레일을 추가하여 리서치 분석가 및 작가 Crew를 확장합니다.
가드레일 함수에 @weave.op 데코레이터를 적용하면 이 함수의 입력과 출력은 물론 실행 시간, 토큰 정보(함수가 LLM을 사용하는 경우), 코드 버전 등을 추적할 수 있습니다. guardrail.png

결론

이제 에이전트 상호 작용, 도구 사용, 플로우 실행, 가드레일 검증을 캡처하는 Weave 트레이스 기반 CrewAI 애플리케이션이 완성되었습니다. 이 인테그레이션에 대한 개선 사항을 제안하거나 문제를 보고하려면 GitHub에서 이슈를 등록하세요. CrewAI로 멀티 에이전트 시스템을 구축하는 방법을 자세히 알아보려면 CrewAI 예시와 문서를 참조하세요.
마지막 수정일 2026년 9월 30일