> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/ko/other-features/custom-analytics.md).

# 커스텀 리포트

> 박스히어로의 데이터를 원하는 조건으로 자유롭게 조회할 수 있는 기능입니다. 기존 분석 기능으로는 확인하기 어려웠던 데이터를 직접 조건을 설정해 불러오고, 팀 상황에 맞게 분석할 수 있습니다.

![](https://assets.boxhero.io/docs/images/1c3cfb6611b638c40900b49afc9cbce77e5a7229fd2fb225e726718401602115-1600x940.png)

---

## 주요 기능

- AI 어시스턴트를 사용해 채팅으로 원하는 데이터를 확인할 수 있습니다.
- 제품, 속성, 가격, 기간, 거래처 등 다양한 조건으로 데이터를 확인할 수 있습니다.
- 자주 쓰는 리포트를 저장해두고 필요할 때 바로 조회할 수 있습니다.
- 조회 결과를 차트로 시각화하거나 엑셀 파일로 내보낼 수 있습니다.

#### 이 기능이 필요한 경우

`재고 분석`은 선택한 기간의 평균 재고량, 재고 회전율 등 **주요 지표를 빠르게 확인할 수 있는 기능**입니다. 다만 사용 가능한 변수와 수식이 정해져 있어, 팀에서 원하는 형태의 리포트를 만들기에는 제한이 있을 수 있습니다.

`커스텀 리포트`는 AI 어시스턴트에게 **채팅으로 원하는 조건과 컬럼을 구체적으로 요청해, 필요한 형태의 데이터를 바로 받아볼 수 있는 기능**입니다. 아래와 같은 경우에 특히 유용합니다.

✔️ 기존의 분석기능으로 원하는 데이터를 확인하기 어려울 때\
✔️ 일부 품목, 거래처, 담당자 등 세부 조건별로 데이터를 분리해서 보고 싶을 때\
✔️ 월별, 분기별, 전년 대비 등 기간 단위로 비교가 필요할 때\
✔️ 보고 자료나 의사 결정에 활용할 데이터가 필요할 때

## 사용 방법

1. ### AI 어시스턴트 열기

   `분석` > `커스텀 리포트`로 이동한 뒤 `새로 만들기` 버튼을 누르면 AI 어시스턴트 창이 나타납니다.

   ![AI 어시스턴트 창 켜는 방법](https://assets.boxhero.io/docs/images/cf6447159389e94f5130b5da9579ed871e47faba9640956c37bbe1b7366ba651-2247x1335.jpg)

   > **Caution**
   >
   > 커스텀 리포트는 **관리자와 멤버 모두 생성, 조회가 가능**하며, [커스텀 권한](https://www.boxhero.io/docs/ko/faq/reporting/custom-analytics#restrict-custom-report-access)을 설정하면 접근을 제한할 수 있습니다.

2. ### 데이터 요청하기

   AI 어시스턴트 창에 원하는 데이터를 **채팅으로 요청**해 보세요. 예를 들어 "지난달 카테고리별 재고 현황 보여줘"라고 입력하면 AI가 데이터를 자동으로 만들어 줍니다.

   조회 조건과 보고 싶은 컬럼을 구체적으로 입력할수록 원하는 결과에 가깝게 생성할 수 있습니다.

   [Video](https://customer-0jrbilsa8yt3k758.cloudflarestream.com/5ccd6da99795e686bd8605bcb5c16c5f/iframe?poster=https%3A%2F%2Fcustomer-0jrbilsa8yt3k758.cloudflarestream.com%2F5ccd6da99795e686bd8605bcb5c16c5f%2Fthumbnails%2Fthumbnail.jpg%3Fheight%3D1080&letterboxColor=transparent)

   만약 **검색 조건만 바꿔 같은 조회를 반복**해야 한다면, AI에게 **'입력칸'**을 만들어 달라고 요청해 보세요. 한 번 만들어두면 다음부터는 원하는 값만 입력해 바로 확인할 수 있습니다.

   ![변수 입력칸을 추가한 모습](https://assets.boxhero.io/docs/images/fbacf9a23a7593b8e775bcde67e93a424fcc086dafa3f7e22628ec9ae6174cf2-2287x1280.jpg)

   > **Tip**
   >
   > 원하는 결과가 나오지 않았다면 상단의 `...` 버튼 > `버전 기록`을 눌러 이전 버전으로 되돌릴 수 있습니다.

3. ### 데이터 활용하기

   조회된 결과는 자동으로 '내 리포트' 목록에 저장되어 이후에도 반복해서 조회할 수 있습니다.

   ![내 리포트에 저장된 화면](https://assets.boxhero.io/docs/images/43cb7546f9af582971c204a87936b00d1bf401869d5d6a026b37e80bab699c88-2301x1313.jpg)

   > **Caution**
   >
   > 데이터는 하루에 한 번 자동으로 동기화됩니다. \
   > 커스텀 리포트에서 최신 데이터로 확인하려면 좌측 하단의 **동기화 버튼**을 누른 후 사용해 주세요.

   데이터는 표 형식으로 표시됩니다. `엑셀 내보내기` 버튼을 누르면 파일로 내려받을 수 있고, `차트 추가` 버튼을 누르면 그래프로도 확인할 수 있습니다.

   ![차트 추가하는 모습](https://assets.boxhero.io/docs/images/86506f7603d37714ebfe87d0fbaa6decfd156ee8172deef26b1f33d79e3c8499-2287x1280.jpg)

   > **Danger**
   >
   > 데이터는 활용하기 전에 **의도한 내용과 결과가 맞는지 꼭 검토**해 주세요.
   >
   > 특히 발주서나 판매서 상태처럼 값이 여러 단계로 나뉘는 항목은 AI가 판단한 기준이 실제로 원하시는 기준과 다를 수 있습니다. 삭제된 데이터의 반영 여부도 예상과 다르게 처리됐을 수 있으니, 결과를 확인한 뒤 업무에 활용하시기 바랍니다.

## 사용 예시

커스텀 리포트에는 바로 실행할 수 있는 기본 템플릿이 준비되어 있습니다. 템플릿을 선택해 결과를 확인해 보고, 마음에 들면 `내 리포트에 저장`을 누른 뒤 필요에 맞게 수정해 보세요.

![템플릿 사용하는 방법](https://assets.boxhero.io/docs/images/dc5809244a5667eaaff8f9c122643436d7ea4739106ecaa6f5d86bdfd1f8ffa9-2301x1242.jpg)

## SQL 편집

SQL을 사용할 수 있다면, [**DuckDB SQL**](https://duckdb.org/docs/stable/sql/introduction) 문법으로 쿼리를 직접 수정해 원하는 형태로 리포트를 만들 수 있습니다. 리포트를 선택한 후 오른쪽 상단 `...` 버튼을 눌러 `SQL 편집`을 선택하세요.

![SQL 편집](https://assets.boxhero.io/docs/images/795772680ded15dc2ba4cd57544970c8e6d94bb49a9004739254310d529a2a83-2301x1242.jpg)

만약 쿼리에 `{{변수이름}}`을 넣으면 실행할 때 값을 입력할 수 있는 칸을 만들 수 있습니다. \
예를 들어 아래와 같은 쿼리를 실행하면,

```sql
select sku, name 
from items 
where name ilike '%' || {{제품명}} || '%';
```

'제품명'이라는 입력칸이 생기고 값을 입력하면 해당 조건으로 조회됩니다.

---

## FAQ

박스히어로 커스텀 리포트에 대해 **자주 묻는 질문**은 아래에서 확인하실 수 있습니다.

- [커스텀 리포트](https://www.boxhero.io/docs/ko/faq/reporting/custom-analytics)

---