CoCo Desktop의 데이터 시각화
CoCo Desktop의 데이터 시각화
CoCo Desktop은 데이터를 분석하는 동안 채팅 대화에서 직접 차트와 KPI 카드를 렌더링할 수 있어요. 에이전트가 SQL을 실행하거나 테이블 형식 결과를 반환한 후, 주요 발견 사항을 인라인 시각화로 바꿔 스레드를 떠나거나 다른 도구로 내보내지 않고도 추세를 파악하고, 범주를 비교하고, 요약 메트릭을 읽을 수 있어요.
본문
에이전트는 visualize_data라는 내부 기능을 사용해 각 차트나 메트릭 카드를 제자리에 그려요. 시각화는 에디터 테마(밝음 또는 어두움)를 따릅니다.
주의 인라인 데이터 시각화는 CoCo Desktop에서만 사용할 수 있어요. CoCo CLI나 Snowsight의 CoCo에서는 사용할 수 없어요. 해당 표면에서는 에이전트에게 테이블 형식 요약을 요청하거나 차트에 선호하는 BI 또는 노트북 툴링을 사용하세요.
시각화를 얻는 방법
테이블 형식 결과 후 자동 차트
에이전트가 의미 있는 차트를 지원할 만큼 충분한 행(보통 3개 이상)이 있는 테이블 형식 데이터를 제시하면, 그 답변에서 가장 중요한 통찰을 강조하는 인라인 시각화 1~3개를 적극적으로 추가할 수 있어요. 예: 시간 경과 추세, 상위-N 비교, 소수의 KPI 타일.
자연어로 요청
같은 대화에서 언제든지 특정 차트를 요청할 수 있어요. 예를 들어:
- 월별 매출을 선 차트로 그려줘.
- 상위 10개 리전을 막대 차트로 보여줘.
- 이 결과를 KPI 카드로 요약해줘.
- 각 상태가 주문의 얼마를 차지하지? 원형 차트를 써줘.
Visualize Data 컨트롤
응답에 SQL 결과 테이블이나 마크다운 테이블이 포함되면 채팅 입력 근처에 Visualize Data 컨트롤이 나타나 한 단계로 해당 데이터를 차트로 요청할 수 있어요. 에이전트는 적절한 차트 유형을 선택해 관련 메시지 아래에 인라인으로 렌더링해요.
지원되는 시각화
| 시각화 | 사용 시기 | 참고 |
|---|---|---|
| 선 차트(Line chart) | 시간 경과 또는 정렬된 범주에 대한 추세 | 비교를 위해 여러 시리즈 지원. 누락 값은 공백으로 나타나며 에이전트는 null을 보간하지 않아요. |
| 영역 차트(Area chart) | 시간 경과 볼륨 또는 규모 | 시리즈 비교 시 선택적 누적 영역. |
| 막대 차트(Bar chart) | 범주 비교 | 시리즈 차원이 포함되면 그룹(나란히) 막대. |
| 누적 막대 차트(Stacked bar chart) | 범주별 부분-전체 세분화 | 누적할 시리즈 차원 필요. |
| 산점도(Scatter chart) | 두 숫자 측정값 사이의 관계 | x축에 날짜 사용 가능. x 또는 y 값이 누락된 행은 생략. |
| 원형 차트(Pie chart, 도넛) | 점유율 또는 비율 세분화 | 약 8개 이하의 범주에 가장 적합. |
| 메트릭 카드(Metric card) | 단일 카드의 1~4개 KPI 타일 | 레이블이 있는 큰 값, 선택적 보조 텍스트(예: 기간 대 기간 메모). |
사용 메모
- 채팅에 인라인. 각 시각화는 에이전트 메시지의 일부로 나타나며, 별도의 대시보드나 브라우저 탭이 아니에요.
- 시각화 블록당 하나의 차트. 한 답변의 여러 통찰은 별도의 인라인 차트나 메트릭 카드로 나타나요(에이전트가 적극적으로 시각화할 때 보통 응답당 1~3개).
- 데이터 크기. 기본 결과 집합이 클 때(시각화당 최대 500행) 차트는 집계 또는 샘플링된 데이터로 만들어져요. 매우 큰 테이블은 차트를 만들기 전에 먼저 요약을 요청하세요(예: 매출 상위 10 또는 월별 총계).
- 테마 인식 스타일링. 색상과 표면이 CoCo Desktop의 밝은 또는 어두운 테마와 일치해요.
- 상호작용. 차트 요소 위에 마우스를 올려 툴팁을 표시해요. 해당 작업을 사용할 수 있을 때 시각화 카드에서 차트를 이미지로 복사할 수 있어요.
- 복사 및 내보내기. 에이전트 응답을 복사하면 인라인 차트 외에도 차트 데이터가 마크다운 테이블로 포함되어, 붙여넣은 콘텐츠가 문서나 티켓에서 유용하게 유지돼요.
- 제목 및 레이블. 에이전트가 차트 제목과 축 레이블을 추가할 수 있어요. 첫 결과가 원하는 것이 아니면 이름 바꾸기, 크기 조정, 차트 유형 변경을 요청해요.
- 청구. 시각화는 일반 에이전트 턴의 일부이며 다른 CoCo Desktop 요청처럼 토큰을 소비해요. CoCo 비용과 계정 수준 사용량은
CORTEX_CODE_DESKTOP_USAGE_HISTORY를 참고하세요. - 지원 참조. 도구 기록에
Visualize Data(visualize_data)로 작업이 표시될 수 있어요.
더 나은 결과를 위한 팁
더 나은 결과를 위한 팁
- 차트 유형을 지정하세요: 선 차트, 누적 막대, KPI 카드.
- 차원과 측정값을 지정하세요: 리전별, y축에 총 매출.
- 데이터가 넓거나 길 때 집계를 요청하세요: 주별, 상위 5개 제품만, 지난 12개월.
- 범주가 많은 비율의 경우 상위 N과 기타(Other)를 요청해 원형 또는 막대 차트를 읽을 수 있게 하세요.
제한 사항
- 데스크톱 전용: CLI 또는 Snowsight CoCo에서는 사용할 수 없어요.
- 대화에서 탐색용 차트를 위해 설계되었으며, 완전한 BI 대시보드, 드릴다운 계층, 예약 보고용은 아니에요.
- 차트를 렌더링할 수 없으면(잘못된 데이터 형태, 너무 많은 행, 지원되지 않는 요청) 에이전트가 채팅에서 문제를 설명해요. 요청을 단순화하거나 데이터를 줄이고 다시 시도해요.
예시
SQL 쿼리 후 추세
월별 매출을 반환하는 쿼리를 실행한 뒤 다음을 요청해요.
Plot total revenue by month as a line chart.
예상 결과: x축에 월, y축에 매출이 있는 인라인 선 차트, 차트 위 또는 아래에 짧은 설명이 함께.
범주 비교
Show the top 10 regions by sales as a bar chart, highest first.
예상 결과: 값별로 정렬된 세로 막대 차트, 개별 리전을 비교하기에 적합.
KPI 요약
Turn the totals in this result into KPI cards: revenue, orders, and average order value.
예상 결과: 큰 값과 짧은 레이블을 표시하는 최대 4개의 타일이 있는 메트릭 카드.
부분-전체 세분화
What percentage of orders is each status? Use a pie chart if there are fewer than eight statuses.
예상 결과: 범주 수가 적으면 도넛 스타일 원형 차트, 그렇지 않으면 에이전트가 대신 막대 차트를 제안할 수 있어요.
후속 개선
Change that to a stacked bar chart by product line.
예상 결과: 같은 스레드에서 같거나 세분화된 쿼리 결과를 사용한 새 인라인 누적 막대 차트.