Maxim 개요
Maxim AI는 귀하의 CrewAI 애플리케이션을 위한 포괄적인 에이전트 모니터링, 평가 및 가시성을 제공합니다. Maxim의 원라인 통합을 통해 에이전트 상호작용, 성능 지표 등을 손쉽게 추적하고 분석할 수 있습니다.특징
프롬프트 관리
Maxim의 프롬프트 관리 기능을 통해 CrewAI 에이전트를 위한 프롬프트를 생성, 조직, 최적화할 수 있습니다. 지침을 하드코딩하는 대신, Maxim의 SDK를 활용하여 버전 관리가 되는 프롬프트를 동적으로 가져오고 적용하세요.플레이그라운드를 통해 프롬프트를 생성, 정제, 실험 및 배포할 수 있습니다. 폴더와 버전을 활용하여 프롬프트를 정리하고, 도구 및 컨텍스트를 연결하여 실제 사례로 실험해 보며, 맞춤형 로직을 기반으로 배포할 수 있습니다.모델 구성을 통해 여러 모델을 손쉽게 실험하고, 프롬프트 플레이그라운드 상단 드롭다운에서 원하는 모델을 선택하세요.

관찰 가능성 & 평가
Maxim AI는 CrewAI 에이전트에 대한 포괄적인 관찰 가능성과 평가 기능을 제공하여, 각 실행 과정에서 무슨 일이 일어나고 있는지 정확히 파악할 수 있도록 지원합니다.에이전트의 전체 라이프사이클(도구 호출, 에이전트 궤적, 결정 플로우 등)을 손쉽게 추적할 수 있습니다.

시작하기
사전 준비 사항
- Python 버전 >=3.10
- Maxim 계정 (여기에서 가입)
- Maxim API 키 생성
- CrewAI 프로젝트
설치
Maxim SDK를 pip을 통해 설치하세요:requirements.txt
에 추가하세요:
기본 설정
1. 환경 변수 설정
2. 필수 패키지 임포트하기
3. API 키로 Maxim 초기화하기
4. 일반적으로 CrewAI 애플리케이션 생성 및 실행하기
트레이스 보기
CrewAI 애플리케이션을 실행한 후:- Maxim 대시보드에 로그인하세요.
- 리포지토리로 이동하세요.
-
다음을 포함한 에이전트 트레이스를 상세하게 확인할 수 있습니다:
- 에이전트 대화 내역
- 도구 사용 패턴
- 성능 지표
- 비용 분석
문제 해결
흔한 문제
- 추적(trace)가 나타나지 않음: API 키와 저장소 ID가 올바른지 확인하세요.
-
crew를 실행하기 전에 반드시
instrument_crewai()
를 호출했는지 확인하세요. 이 함수가 로깅 훅(logging hook)을 올바르게 초기화합니다. -
내부 오류를 드러내기 위해
instrument_crewai()
호출 시debug=True
로 설정하세요: -
에이전트에서 상세 로그를 캡처하기 위해
verbose=True
로 설정하세요: -
instrument_crewai()
가 에이전트를 생성하거나 실행하기 전에 호출되는지 다시 한 번 확인하세요. 너무 당연해 보일 수 있지만, 자주 발생하는 실수입니다.