> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.boxhero.io/docs/documentation/ko/other-features/custom-analytics.md).
# 커스텀 리포트
***
***
## 주요 기능
* AI 어시스턴트를 사용해 채팅으로 원하는 데이터를 확인할 수 있습니다.
* 제품, 속성, 가격, 기간, 거래처 등 다양한 조건으로 데이터를 확인할 수 있습니다.
* 자주 쓰는 리포트를 저장해두고 필요할 때 바로 조회할 수 있습니다.
* 조회 결과를 차트로 시각화하거나 엑셀 파일로 내보낼 수 있습니다.
#### 이 기능이 필요한 경우
`재고 분석`은 선택한 기간의 평균 재고량, 재고 회전율 등 **주요 지표를 빠르게 확인할 수 있는 기능**입니다. 다만 사용 가능한 변수와 수식이 정해져 있어, 팀에서 원하는 형태의 리포트를 만들기에는 제한이 있을 수 있습니다.
`커스텀 리포트`는 AI 어시스턴트에게 **채팅으로 원하는 조건과 컬럼을 구체적으로 요청해, 필요한 형태의 데이터를 바로 받아볼 수 있는 기능**입니다. 아래와 같은 경우에 특히 유용합니다.
✔️ 기존의 분석기능으로 원하는 데이터를 확인하기 어려울 때\
✔️ 일부 품목, 거래처, 담당자 등 세부 조건별로 데이터를 분리해서 보고 싶을 때\
✔️ 월별, 분기별, 전년 대비 등 기간 단위로 비교가 필요할 때\
✔️ 보고 자료나 의사 결정에 활용할 데이터가 필요할 때
## **사용 방법**
{% stepper %}
{% step %}
### **AI 어시스턴트 열기**
`분석` > `커스텀 리포트`로 이동한 뒤 `새로 만들기` 버튼을 누르면 AI 어시스턴트 창이 나타납니다.
{% hint style="warning" %}
커스텀 리포트는 **관리자와 멤버 모두 생성, 조회가 가능**하며, [커스텀 권한](/docs/documentation/ko/concepts/members.md#custom-permissions)을 설정하면 접근을 제한할 수 있습니다.
{% endhint %}
{% endstep %}
{% step %}
### 데이터 요청하기
AI 어시스턴트 창에 원하는 데이터를 **채팅으로 요청**해 보세요. 예를 들어 "지난달 카테고리별 재고 현황 보여줘"라고 입력하면 AI가 데이터를 자동으로 만들어 줍니다.
조회 조건과 보고 싶은 컬럼을 구체적으로 입력할수록 원하는 결과에 가깝게 생성할 수 있습니다.
{% embed url="" %}
만약 **검색 조건만 바꿔 같은 조회를 반복**해야 한다면, AI에게 **'입력칸'**을 만들어 달라고 요청해 보세요. 한 번 만들어두면 다음부터는 원하는 값만 입력해 바로 확인할 수 있습니다.
{% endstep %}
{% step %}
### 데이터 활용하기
조회된 결과는 자동으로 '내 리포트' 목록에 저장되어 이후에도 반복해서 조회할 수 있습니다.
{% hint style="warning" %}
데이터는 하루에 한 번 자동으로 동기화됩니다. \
커스텀 리포트에서 최신 데이터로 확인하려면 좌측 하단의 **동기화 버튼**을 누른 후 사용해 주세요.
{% endhint %}
데이터는 표 형식으로 표시됩니다. `엑셀 내보내기` 버튼을 누르면 파일로 내려받을 수 있고, `차트 추가` 버튼을 누르면 그래프로도 확인할 수 있습니다.
{% hint style="danger" %}
데이터는 활용하기 전에 **의도한 내용과 결과가 맞는지 꼭 검토**해 주세요.
특히 발주서나 판매서 상태처럼 값이 여러 단계로 나뉘는 항목은 AI가 판단한 기준이 실제로 원하시는 기준과 다를 수 있습니다. 삭제된 데이터의 반영 여부도 예상과 다르게 처리됐을 수 있으니, 결과를 확인한 뒤 업무에 활용하시기 바랍니다.
{% endhint %}
{% endstep %}
{% endstepper %}
## 사용 예시
커스텀 리포트에는 바로 실행할 수 있는 기본 템플릿이 준비되어 있습니다. 템플릿을 선택해 결과를 확인해 보고, 마음에 들면 `내 리포트에 저장`을 누른 뒤 필요에 맞게 수정해 보세요.
## SQL 편집
SQL을 사용할 수 있다면, [**DuckDB SQL**](https://duckdb.org/docs/stable/sql/introduction) 문법으로 쿼리를 직접 수정해 원하는 형태로 리포트를 만들 수 있습니다. 리포트를 선택한 후 오른쪽 상단 `...` 버튼을 눌러 `SQL 편집`을 선택하세요.
만약쿼리에 `{{변수이름}}`을 넣으면 실행할 때 값을 입력할 수 있는 칸을 만들 수 있습니다. \
예를 들어 아래와 같은 쿼리를 실행하면,
```sql
select sku, name
from items
where name ilike '%' || {{제품명}} || '%';
```
'제품명'이라는 입력칸이 생기고 값을 입력하면 해당 조건으로 조회됩니다.
***
## FAQ
박스히어로 커스텀 리포트에 대해 **자주 묻는 질문**은 아래에서 확인하실 수 있습니다.
{% content-ref url="/spaces/dR2xvRG0Ds13315BlP8a/pages/VMLOsLQIiPGwklNpMstu" %}
[커스텀 리포트](/docs/faq/ko/reporting/custom-analytics.md)
{% endcontent-ref %}
***