# 상품 AI 통신

## XGEN AI 상품 상세 설명 생성

> \## 기능 설명\
> 상품 기본 정보를 기반으로 XGEN AI를 이용해 상품 상세 설명을 생성합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 단건의 상품에 대해 상품번호로 상품정보를 조회합니다.\<br>\<br>\
> \* 생성 옵션은 공통코드(PR050)를 대상으로 합니다.\<br>\<br>\
> \* 생성시 추가 설명을 제공할 수 있습니다.\<br>\<br><br>

```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":{"AiGoodsDescRequest":{"type":"object","description":"AI 상품 상세 설명 생성 요청 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호","minLength":1},"option":{"type":"string","description":"AI상품설명옵션(PR050)","minLength":1},"additionalInfo":{"type":"string","description":"추가정보"}},"required":["goodsNo","option"]},"AiGoodsDescResponse":{"type":"object","description":"AI 상품 상세 설명 생성 응답 DTO","properties":{"result":{"type":"string","description":"생성 결과"},"content":{"type":"string","description":"AI가 생성한 내용 (텍스트 또는 JSON 문자열)"},"citations":{"type":"array","description":"참조 문서 목록","items":{"$ref":"#/components/schemas/XgenCitation"}}}},"XgenCitation":{"type":"object","description":"XGEN 참조 문서 정보","properties":{"file_name":{"type":"string","description":"참조 파일명"},"page_number":{"type":"integer","format":"int32","description":"참조 페이지 번호"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/ai/getAiGoodsDesc":{"post":{"tags":["상품 AI 통신"],"summary":"XGEN AI 상품 상세 설명 생성","description":"## 기능 설명\n상품 기본 정보를 기반으로 XGEN AI를 이용해 상품 상세 설명을 생성합니다.\n<br><br>\n---\n## 상세 내용\n* 단건의 상품에 대해 상품번호로 상품정보를 조회합니다.<br><br>\n* 생성 옵션은 공통코드(PR050)를 대상으로 합니다.<br><br>\n* 생성시 추가 설명을 제공할 수 있습니다.<br><br>\n","operationId":"getAiGoodsDesc","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiGoodsDescRequest"}}},"required":true},"responses":{"200":{"description":"XGEN AI 상품 상세 설명 생성 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AiGoodsDescResponse"}}}},"900":{"description":"XGEN AI 상품 상세 설명 생성 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## XGEN AI상품 목록 조회

> \## 기능설명\
> \* XGEN AI가 추천하는 상품 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 검색 조건에 따라 상품 목록을 조회합니다.\
> \* 상품번호를 입력한 경우 상품 등록기간 조건을 무시하고 전체기간 조회합니다.\
> \---<br>

```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":{"AiGoodsListPopupApiRequest":{"type":"object","properties":{"goodsDtmIgnoreOption":{"type":"boolean","description":"조회기간 무시 옵션"},"goodsDtmOption":{"type":"string","description":"조회기간 옵션"},"goodsRegStartDtm":{"type":"string","format":"date-time","description":"상품등록 시작일자"},"goodsRegEndDtm":{"type":"string","format":"date-time","description":"상품등록 종료일자"},"mdId":{"type":"string","description":"담당 MD 아이디"},"entrNo":{"type":"string","description":"협력사번호"},"brandNo":{"type":"string","description":"브랜드번호"},"stdCtgNo":{"type":"string","description":"표준분류카테고리번호"},"saleStatCd":{"type":"string","description":"판매상태코드"},"saleStatCdList":{"type":"array","description":"판매상태코드 리스트","items":{"type":"string"}},"goodsCompCd":{"type":"string","description":"상품구성코드"},"goodsTypCd":{"type":"string","description":"상품유형코드"},"saleMethCd":{"type":"string","description":"판매방식코드"},"buyTypCd":{"type":"string","description":"매입형태코드"},"deliProcTypCd":{"type":"string","description":"배송처리유형모드"},"goodsNm":{"type":"string","description":"상품명"},"goodsNo":{"type":"string","description":"상품번호"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송여부"},"frgnDirPurGoodsYn":{"type":"string","description":"직구상품여부"},"mkdpNm":{"type":"string","description":"기획전 명"},"brefDesc":{"type":"string","description":"기획전 간략설명"},"introConts":{"type":"string","description":"기획전 소개글"},"divobjNm":{"type":"string","description":"구분자 명"},"searchCodeOption":{"type":"string","description":"상품번호 옵션 ( st : 시작, in : 포함, eq : 같음, mt : 멀티, rg : 범위)"},"searchCodeFrom":{"type":"string","description":"상품번호 시작 조건"},"searchCodeTo":{"type":"string","description":"상품번호 마지막 조건"},"searchCode":{"type":"string","description":"상품번호"},"searchCodeText":{"type":"string","description":"상품번호 검색어"},"searchCodeTextList":{"type":"array","description":"상품번호 검색어(멀티)","items":{"type":"string"}}}},"ResponseRealGridListResponseAiGoodsListPopupApiResponse":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/RealGridListResponseAiGoodsListPopupApiResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseAiGoodsListPopupApiResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/AiGoodsListPopupApiResponse"}}}},"AiGoodsListPopupApiResponse":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"goodsCompCd":{"type":"string","description":"상품구성코드"},"goodsTypCd":{"type":"string","description":"상품유형코드"},"goodsReason":{"type":"string","description":"추천사유"},"entrNm":{"type":"string","description":"협력사명"},"entrNo":{"type":"string","description":"협력사번호"},"brandNm":{"type":"string","description":"브랜드명"},"saleMethCd":{"type":"string","description":"판매방식코드"},"saleStatCd":{"type":"string","description":"판매상태코드"},"saleStatCdNm":{"type":"string","description":"판매상태코드명"},"buyTypCd":{"type":"string","description":"매입형태코드"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분"},"deliWayCd":{"type":"string","description":"배송수단코드"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"mdNm":{"type":"string","description":"담당MD명"},"dispYn":{"type":"string","description":"전시여부"},"deliProcTypCdNm":{"type":"string","description":"배송처리유형명"},"deliGoodsGbCdNm":{"type":"string","description":"배송상품구분코드명"},"salePrc":{"type":"number","description":"판매가"},"dispDlexAmt":{"type":"string","description":"배송비"},"stdCtgHierarchy":{"type":"string","description":"표준 카테고리"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/ai/getAiGoodsList":{"get":{"tags":["상품 AI 통신"],"summary":"XGEN AI상품 목록 조회","description":"## 기능설명\n* XGEN AI가 추천하는 상품 목록을 조회합니다.\n---\n## 상세설명\n* 검색 조건에 따라 상품 목록을 조회합니다.\n* 상품번호를 입력한 경우 상품 등록기간 조건을 무시하고 전체기간 조회합니다.\n---\n","operationId":"getAiGoodsList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/AiGoodsListPopupApiRequest"}}],"responses":{"200":{"description":"AI 상품 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseAiGoodsListPopupApiResponse"}}}},"900":{"description":"AI 상품 목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## AI상품 목록 조회

> \## 기능설명\
> \* AI가 추천하는 상품 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 검색 조건에 따라 상품 목록을 조회합니다.\
> \* 상품번호를 입력한 경우 상품 등록기간 조건을 무시하고 전체기간 조회합니다.\
> \---<br>

```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":{"AiGoodsListPopupApiRequest":{"type":"object","properties":{"goodsDtmIgnoreOption":{"type":"boolean","description":"조회기간 무시 옵션"},"goodsDtmOption":{"type":"string","description":"조회기간 옵션"},"goodsRegStartDtm":{"type":"string","format":"date-time","description":"상품등록 시작일자"},"goodsRegEndDtm":{"type":"string","format":"date-time","description":"상품등록 종료일자"},"mdId":{"type":"string","description":"담당 MD 아이디"},"entrNo":{"type":"string","description":"협력사번호"},"brandNo":{"type":"string","description":"브랜드번호"},"stdCtgNo":{"type":"string","description":"표준분류카테고리번호"},"saleStatCd":{"type":"string","description":"판매상태코드"},"saleStatCdList":{"type":"array","description":"판매상태코드 리스트","items":{"type":"string"}},"goodsCompCd":{"type":"string","description":"상품구성코드"},"goodsTypCd":{"type":"string","description":"상품유형코드"},"saleMethCd":{"type":"string","description":"판매방식코드"},"buyTypCd":{"type":"string","description":"매입형태코드"},"deliProcTypCd":{"type":"string","description":"배송처리유형모드"},"goodsNm":{"type":"string","description":"상품명"},"goodsNo":{"type":"string","description":"상품번호"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송여부"},"frgnDirPurGoodsYn":{"type":"string","description":"직구상품여부"},"mkdpNm":{"type":"string","description":"기획전 명"},"brefDesc":{"type":"string","description":"기획전 간략설명"},"introConts":{"type":"string","description":"기획전 소개글"},"divobjNm":{"type":"string","description":"구분자 명"},"searchCodeOption":{"type":"string","description":"상품번호 옵션 ( st : 시작, in : 포함, eq : 같음, mt : 멀티, rg : 범위)"},"searchCodeFrom":{"type":"string","description":"상품번호 시작 조건"},"searchCodeTo":{"type":"string","description":"상품번호 마지막 조건"},"searchCode":{"type":"string","description":"상품번호"},"searchCodeText":{"type":"string","description":"상품번호 검색어"},"searchCodeTextList":{"type":"array","description":"상품번호 검색어(멀티)","items":{"type":"string"}}}},"ResponseRealGridListResponseAiGoodsListPopupApiResponse":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/RealGridListResponseAiGoodsListPopupApiResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseAiGoodsListPopupApiResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/AiGoodsListPopupApiResponse"}}}},"AiGoodsListPopupApiResponse":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"goodsCompCd":{"type":"string","description":"상품구성코드"},"goodsTypCd":{"type":"string","description":"상품유형코드"},"goodsReason":{"type":"string","description":"추천사유"},"entrNm":{"type":"string","description":"협력사명"},"entrNo":{"type":"string","description":"협력사번호"},"brandNm":{"type":"string","description":"브랜드명"},"saleMethCd":{"type":"string","description":"판매방식코드"},"saleStatCd":{"type":"string","description":"판매상태코드"},"saleStatCdNm":{"type":"string","description":"판매상태코드명"},"buyTypCd":{"type":"string","description":"매입형태코드"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분"},"deliWayCd":{"type":"string","description":"배송수단코드"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"mdNm":{"type":"string","description":"담당MD명"},"dispYn":{"type":"string","description":"전시여부"},"deliProcTypCdNm":{"type":"string","description":"배송처리유형명"},"deliGoodsGbCdNm":{"type":"string","description":"배송상품구분코드명"},"salePrc":{"type":"number","description":"판매가"},"dispDlexAmt":{"type":"string","description":"배송비"},"stdCtgHierarchy":{"type":"string","description":"표준 카테고리"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/goods/ai/getAiGoodsList":{"get":{"tags":["상품 AI 통신"],"summary":"AI상품 목록 조회","description":"## 기능설명\n* AI가 추천하는 상품 목록을 조회합니다.\n---\n## 상세설명\n* 검색 조건에 따라 상품 목록을 조회합니다.\n* 상품번호를 입력한 경우 상품 등록기간 조건을 무시하고 전체기간 조회합니다.\n---\n","operationId":"getAiGoodsList_1","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/AiGoodsListPopupApiRequest"}}],"responses":{"200":{"description":"AI 상품 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseAiGoodsListPopupApiResponse"}}}},"900":{"description":"AI 상품 목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}},"deprecated":true}}}}
```

## AI 상품 상세 설명 생성

> \## 기능 설명\
> 상품 기본 정보를 기반으로 AI를 이용해 상품 상세 설명을 생성합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 단건의 상품에 대해 상품번호로 상품정보를 조회합니다.\<br>\<br>\
> \* 생성 옵션은 공통코드(PR050)를 대상으로 합니다.\<br>\<br>\
> \* 생성시 추가 설명을 제공할 수 있습니다.\<br>\<br><br>

```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":{"AiGoodsDescRequest":{"type":"object","description":"AI 상품 상세 설명 생성 요청 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호","minLength":1},"option":{"type":"string","description":"AI상품설명옵션(PR050)","minLength":1},"additionalInfo":{"type":"string","description":"추가정보"}},"required":["goodsNo","option"]},"AiGoodsDescResponse":{"type":"object","description":"AI 상품 상세 설명 생성 응답 DTO","properties":{"result":{"type":"string","description":"생성 결과"},"content":{"type":"string","description":"AI가 생성한 내용 (텍스트 또는 JSON 문자열)"},"citations":{"type":"array","description":"참조 문서 목록","items":{"$ref":"#/components/schemas/XgenCitation"}}}},"XgenCitation":{"type":"object","description":"XGEN 참조 문서 정보","properties":{"file_name":{"type":"string","description":"참조 파일명"},"page_number":{"type":"integer","format":"int32","description":"참조 페이지 번호"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/goods/ai/getAiGoodsDesc":{"get":{"tags":["상품 AI 통신"],"summary":"AI 상품 상세 설명 생성","description":"## 기능 설명\n상품 기본 정보를 기반으로 AI를 이용해 상품 상세 설명을 생성합니다.\n<br><br>\n---\n## 상세 내용\n* 단건의 상품에 대해 상품번호로 상품정보를 조회합니다.<br><br>\n* 생성 옵션은 공통코드(PR050)를 대상으로 합니다.<br><br>\n* 생성시 추가 설명을 제공할 수 있습니다.<br><br>\n","operationId":"getAiGoodsDesc_1","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/AiGoodsDescRequest"}}],"responses":{"200":{"description":"AI 상품 상세 설명 생성 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AiGoodsDescResponse"}}}},"900":{"description":"AI 상품 상세 설명 생성 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}},"deprecated":true}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tech.x2bee.com/api/back-office-api/goods-bo-api/ai.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.