# AI 챗봇 사용 가이드

## 토스쇼핑 AI Assistant 사용 가이드

토스쇼핑 API 문서에서는 AI Assistant를 사용할 수 있습니다. 별도 설치 없이 문서 사이트에서 바로 자연어로 질문하면, AI가 문서를 검색하여 답변을 제공합니다.

<figure><img src="https://1893239884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5jZ0MNZGU289cgosea36%2Fuploads%2F6ng6RIK5JO91VGPz9vFj%2Fimage.png?alt=media&#x26;token=210b297e-5a3c-46d6-8f9b-78d16c9cfe59" alt=""><figcaption></figcaption></figure>

***

### 1. AI Assistant란?

AI Assistant는 토스쇼핑 API 문서에 내장된 AI 질의응답 기능입니다.

```
상품 등록 API의 필수 파라미터가 뭔가요?
```

질문을 입력하면 AI가 토스쇼핑 API 문서 전체를 검색하여 관련 내용을 요약해서 답변합니다. 답변에는 출처 문서 링크가 포함되어 있어 원본 문서로 바로 이동할 수 있습니다.

<figure><img src="https://1893239884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5jZ0MNZGU289cgosea36%2Fuploads%2FXdlebtHyO64HxJ1ve1o3%2Fimage.png?alt=media&#x26;token=dbba9fa4-771c-41fc-990a-4bd98169aaec" alt=""><figcaption></figcaption></figure>

### 2. 활용 예시

#### 2.1 API 연동 시작하기

```
질문: 토스쇼핑 API 연동을 처음 시작하려면 어떻게 해야 하나요?
```

<figure><img src="https://1893239884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5jZ0MNZGU289cgosea36%2Fuploads%2FzamVYLZWgzyeQLhvepUK%2FFrame%2085.png?alt=media&#x26;token=93151062-aadd-49b2-9a0a-0a0caf8027a3" alt=""><figcaption></figcaption></figure>

AI가 인증 토큰 발급부터 API 호출까지 순서대로 안내합니다.

#### 2.2 특정 API 스펙 확인

```
질문: 주문 조회 API의 요청/응답 형식이 어떻게 되나요?
```

AI가 해당 API의 엔드포인트, 파라미터, 응답 필드를 문서에서 찾아 정리해줍니다.

#### 2.3 현재 페이지 기반 질문

특정 API 문서 페이지를 보고 있는 상태에서 질문하면, AI가 해당 페이지의 맥락을 자동으로 반영합니다.

```
(상품 등록 API 페이지를 보는 중)

질문: 이 API에서 배송비 정책은 어떻게 설정하나요?
```

AI가 현재 보고 있는 상품 등록 API의 배송비 관련 파라미터를 중심으로 답변합니다.

### 3. 효과적인 질문 팁

#### 구체적으로 질문하세요

```
(나쁜 예) API 알려줘
(좋은 예) 상품 등록 API에서 옵션 상품은 어떻게 등록하나요?
```

#### 맥락을 포함하세요

```
(나쁜 예) 에러가 나요
(좋은 예) 상품 등록 API 호출 시 INVALID_REQUEST 에러가 발생합니다. categoryId를 넘기고 있는데 뭐가 잘못된 건가요?
```

#### 후속 질문으로 깊이 파고드세요

```
1차: 클레임 처리 절차가 어떻게 되나요?
2차: 그중 교환 처리 시 배송비는 어떻게 계산되나요?
3차: 도서산간 지역은 추가 배송비가 있나요?
```

***

### 4. FAQ

**Q. AI Assistant를 사용하려면 별도 설치가 필요한가요?**&#x20;

A. 아니요. [토스쇼핑 API 문서 사이트](https://shopping-docs.toss.im)에 접속하면 바로 사용할 수 있습니다.

**Q. AI의 답변을 신뢰해도 되나요?**&#x20;

A. AI는 토스쇼핑 공식 문서만을 기반으로 답변합니다. 답변에 포함된 출처 링크를 통해 원본 문서를 직접 확인할 수 있습니다. 중요한 연동 작업은 원본 문서와 교차 확인하는 것을 권장합니다.

**Q. 대화 내용이 저장되나요?**&#x20;

A. 대화는 현재 세션 동안만 유지됩니다. 브라우저를 닫거나 페이지를 새로고침하면 대화가 초기화됩니다.

**Q. AI가 답변하지 못하는 질문이 있나요?**&#x20;

A. AI는 문서에 있는 내용만 답변할 수 있습니다. 문서에 없는 내용(예: 개별 제휴사 계약 조건, 미공개 기능 등)은 답변할 수 없습니다. 이런 경우 토스쇼핑 담당자에게 직접 문의해주세요.

**Q. MCP 연동과 AI Assistant의 차이가 뭔가요?**&#x20;

A. 두 기능 모두 AI를 통해 토스쇼핑 문서를 검색하지만, 사용 환경이 다릅니다.

|           | AI Assistant       | MCP 연동                      |
| --------- | ------------------ | --------------------------- |
| **사용 환경** | 문서 사이트 (브라우저)      | AI 코딩 도구 (Claude, Cursor 등) |
| **주요 용도** | API 스펙 확인, 프로세스 문의 | 코드 작성 중 API 문서 참조           |
| **설정 필요** | 없음 (바로 사용)         | AI 도구에 MCP 서버 설정 필요         |
| **추천 대상** | 모든 사용자             | 개발자                         |