# 분석

> 에이전트 하나가 받은 대화와 쓴 크레딧을 캔버스에서 봅니다. 출처(앱·API·라이브·채널·루틴·스페이스)와 통로(API 키·채널 연결)별로 나눕니다.

**분석**은 [캔버스](/ko/docs/build/canvas/)의 **사용량** 탭입니다. 캔버스가 이 에이전트에 무엇이 붙어 있는지 그린다면, 사용량 탭은 그 통로로 요청이 얼마나 들어왔고 얼마가 들었는지 그 위에 적습니다.

## 언제 쓰는가

- Live 를 켠 뒤 방문자 대화가 크레딧을 얼마나 쓰는지 볼 때.
- API 로 연동한 서비스 중 어느 키가 많이 부르는지 볼 때.
- 채널·루틴 사용이 늘어난 날을 찾을 때.

모든 에이전트를 한 번에 비교하려면 [사용량 대시보드](/ko/docs/account/usage/)를 쓰세요. 분석은 에이전트 하나를 봅니다.

## 들어가기

<Steps>

1. 에이전트의 **Studio** 를 엽니다.

2. 캔버스 머리의 **사용량** 탭을 누릅니다. 에이전트 카드 아래 **분석** 칸을 눌러도 같은 화면으로 갑니다.

3. 오른쪽 위에서 **기간**을 고릅니다. 7일, 30일, 90일. 기간은 사용량 탭에만 있습니다.

</Steps>

## 캔버스 위의 수치

사용량 탭에서는 왼쪽 열(요청이 들어와요)의 노드에 수치가 붙습니다.

| 노드 | 보이는 값 |
| --- | --- |
| **채널·라이브·API** 제목 줄 | 그 출처의 대화 수와 크레딧 합계 |
| **채널 연결**, **API 키**, **라이브 주소** | 그 통로 하나의 대화·응답 수와 크레딧 |
| **그 밖의 요청** | 앱·루틴·스페이스처럼 설정할 통로가 없는 사용의 합계 |

에이전트로 가는 선은 쓴 양만큼 굵어집니다. 기간 동안 쓰지 않은 통로는 점선으로 흐리게 그려집니다.

API 제목 줄의 합계에는 **계정 전체 키**로 부른 사용도 들어갑니다. 캔버스는 이 에이전트 전용 키만 노드로 그리므로, 노드들의 합이 제목 줄보다 작을 수 있습니다.

## 하단 그래프

캔버스 아래에는 일별 막대 그래프가 붙습니다. 막대는 출처별로 쌓이고, 기간의 날짜가 전부 나옵니다. 쓰지 않은 날은 빈칸입니다.

- 그래프 머리에 기간 합계(대화·응답·토큰·크레딧)가 있습니다.
- **토큰·크레딧·응답** 중 막대에 쓸 값을 고릅니다.
- 아래 출처 칩을 눌러 그 출처를 끄고 켭니다.
- 접어 두면 다음에 열 때도 접혀 있습니다.

대화 수는 막대로 그리지 않습니다. 하루씩 센 대화 수를 더하면 여러 날에 걸친 대화가 여러 번 세어지기 때문입니다. 기간 대화 수는 그래프 머리에서 보세요.

## 통로 짚기

사용량 탭에서 노드를 누르면 오른쪽에 **분석** 패널이 열리고, 하단 그래프가 그 통로만 보여 줍니다.

- **출처**(채널·라이브·API 제목 줄, 그 밖의 요청)를 누르면 그 출처 막대만 진하게 남습니다.
- **API 키**나 **채널 연결**을 누르면 그 통로의 일별 값이 그날 전체 위에 표시됩니다.

분석 패널에는 표가 두 개 있습니다.

- **출처**: 여섯 출처의 대화·응답·토큰·크레딧과 몫. 쓰지 않은 출처도 비교를 위해 줄로 남습니다.
- **통로**: API 키와 채널 연결별 호출·토큰·크레딧. 키 값은 앞자리만 보입니다. 줄 끝의 **›** 를 누르면 그 키나 채널의 설정으로 갑니다.

짚은 통로는 그래프 머리와 패널 머리의 칩으로 표시됩니다. 칩의 **×** 를 누르면 전체로 돌아갑니다.

## 숫자 읽는 법

- **대화**는 기간 안에 이 에이전트가 한 번이라도 답한 대화입니다. 답하지 못한 대화는 세지 않습니다.
- **응답**은 에이전트가 답한 횟수입니다.
- **크레딧**은 정산된 비용입니다. 1 크레딧은 US$1 입니다.
- 같은 기간이면 토큰 합계가 [사용량 대시보드](/ko/docs/account/usage/)의 에이전트 탭과 같습니다.

<Aside type="note" title="'비용 기록 없음' 은 무료라는 뜻이 아닙니다">
  [내 LLM 키](/ko/docs/account/bring-your-own-key/)로 돈 사용은 endue 가 청구하지 않으므로 크레딧이 없습니다.
  그 토큰은 0 크레딧으로 합치지 않고 **비용 기록 없음** 으로 따로 적습니다. 비용은 그 LLM 제공사에서 확인하세요.
</Aside>

<Aside type="note" title="'구분 전' 이 보인다면">
  출처를 기록하기 전의 사용은 대화의 표식으로 채웠습니다. 그래도 알 수 없는 사용은 **구분 전** 으로 모입니다.
  예전 API 사용의 키는 대화를 처음 만든 키로 잡혀 있습니다.
</Aside>

## 누가 볼 수 있나

에이전트 주인만 볼 수 있습니다. 주인이 아니면 사용량 탭과 분석 칸이 보이지 않습니다. 다른 사람이 이 에이전트를 쓴 사용은 그 사람 계정에 잡히므로 여기 나오지 않습니다.

## 한계

- 도구 호출(커넥터·스킬) 사용량은 아직 집계하지 않습니다. 캔버스 오른쪽 열에 수치가 없는 이유입니다.
- 장비(컴퓨터·브라우저) 비용은 포함하지 않습니다.
- 사용량은 실행이 끝난 뒤 기록됩니다. 진행 중인 실행은 끝나야 반영됩니다.

## 관련 문서

<CardGrid>
  <LinkCard title="캔버스" href="/ko/docs/build/canvas/" description="구성 탭 — 무엇이 붙어 있는지." />
  <LinkCard title="사용량 대시보드" href="/ko/docs/account/usage/" description="모든 에이전트를 한 번에." />
  <LinkCard title="에이전트 API" href="/ko/docs/build/agent-api/" description="API 키로 에이전트 부르기." />
  <LinkCard title="요금제와 사용량" href="/ko/docs/account/plans-and-usage/" description="크레딧과 포함량이 도는 방식." />
</CardGrid>