사전 요구 사항
-
필요한 의존성을 설치하세요:
-
OpenAI API 키(또는 다른 모델 공급자의 API 키)를 환경 변수로 설정하세요:
- Weave에서 OTEL 트레이싱을 설정하세요.
Weave에서 OTEL 트레이싱 설정
Agno에서 Weave로 트레이스를 전송하려면TracerProvider와 OTLPSpanExporter를 사용해 OTEL을 설정하세요. 익스포터에는 인증 및 프로젝트 식별에 필요한 올바른 엔드포인트와 HTTP 헤더를 지정하세요.
API 키, 프로젝트 정보 같은 민감한 환경 변수는 환경 파일(예:
.env)에 저장하고 os.environ으로 불러오세요. 이렇게 하면 자격 증명을 코드베이스와 분리해 안전하게 보관할 수 있습니다.필수 설정
다음 엔드포인트와 헤더를 사용해 OTLP 익스포터를 설정하세요.- 엔드포인트:
https://trace.wandb.ai/otel/v1/traces - 헤더:
Authorization: W&B API 키를 사용한 Basic 인증입니다.project_id: W&B entity/프로젝트 이름입니다(예:myteam/myproject).
Agno에서 Weave로 OTEL 트레이스 보내기
사전 요구 사항을 완료하면 Agno에서 Weave로 OTEL 트레이스를 보낼 수 있습니다. 다음 코드 스니펫은 OTLP span 익스포터와 트레이서 프로바이더를 설정하여 Agno 애플리케이션에서 Weave로 OTEL 트레이스를 보내는 방법을 보여줍니다.OTEL로 Agno 에이전트 트레이스하기
트레이서 프로바이더를 설정하고 나면 자동 트레이싱이 적용된 Agno 에이전트를 생성하고 실행할 수 있습니다. 이후의 모든 에이전트 활동을 Weave가 캡처하도록 하려면 에이전트를 생성하기 전에 Agno를 계측하세요. 다음 예시는 도구를 사용하는 에이전트를 생성하는 방법을 보여 줍니다.
OTEL로 Agno 도구 트레이스하기
Agno에서 도구를 정의하고 사용하면 이러한 도구 Call도 트레이스에 함께 캡처됩니다. OTEL 인테그레이션은 에이전트의 추론 과정과 개별 도구 실행을 모두 자동으로 계측하므로, 에이전트의 동작을 한눈에 파악할 수 있는 종합적인 뷰를 제공합니다. 다음은 여러 도구를 사용하는 예시입니다.
OTEL로 멀티 에이전트 팀 트레이스하기
Agno의 멀티 에이전트 아키텍처를 사용하면 서로 협업하고 컨텍스트를 공유하는 에이전트 팀을 만들 수 있습니다. Weave는 이러한 팀 상호작용도 전체 과정을 트레이스합니다.
추론 에이전트 사용하기
Agno는 에이전트가 문제를 단계별로 처리하도록 돕는 추론 기능을 기본 제공하며, 트레이스에는 이러한 추론 과정도 캡처됩니다:
메모리 및 지식 활용
Agno 에이전트는 메모리를 유지하고 지식 베이스에 액세스할 수 있으므로 여러 상호작용에 걸쳐 컨텍스트를 유지할 수 있습니다. Weave는 이러한 오퍼레이션도 트레이스합니다.