이 페이지에서는 콘솔에서 수신된 최종 사용자 의견을 보는 방법을 설명합니다. Google Cloud
시작하기 전에
콘솔에서 의견 항목을 보려면 다음을 확인하세요. Google Cloud
- Agent Runtime 인스턴스에 추적이 사용 설정되어 있습니다.
- 에이전트가 OpenTelemetry (OTel)를 사용하여 trace 스팬을 생성하고 trace 컨텍스트 전파를 처리하도록 구성되어 있습니다. 콘솔 UI는 OpenTelemetry에서 생성된 스팬 속성
gcp.vertex.agent.event_id를 사용하여 의견 항목을 trace에 매핑합니다.
의견 보기
의견 서비스는 콘솔의 Trace 탭과 통합됩니다. Google Cloud Trace 탭에서 세션 뷰 탭과 Trace 뷰 탭 모두에서 의견이 첨부된 trace를 보고 필터링할 수 있습니다.
에이전트의 의견 항목을 보려면 다음 단계를 따르세요.
- 콘솔에서 Agent Platform > 에이전트 페이지로 이동합니다. Google Cloud
- 왼쪽 탐색 메뉴에서 배포 를 선택합니다.
에이전트를 선택합니다.
선택한 프로젝트에 속한 Agent Engine 인스턴스가 목록에 표시됩니다. 필터 필드를 사용하여 지정된 열을 기준으로 목록을 필터링할 수 있습니다.
Agent Engine 인스턴스의 이름을 클릭합니다.
Trace 탭을 클릭합니다. 세션 뷰 또는 Trace 뷰 를 사용하여 의견이 있는 trace를 찾습니다.
- 세션 뷰:
- 의견 열을 기준으로 세션 목록을 필터링합니다.
- 보려는 세션을 클릭하여 trace 목록을 표시합니다.
- 의견 아이콘 배지를 표시하는 trace ID를 선택합니다.
- Trace 뷰:
- Trace 뷰 탭을 클릭합니다.
- 의견 열을 기준으로 trace 목록을 필터링합니다.
- 의견 아이콘 배지를 표시하는 trace ID를 선택합니다.
- 세션 뷰:
trace 세부정보 창에서 의견 탭을 클릭하여 의견 유형, 댓글, 라벨, ID, 생성 시간과 같은 의견 세부정보를 확인합니다.
UI 제한사항
- 이벤트 ID 요구사항: UI는 trace 스팬에서 가져온 OpenTelemetry에서 생성된 UUID
(
gcp.vertex.agent.event_id) 를 사용하는 의견 항목의 추적 및 매핑만 지원합니다. - 중복 제출: 동일한
session_id및event_id조합으로 여러 의견 항목이 제출되면 콘솔 UI는 마지막으로 수신된 의견 항목만 표시합니다.
Cloud Trace 통합
사용자가 의견을 제출하면 의견 서비스는 원격 분석 스팬을 Cloud Trace로 내보냅니다. 추론 엔진 실행 이벤트와 함께 사용자 의견을 찾으려면 이러한 내보낸 스팬을 속성별로 검색하고 필터링합니다. 이러한 trace를 찾고 보는 방법에 관한 자세한 내용은 추적 설정 가이드를 참고하세요.
trace는 변경할 수 없으므로 의견 항목을 삭제하거나 업데이트해도 이전에 내보낸 trace에는 영향을 미치지 않습니다.
각 의견 원격 분석 trace에는 다음과 같은 리소스 및 스팬 속성이 있는 gcp.vertex.agent.feedback이라는 스팬이 포함되어 있습니다.
| 속성 | 속성 유형 | 설명 |
|---|---|---|
gcp.project_id |
리소스 | 콘솔 프로젝트의 프로젝트 ID입니다. Google Cloud |
cloud.resource.id |
리소스 | 추론 엔진 인스턴스의 ID입니다. |
gcp.vertex.agent.feedback.type |
스팬 |
의견 유형 (THUMBS_UP, THUMBS_DOWN,
또는 FEEDBACK_TYPE_UNSPECIFIED).
|
gen_ai.conversation_id |
스팬 | 상호작용과 연결된 세션 ID입니다. |
gcp.vertex.agent.event_id |
스팬 | 특정 대화 턴과 연결된 이벤트 ID입니다. |
gcp.vertex.agent.feedback.entry.name |
스팬 | 생성된 의견 항목의 리소스 경로입니다. |
gcp.vertex.agent.feedback.labels |
스팬 | 선택사항입니다. 의견 라벨 목록입니다. |