사전 요구 사항
-
필요한 의존성을 설치합니다:
-
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 트레이스를 보낼 수 있습니다. 다음 코드 스니펫은 Agno 애플리케이션에서 Weave로 OTEL 트레이스를 보내도록 OTLP span 익스포터와 트레이서 프로바이더를 설정하는 방법을 보여줍니다.OTEL로 Agno 에이전트 트레이스하기
트레이서 프로바이더를 설정한 후에는 자동 트레이싱으로 Agno 에이전트를 생성하고 실행할 수 있습니다. 이후의 모든 에이전트 활동을 Weave가 캡처하도록 하려면 에이전트를 생성하기 전에 Agno를 계측하세요. 다음 예제에서는 도구가 포함된 에이전트를 만드는 방법을 보여줍니다:
OTEL로 Agno 도구 트레이스하기
Agno에서 도구를 정의하고 사용하면 트레이스가 이러한 도구 Call도 캡처합니다. OTEL 인테그레이션은 에이전트의 추론 과정과 개별 도구 실행을 모두 자동으로 계측하여 에이전트 동작을 종합적으로 볼 수 있는 뷰를 제공합니다. 다음은 여러 도구를 사용하는 예시입니다:
OTEL로 멀티 에이전트 팀을 트레이스하세요
Agno의 멀티 에이전트 아키텍처를 사용하면 서로 협업하고 컨텍스트를 공유하는 에이전트 팀을 만들 수 있습니다. Weave는 이러한 팀 상호작용도 모두 트레이스합니다:
추론 에이전트 사용하기
Agno는 에이전트가 문제를 단계별로 처리할 수 있도록 기본 제공 추론 기능을 제공합니다. 트레이스는 이러한 추론 과정도 캡처합니다:
메모리와 지식 활용하기
Agno 에이전트는 메모리를 유지하고 지식 베이스에 액세스할 수 있으며, 이를 통해 상호작용 전반에 걸쳐 컨텍스트를 유지할 수 있습니다. Weave도 이러한 오퍼레이션을 트레이스로 기록합니다: