웹사이트 연결
페이지, 제품, 주문을 플랫폼에서 직접 읽어옵니다
개요
웹사이트 연결은 AI에 플랫폼에 대한 읽기 전용 키를 제공합니다. 페이지를 외부에서 크롤링하는 대신 플랫폼에 직접 요청합니다.
이렇게 하면 크롤러가 닿지 못하는 콘텐츠까지 가져옵니다. 로그인 뒤의 페이지, 아무 곳에서도 연결되지 않은 깊은 페이지, 봇 차단 뒤의 사이트가 모두 들어옵니다. 가격과 재고는 다시 읽어오므로 크롤링한 날의 내용에 의존하지 않고 항상 최신입니다.
세 가지 데이터 종류
무엇을 공유할지는 고객님이 정합니다. 각 선택은 어시스턴트가 답할 수 있는 내용과 연결됩니다.
| 선택 | 무엇을 가져오는지 | 어시스턴트가 답할 수 있는 것 |
|---|---|---|
| 페이지 | 사이트 콘텐츠가 자동으로 동기화됩니다. | 정책, 서비스, 강좌, 안내서, 그 밖의 모든 문서 페이지에 대한 질문. |
| 제품 | 현재 가격, 재고, 링크, 이미지. | 무엇을 판매하는지, 가격, 재고 여부, 구매 링크. |
| 주문 | 고객을 위한 주문 상태 조회. | 고객의 주문이 어디에 있는지, 언제 발송되었는지, 무엇이 들어 있었는지. |
어떤 플랫폼이 되나요
모두 됩니다. 사이트가 무엇으로 만들어졌든 어시스턴트는 페이지, 제품, 주문을 바탕으로 답할 수 있습니다.
일부 플랫폼은 API 키로 바로 읽을 수 있습니다. 나머지는 크롤링, 제품 피드, 사용자 컨텍스트 또는 직접 만든 도구로 같은 데이터를 가져옵니다. 어느 쪽인지 직접 알아낼 필요는 없습니다. 창을 열고 플랫폼을 고른 뒤 공유할 항목을 선택하면 해당 경우의 단계가 표시됩니다.
연결 방법
- 대시보드를 열고 지식 베이스에 추가 옆의 웹사이트 연결을 찾으세요.
- 목록에서 플랫폼을 고르세요. 사이트를 직접 만드셨다면 커스텀 / CMS 없음을 선택하세요.
- 공유할 항목을 선택하세요. 페이지, 제품, 주문 또는 이들의 조합입니다.
- 계속을 누르세요. 플랫폼과 선택에 맞춰 작성된 설정 단계가 표시됩니다.
- 플랫폼 관리자 화면에서 단계를 따라 키를 만드세요.
- 같은 창 아래쪽 입력란에 키를 붙여 넣고 연결을 누르세요.
연결을 누르면 일어나는 일
자격 증명은 저장하기 전에 확인합니다. 잘못된 키는 절대 저장되지 않습니다.
- 붙여 넣은 자격 증명으로 플랫폼에 실제 요청을 한 번 보냅니다.
- 실패하면 버튼 아래에 오류가 표시되고 입력란은 계속 수정할 수 있어 바로잡을 수 있습니다.
- 성공하면 연결을 저장하고 콘텐츠를 읽기 시작합니다.
- 그런 다음 창이 결과를 알려 줍니다. 몇 개 항목이 들어왔는지, 또는 정확히 무엇이 잘못되었는지 표시합니다.
최신 상태 유지
콘텐츠를 정해진 주기로 다시 읽으므로, 가격 변경이나 새 페이지가 별도 작업 없이 어시스턴트에 반영됩니다.
변경된 것만 다시 색인합니다. 각 항목의 내용을 이미 보유한 것과 비교하므로 바뀌지 않은 페이지에는 비용이 들지 않습니다. 플랫폼 설정 페이지에서 언제든지 지금 동기화를 누를 수도 있습니다.
권한과 접근
키가 얼마나 볼 수 있는지는 플랫폼에 따라 다르며, 이 차이는 중요합니다.
Magento, Shopify, WooCommerce, BigCommerce는 리소스별로 권한을 부여합니다. 제품만 선택하면 그 키는 실제로 제품에만 접근합니다.
WordPress와 Moodle은 그렇지 않습니다. WordPress 애플리케이션 비밀번호는 이를 만든 계정의 권한을 그대로 물려받고, Moodle 토큰은 해당 사용자가 볼 수 있는 것을 봅니다. 선택할 권한 목록이 없습니다. 답변에 쓰고 싶은 콘텐츠 이상으로 접근 권한이 없는 계정을 사용하시고, 비공개 및 비밀번호로 보호된 글도 함께 들어온다는 점을 유의하세요.
저희 쪽에서는 콘텐츠 경로만, 그것도 GET으로만 읽습니다. 쓰기는 하지 않습니다.
API 키 없이 연결하기
모든 선택에는 키가 전혀 필요 없는 방법도 있습니다. 어떤 플랫폼에서도 작동하며, 설정 창이 단계와 함께 안내합니다.
| 대신 | 사용 | 무엇을 하는지 |
|---|---|---|
| 페이지 | 크롤링 | 사이트 전체를 읽어 그 내용을 지식 베이스에 보관합니다. |
| 제품 | 실시간 데이터 피드 | 공개된 제품 피드 URL을 알려 주세요. 가격과 재고가 거기에서 동기화됩니다. |
| 주문 | 사용자 컨텍스트 또는 커스텀 도구 | 로그인한 고객 정보를 사이트에서 보내거나, 어시스턴트가 호출할 수 있는 자체 엔드포인트를 연결하세요. |
연결 해제
창에서 플랫폼 설정 페이지를 열고 연결 해제를 누르세요. 저장된 자격 증명이 제거되고, 그 키로 지식 베이스에 들어온 모든 내용이 삭제됩니다. 다른 출처의 콘텐츠는 그대로 남습니다.
플랫폼에서 키를 철회할 수도 있습니다. 그러면 다음 동기화가 인증 오류로 실패하고 새로운 내용은 읽지 않습니다.
문제 해결
| 표시되는 내용 | 보통 어떤 뜻인지 |
|---|---|
| 인증 실패 | 키가 잘못되었거나 만료 또는 철회되었습니다. WordPress에서는 애플리케이션 비밀번호 대신 일반 로그인 비밀번호를 붙여 넣었을 때도 발생합니다. |
| 완료했지만 읽을 내용을 찾지 못했습니다 | 자격 증명은 유효하지만 그 뒤의 계정이 어떤 콘텐츠도 볼 수 없습니다. 답변에 쓰고 싶은 페이지나 제품에 접근할 수 있는 계정을 고르세요. |
| 연결되었지만 콘텐츠를 읽지 못했습니다 | 키는 받아들여졌고 그 다음 읽기가 실패했습니다. 플랫폼에서 온 정확한 오류가 메시지와 함께 표시됩니다. |
| 권한이 하나 빠졌습니다 | 단계에 나열된 리소스 중 하나 없이 키가 만들어졌습니다. 창에서 알려 준 모든 권한을 포함해 다시 만드세요. |