에이전트 trace 보기

시작하기 전에

에이전트 trace를 보려면 다음 요구사항을 충족해야 합니다.

  • API 사용 설정: 프로젝트에 다음 API가 사용 설정되어 있는지 확인합니다. Google Cloud
    • Cloud Trace API
    • Cloud Logging API
    • Telemetry API
  • 에이전트 추적 구성: trace 데이터를 전송하도록 에이전트를 구성해야 합니다 Google Cloud. 다양한 에이전트 유형의 추적을 사용 설정하는 방법은 추적 설정을 참조하세요.
  • 권한 구성: trace 및 로그를 보려면 **Cloud Trace 사용자**(roles/cloudtrace.user) 및 **로그 뷰어**(roles/logging.viewer) 역할과 같이 필요한 권한을 제공하는 IAM 역할이 필요합니다. 자세한 내용은 Cloud Trace 액세스 제어 및 Cloud Logging 액세스 제어를 참조하세요.

분산 추적은 아키텍처의 다양한 분산 서비스와 구성요소를 이동할 때 단일 요청의 진행 상황을 추적하는 진단 기술입니다. 생성형 AI 에이전트는 비결정적 추론 루프를 사용하여 도구와 실행 경로를 동적으로 선택하므로 기존의 특정 시점 측정항목은 디버깅에 충분하지 않은 경우가 많습니다. trace는 에이전트 관찰 가능성에 필수적입니다. 이러한 예측 불가능한 상호작용의 완전한 순차적 타임라인을 제공하여 에이전트가 특정 결정을 내린 이유를 정확히 파악할 수 있기 때문입니다.

trace 탐색

에이전트의 세부 실행 데이터에 액세스하려면 다음 단계를 따르세요.

  1. 콘솔에서 Agent Platform > 에이전트 레지스트리 페이지로 이동합니다. Google Cloud

    에이전트 레지스트리로 이동

  2. 특정 에이전트를 선택합니다.

  3. Trace 탭을 클릭합니다.

이 인터페이스를 사용하면 에이전트의 단계별 실행 세부정보를 검사할 수 있습니다. trace 는 모델 입력, 응답, 도구 호출을 비롯한 에이전트 동작의 사실적이고 변경 불가능한 기록입니다. trace 뷰에는 스팬의 DAG (방향성 비순환 그래프), 입력 및 출력, 메타데이터 속성이 포함됩니다.

Trace 탭은 Telemetry 데이터를 탐색할 수 있는 세 가지 고유한 뷰를 제공합니다.

  • 세션 뷰: 개별 사용자 세션별로 실행을 그룹화하여 다중 턴 대화와 시간 경과에 따른 에이전트의 동작을 분석할 수 있습니다.
  • trace 뷰: 단일 실행 경로를 나타내는 개별 엔드 투 엔드 요청 trace에 중점을 둡니다.
  • 스팬 뷰: 특정 파운데이션 모델 호출, API 요청, 외부 도구 실행과 같이 trace 내에서 실행되는 개별 작업 (스팬)의 세분화된 목록을 제공합니다.

단일 trace 뷰 (세션 컨텍스트)

세션 뷰에서 특정 세션을 선택하면 왼쪽의 목록 패널에 해당 다중 턴 세션에 포함된 모든 개별 trace가 표시된 세부정보 창이 열립니다. 기본 패널은 전체 세션의 컨텍스트를 집계하여 형식화된 입력 및 어시스턴트 메시지와 함께 기간, 총 생성형 AI 토큰, 지속적 평가 점수와 같은 전반적인 세션 측정항목을 표시합니다.

단일 trace 뷰 (직접 trace 또는 스팬 컨텍스트)

또는 trace 뷰에서 특정 trace를 선택하거나 스팬 뷰에서 고유한 스팬을 선택하면 세부정보 창이 해당 특정 실행으로 바로 열립니다. 그룹화된 세션이 아닌 단일 작업을 보고 있으므로 왼쪽 목록 패널이 숨겨져 해당 작업의 특정 지연 시간, 속성, 잠재적 오류를 즉시 집중적으로 검사할 수 있습니다.

데이터 저장소 및 액세스 제어

보안 및 규정 준수를 유지하기 위해 Gemini Enterprise Agent Platform은 작업 메타데이터를 실제 대화형 콘텐츠와 분리합니다.

  • 실행 측정항목 및 속성: 지연 시간, 상태 코드, 구조적 메타데이터와 같은 표준 Telemetry는 trace 스팬 내에 직접 저장됩니다.
  • 프롬프트 및 응답: 사용자 프롬프트 및 모델 응답과 같은 잠재적으로 민감한 정보는 스팬에 저장되지 않습니다. 대신 조직의 구성에 따라 Cloud Logging 또는 Cloud Storage로 라우팅됩니다. 이를 통해 관리자는 민감한 대화형 데이터에 대한 세분화된 Identity and Access Management (IAM) 제어를 구현할 수 있습니다.

Gemini Enterprise Agent Platform UI는 trace 스팬과 이러한 안전하게 저장된 프롬프트 및 응답 로그 간의 기본 상관관계를 자동으로 이해합니다. trace 세부정보 뷰를 열면 플랫폼이 이 데이터를 원활하게 다시 결합하여 데이터 거버넌스 규칙을 위반하지 않고 에이전트의 동작에 대한 통합 뷰를 제공합니다.

대화형 데이터의 스토리지 대상 구성에 대한 자세한 내용은 멀티모달 프롬프트 및 응답 수집 및 보기를 참고하세요.

다음 단계