AI 챗봇 사용 가이드

토스쇼핑 AI Assistant 사용 가이드

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

---

1. AI Assistant란?

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

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

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

2. 활용 예시

2.1 API 연동 시작하기

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

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를 사용하려면 별도 설치가 필요한가요?

A. 아니요. 토스쇼핑 API 문서 사이트에 접속하면 바로 사용할 수 있습니다.

Q. AI의 답변을 신뢰해도 되나요?

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

Q. 대화 내용이 저장되나요?

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

Q. AI가 답변하지 못하는 질문이 있나요?

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

Q. MCP 연동과 AI Assistant의 차이가 뭔가요?

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

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