# 분석
> 에이전트 하나가 받은 대화와 쓴 크레딧을 캔버스에서 봅니다. 출처(앱·API·라이브·채널·루틴·스페이스)와 통로(API 키·채널 연결)별로 나눕니다. Live 는 방문 수와 방문자가 어디서 왔는지도 봅니다.
**분석**은 [캔버스](/ko/docs/build/canvas/)의 **사용량** 탭입니다. 캔버스가 이 에이전트에 무엇이 붙어 있는지 그린다면, 사용량 탭은 그 통로로 요청이 얼마나 들어왔고 얼마가 들었는지 그 위에 적습니다.
## 언제 쓰는가
- Live 를 켠 뒤 몇 명이 왔고, 그중 몇이 대화를 시작했고, 그 대화가 크레딧을 얼마나 쓰는지 볼 때.
- API 로 연동한 서비스 중 어느 키가 많이 부르는지 볼 때.
- 채널·루틴 사용이 늘어난 날을 찾을 때.
모든 에이전트를 한 번에 비교하려면 [사용량 대시보드](/ko/docs/account/usage/)를 쓰세요. 분석은 에이전트 하나를 봅니다.
## 들어가기
1. 에이전트의 **Studio** 를 엽니다.
2. 캔버스 머리의 **사용량** 탭을 누릅니다. 에이전트 카드 아래 **분석** 칸을 눌러도 같은 화면으로 갑니다.
3. 오른쪽 위에서 **기간**을 고릅니다. 7일, 30일, 90일. 기간은 사용량 탭에만 있습니다.
## 캔버스 위의 수치
사용량 탭에서는 왼쪽 열(요청이 들어와요)의 노드에 수치가 붙습니다.
| 노드 | 보이는 값 |
| --- | --- |
| **채널·라이브·API** 제목 줄 | 그 출처의 대화 수와 크레딧 합계. 라이브 줄은 방문 수가 맨 앞에 붙습니다 |
| **채널 연결**, **API 키** | 그 통로 하나의 대화·응답 수와 크레딧 |
| **라이브 주소** | 그 주소의 방문 수, 대화 시작 수와 크레딧 |
| **그 밖의 요청** | 앱·루틴·스페이스처럼 설정할 통로가 없는 사용의 합계 |
에이전트로 가는 선은 쓴 양만큼 굵어집니다. 기간 동안 쓰지 않은 통로는 점선으로 흐리게 그려집니다.
API 제목 줄의 합계에는 **계정 전체 키**로 부른 사용도 들어갑니다. 캔버스는 이 에이전트 전용 키만 노드로 그리므로, 노드들의 합이 제목 줄보다 작을 수 있습니다.
## 하단 그래프
캔버스 아래에는 일별 막대 그래프가 붙습니다. 막대는 출처별로 쌓이고, 기간의 날짜가 전부 나옵니다. 쓰지 않은 날은 빈칸입니다.
- 그래프 머리에 기간 합계(대화·응답·토큰·크레딧)가 있습니다.
- **토큰·크레딧·응답** 중 막대에 쓸 값을 고릅니다. 라이브를 짚은 동안에는 **방문**도 고를 수 있습니다.
- 아래 출처 칩을 눌러 그 출처를 끄고 켭니다.
- 접어 두면 다음에 열 때도 접혀 있습니다.
대화 수는 막대로 그리지 않습니다. 하루씩 센 대화 수를 더하면 여러 날에 걸친 대화가 여러 번 세어지기 때문입니다. 기간 대화 수는 그래프 머리에서 보세요.
## 통로 짚기
사용량 탭에서 노드를 누르면 오른쪽에 **분석** 패널이 열리고, 하단 그래프가 그 통로만 보여 줍니다.
- **출처**(채널·라이브·API 제목 줄, 그 밖의 요청)를 누르면 그 출처 막대만 진하게 남습니다.
- **API 키**나 **채널 연결**을 누르면 그 통로의 일별 값이 그날 전체 위에 표시됩니다.
분석 패널에는 표가 두 개 있습니다.
- **출처**: 여섯 출처의 대화·응답·토큰·크레딧과 몫. 쓰지 않은 출처도 비교를 위해 줄로 남습니다.
- **통로**: API 키와 채널 연결별 호출·토큰·크레딧. 키 값은 앞자리만 보입니다. 줄 끝의 **›** 를 누르면 그 키나 채널의 설정으로 갑니다. 셋째 탭 **라이브**는 [Live 방문](#live-방문)에서 다룹니다.
짚은 통로는 그래프 머리와 패널 머리의 칩으로 표시됩니다. 칩의 **×** 를 누르면 전체로 돌아갑니다.
## Live 방문
Live 를 켜 두면 사용량 탭이 에이전트의 endue.live 페이지나 사이트에 넣은 채팅 창을 연 사람도 셉니다. 메시지 없이 나간 방문도 세므로, 온 사람 중 몇이 대화까지 갔는지 알 수 있습니다.
**라이브** 제목 줄이나 그 아래 라이브 주소를 누르세요. 방문은 세 곳에 나옵니다.
- **캔버스**: 라이브 제목 줄에 방문·대화·크레딧이, 라이브 주소에 방문과 대화 시작이 붙습니다.
- **분석 패널**: **통로**가 **라이브** 탭으로 열립니다. 기간 합계, 사이트별 표, 유입 경로별 표, 방문자 언어가 있습니다.
- **하단 그래프**: 막대에 쓸 값으로 **방문**이 생깁니다. 막대는 페이지와 임베드로 나뉩니다.
### 무엇을 세는가
| 수치 | 세는 것 |
| --- | --- |
| **방문** | endue.live 페이지나 임베드 채팅 창이 방문자 화면에 한 번 보인 것. 새로고침하면 방문이 하나 늡니다. |
| **고유 방문자** | 같은 날 같은 에이전트에 온 같은 방문자를 1로 센 값. 기간 값은 날마다 센 값을 더한 것입니다. |
| **대화 시작** | 방문자가 메시지를 하나 이상 보낸 방문. |
| **시작률** | 대화 시작을 방문으로 나눈 값. |
| **유효 대화** | 방문자가 메시지를 2개 이상 보낸 방문. |
하루는 UTC 자정에 바뀝니다. 메시지는 에이전트가 받아들였을 때 셉니다. 너무 빨리 보냈거나 계정 크레딧이 떨어져 거절된 메시지는 세지 않습니다.
**대화 시작**과 **대화**는 다른 수치입니다. 대화 시작은 방문을 셉니다. 대화는 에이전트가 한 번이라도 답한 대화를 셉니다. 방문자가 다음 날 다시 와서 같은 대화를 이어 가면 대화 시작은 2, 대화는 1 입니다.
사이트별 표는 endue.live 페이지 한 줄과 채팅 창을 넣은 사이트마다 한 줄입니다. 줄마다 **방문**, **대화**, **메시지**, **크레딧**이 있습니다. 대화·메시지·크레딧을 더하면 **출처** 표의 라이브 줄과 같습니다.
### 방문자가 어디서 왔는가
유입 경로 표는 방문자가 어디서 왔는지에 따라 방문을 묶습니다. 방문 하나는 위에서부터 처음 맞는 줄에 들어갑니다.
| 줄 | 이 줄에 들어가는 방문 |
| --- | --- |
| **사이트 · example.com** | 그 사이트에 넣은 채팅 창을 열었습니다. |
| **캠페인 · newsletter** | 링크에 `utm_source` 가 있었습니다. 그 값이 이름이 됩니다. |
| **직접 방문** | 브라우저가 이전 주소를 보내지 않았습니다. 주소를 직접 쳤거나, 즐겨찾기로 왔거나, 이전 주소를 넘기지 않는 앱에서 열었습니다. |
| **endue.live 탐색**, **endue.ai** | endue.live 나 endue.ai 에서 넘어왔습니다. |
| **검색 · Google** | endue 가 아는 검색 엔진에서 왔습니다. |
| **소셜 · X** | endue 가 아는 소셜 서비스나 메신저에서 왔습니다. |
| **사이트 · blog.example.com** | 그 밖의 사이트에서 왔습니다. 호스트만 보입니다. |
| **알 수 없음** | 메시지는 왔는데 방문 기록이 없습니다. 브라우저가 기록을 막은 경우가 그렇습니다. |
방문이 많은 20줄까지 보이고 나머지는 한 줄로 묶입니다.
내가 돌린 링크를 서로 구분하려면 주소에 `utm_source` 를 붙이세요. `endue.live/@my-agent?utm_source=newsletter` 처럼 씁니다. 값에는 영문, 숫자와 `. _ ~ -` 를 64자까지 쓸 수 있습니다. 모양이 다른 값은 버립니다.
### 수치에서 빼는 방문
두 가지 방문은 기록은 하되 위의 모든 수치에서 뺍니다.
- **주인**: endue 안에서 Live 페이지를 열면(에이전트 Live 설정의 주소, 에이전트 홈의 버튼) 그 브라우저를 주인의 것으로 기억합니다. 그 뒤로 그 브라우저의 방문은 주인으로 셉니다. `localhost` 에서 띄운 임베드도 주인입니다.
- **봇**: 스크립트를 실행하지 않는 크롤러와 링크 미리보기는 처음부터 기록되지 않습니다. 스크립트를 실행하는 자동화 브라우저와 알려진 봇은 봇으로 셉니다.
라이브 탭 맨 아래 줄에 뺀 수가 나옵니다. **제외한 방문: 주인 14 · 봇 37** 같은 모양입니다.
크레딧은 다르게 셉니다. 주인이 시험하며 나눈 대화도 크레딧을 썼으므로 크레딧 수치에 그대로 들어 있습니다.
### 방문 기록에 남기는 것
방문 집계에 관한 내용입니다. 방문자가 대화하면 그 대화는 전과 같이 저장됩니다.
방문마다 남기는 것:
- 어느 에이전트인지, 페이지인지 임베드인지. 임베드면 그 사이트의 호스트.
- 유입 경로의 종류와 이름. 이름은 호스트, 검색 엔진이나 소셜 서비스 이름, `utm_source` 값 중 하나입니다.
- 링크에 있었다면 `utm_medium` 과 `utm_campaign`.
- 브라우저 언어, 국가, 기기 종류(데스크톱·모바일·태블릿).
- 방문 시각과 그 방문에서 보낸 메시지 수.
- 방문자 키. 고유 방문자를 세는 데만 씁니다.
남기지 않는 것:
- 방문자의 IP 주소.
- 쿠키. 방문을 세려고 방문자 브라우저에 쓰는 값은 없습니다.
- 방문자가 있던 페이지의 전체 주소. 경로와 쿼리는 버리고 호스트만 남깁니다.
- 브라우저의 user agent 문자열.
방문자 키는 IP 주소로 계산하고, 날마다 바뀌며, 에이전트마다 다릅니다. 그래서 한 사람의 방문을 다른 날이나 다른 에이전트의 방문과 이을 수 없습니다. 고유 방문자를 하루 단위로 세는 이유입니다.
방문 기록은 400일이 지나면 지웁니다.
## 숫자 읽는 법
- **대화**는 기간 안에 이 에이전트가 한 번이라도 답한 대화입니다. 답하지 못한 대화는 세지 않습니다.
- **응답**은 에이전트가 답한 횟수입니다.
- **크레딧**은 정산된 비용입니다. 1 크레딧은 US$1 입니다.
- 같은 기간이면 토큰 합계가 [사용량 대시보드](/ko/docs/account/usage/)의 에이전트 탭과 같습니다.
## 누가 볼 수 있나
에이전트 주인만 볼 수 있습니다. 주인이 아니면 사용량 탭과 분석 칸이 보이지 않습니다. 다른 사람이 이 에이전트를 쓴 사용은 그 사람 계정에 잡히므로 여기 나오지 않습니다.
## 한계
- 도구 호출(커넥터·스킬) 사용량은 아직 집계하지 않습니다. 캔버스 오른쪽 열에 수치가 없는 이유입니다.
- 장비(컴퓨터·브라우저) 비용은 포함하지 않습니다.
- 사용량은 실행이 끝난 뒤 기록됩니다. 진행 중인 실행은 끝나야 반영됩니다.
- 방문 집계가 생기기 전의 방문은 없습니다. 그때의 대화와 크레딧은 그대로 보입니다.
- 고유 방문자는 네트워크를 기준으로 하루씩 구분합니다. 같은 네트워크를 쓰는 여러 사람은 1명으로 셉니다.
- 임베드의 방문은 채팅 창이 열린 것입니다. 사이트에 채팅 버튼이 보인 횟수는 세지 않으므로 임베드의 시작률이 페이지보다 높게 나옵니다.
- 주인 표식은 브라우저 하나에만 남습니다. 다른 기기나 브라우저에서는 endue 안에서 Live 페이지를 한 번 열기 전까지 방문자로 셉니다.
- 유입 경로별로는 방문과 대화 시작까지만 나뉩니다. 대화·메시지·크레딧은 사이트별로만 나뉩니다.
## 관련 문서