Wagtail 연동
Wagtail 사이트의 질문에 답하는 AI 어시스턴트
개요
Wagtail 패키지는 사이트에 AI 어시스턴트를 놓습니다. 모든 페이지 구석에 채팅 버튼이 있고, 방문자는 자기 말로 질문하며, 답은 여러분의 콘텐츠에서 나옵니다. 웹사이트, 업로드한 문서, 도움말 글이 바탕입니다.
AI 관련 안내: 사이트의 답변은 AI가 만듭니다. 때로는 부정확하거나 불완전할 수 있습니다. 의존하기 전에 확인하세요. 특히 중요한 결정에서는 꼭 확인하세요.
작동 방식
패키지는 미들웨어를 추가해, 모든 페이지의 닫는 body 태그 바로 앞에 작은 스크립트 하나를 넣습니다. 이 스크립트는 페이지 로딩이 끝날 때까지 기다린 뒤 Asyntai에서 채팅 위젯을 가져옵니다. 그래서 사이트가 먼저 그려지고 페이지 속도는 그대로입니다. 여러분의 서버는 Asyntai와 통신하지 않으며, 방문자의 브라우저만 통신합니다.
템플릿은 아무것도 바꾸지 않습니다. 미들웨어는 Wagtail 관리자 화면을 건드리지 않고, HTML 페이지가 아닌 것도 건드리지 않습니다.
요구 사항
- Asyntai 계정. 시작하기에는 무료 요금제로 충분합니다.
- Wagtail 5.2 이상 사이트, Django 4.2 이상, Python 3.9 이상.
- 그 사이트의 코드에 접근할 수 있어야 합니다. 파이썬 패키지를 설치하기 때문입니다.
설치
다음 단계를 따라 Wagtail 사이트에 Asyntai를 추가하세요:
패키지 설치
사이트와 같은 환경에서 Python Package Index로부터 설치하세요:
pip install wagtail-ai-chatbot
설정에 추가
앱과 Wagtail 설정 모듈을 INSTALLED_APPS에, 미들웨어를 MIDDLEWARE 맨 위에 추가하세요:
INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
마이그레이션 실행
설정을 저장할 테이블을 만듭니다:
python manage.py migrate wagtail_asyntai
위젯 ID 붙여넣기
Wagtail 관리자 화면에서 Settings, 그다음 Asyntai chat assistant를 여세요. 위젯 ID를 붙여넣고 Save를 선택하세요. ID는 Asyntai 대시보드의 Setup & Integration에서 찾을 수 있습니다. 코드 전체를 붙여넣어도 됩니다. 패키지는 ID만 남깁니다.
팁: 게시하기 전에 Asyntai 대시보드에서 문서, 질문과 답변, 지침을 넣어 두면 첫 방문자부터 제대로 답합니다.
설정
- 위젯 ID: 이 칸에 올바른 ID가 있는 동안 채팅이 켜지고, 비어 있으면 꺼집니다.
- 로그아웃한 방문자에게만 채팅 표시: 로그인한 사용자는 채팅을 보지 못합니다. 어시스턴트가 아직 가입하지 않은 사람을 위한 것일 때 유용합니다.
- 위젯 스크립트 주소: Asyntai 지원팀이 요청하지 않는 한 이 값은 그대로 두세요.
설정은 사이트마다 따로 있습니다. 하나의 Wagtail 설치로 여러 사이트를 제공하는 프로젝트는 사이트마다 다른 어시스턴트를 둘 수 있습니다.
설정 파일에서의 설정
설정을 환경 변수에 두는 프로젝트는 관리자 화면을 건너뛰고 값을 코드에 넣을 수 있습니다. 둘 다 채워져 있으면 관리자 화면이 이깁니다.
ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"
다른 세 값은 선택입니다: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL, ASYNTAI_SKIP_PREFIXES. 마지막 값은 위젯이 절대 건드리지 않을 경로를 지정하며, 관리자 화면이 /admin/에 있지 않을 때 필요합니다.
위젯을 직접 배치하기
위치를 직접 고르고 싶다면 미들웨어를 빼고 태그를 기본 템플릿에 넣으세요. 태그와 미들웨어가 둘 다 동작하는 일은 없으므로 둘 다 남겨도 됩니다.
{% load asyntai %} ... {% asyntai_widget %}
어시스턴트가 할 수 있는 일
- 방문자 질문에 바로 답하기, 24시간, 모든 페이지에서
- 질문에서 언어를 자동으로 인식해 80개 이상의 언어로 답변
- 방문자가 페이지를 옮겨 다녀도 열린 상태 유지
- 업로드한 문서, 자주 묻는 질문, 지침을 사용해 정확하게 답합니다
개인정보 보호
패키지가 페이지에 내보내는 값은 위젯 ID와 스크립트 주소, 딱 두 개입니다. 페이지나 사용자에 관한 정보는 Asyntai로 전송되지 않습니다. Asyntai와 통신하는 것은 방문자의 브라우저뿐이며, 방문자가 채팅을 열 때만 통신합니다.
요금제와 가격
Wagtail 연동은 무료 요금제를 포함한 모든 Asyntai 요금제에서 쓸 수 있습니다. 각 요금제에는 월 메시지 수가 있고, 모든 채널과 연동이 이를 함께 사용합니다. 요금제 보기.
제거
채팅을 끄려면 위젯 ID 칸을 비우세요. 패키지를 없애려면 설정에서 미들웨어와 앱을 빼고 pip으로 제거하세요.
소스 코드
이 패키지는 자유 소프트웨어이며 오픈 소스로, MIT 라이선스를 따릅니다. 모든 줄을 GitHub에서 읽을 수 있습니다.
도움이 필요하신가요?
질문이 있거나 문제가 발생하면 [email protected]으로 문의하세요.