> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/back-office-api/system-bo-api/ai.md).

# AI 사용 집계

## BO 챗봇 사용 적재

> BO 챗봇 질문 1건을 사용 이력으로 적재합니다. 기능 코드는 서버가 BO\_CHATBOT 으로 고정합니다.

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/v1/common/ai/usage/chatbot":{"post":{"tags":["AI 사용 집계"],"summary":"BO 챗봇 사용 적재","description":"BO 챗봇 질문 1건을 사용 이력으로 적재합니다. 기능 코드는 서버가 BO_CHATBOT 으로 고정합니다.","operationId":"recordChatbotUsage","parameters":[{"name":"succYn","in":"query","required":false,"schema":{"type":"string","default":"Y"}}],"responses":{"200":{"description":"OK"}}}}}}
```

## AI 기능별 사용 건수 조회

> KST 기준 fromDt\~toDt(yyyyMMdd) 의 기능별 성공 사용 건수를 반환합니다. 미지정 시 오늘 하루.

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"AiUsageSummaryResponse":{"type":"object","properties":{"featureCd":{"type":"string","description":"AI 허브 기능 코드"},"chnlCd":{"type":"string","description":"채널 구분"},"useCnt":{"type":"integer","format":"int64","description":"성공 사용 건수"}}}}},"paths":{"/v1/common/ai/usage/summary":{"get":{"tags":["AI 사용 집계"],"summary":"AI 기능별 사용 건수 조회","description":"KST 기준 fromDt~toDt(yyyyMMdd) 의 기능별 성공 사용 건수를 반환합니다. 미지정 시 오늘 하루.","operationId":"getUsageSummary","parameters":[{"name":"fromDt","in":"query","required":false,"schema":{"type":"string"}},{"name":"toDt","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AiUsageSummaryResponse"}}}}}}}}}}
```