Wagtail連携

WagtailサイトでのAIアシスタントによる質問対応

概要

Wagtailパッケージは、あなたのサイトにAIアシスタントを置きます。チャットボタンがすべてのページの隅に表示され、訪問者は自分の言葉で質問し、答えはあなた自身のコンテンツから返ります。ウェブサイト、アップロードした文書、ヘルプ記事が元になります。

AI に関する注意: サイト上の回答はAIが作ります。ときに不正確だったり不完全だったりします。頼る前に確認してください。特に重要な判断のときは必ず確認してください。

仕組み

パッケージはミドルウェアを追加し、すべてのページの終了bodyタグの直前に小さなスクリプトを1つ置きます。スクリプトはページの読み込みが終わるのを待ってから、Asyntaiのチャットウィジェットを取得します。そのためサイトが先に描画され、ページ速度は変わりません。あなたのサーバーがAsyntaiと通信することはありません。通信するのは訪問者のブラウザだけです。

テンプレートは何も変えません。ミドルウェアはWagtailの管理画面に手を触れず、HTMLページでないものにも手を触れません。

要件

Asyntai のアカウント。無料プランで始められます。
Wagtail 5.2以降のサイト、Django 4.2以降、Python 3.9以降。
そのサイトのコードへのアクセス。Pythonパッケージをインストールするためです。

インストール

次の手順で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のサポートから変更を求められない限り、この値はそのままにしてください。

設定はサイトごとです。1つのWagtailインストールで複数のサイトを配信するプロジェクトは、サイトごとに別のアシスタントを設定できます。

設定ファイルでの設定

設定を環境変数で持つプロジェクトは、管理画面を使わずにコードで値を指定できます。両方に入力がある場合は管理画面が優先されます。

ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"

ほかに3つの値は任意です。ASYNTAI_SHOW_TO_ANONYMOUS_ONLY、ASYNTAI_SCRIPT_URL、ASYNTAI_SKIP_PREFIXESです。最後の値はウィジェットが決して触れないパスを指定します。管理画面が/admin/にない場合に必要です。

ウィジェットを手で置く

場所を自分で選びたい場合は、ミドルウェアを使わずにタグをベーステンプレートに置いてください。タグとミドルウェアが両方とも動くことはないので、両方残しても安全です。

{% load asyntai %} ... {% asyntai_widget %}

アシスタントにできること

訪問者の質問にすぐ答える。24時間、すべてのページで。
質問から言語を自動判定し、80以上の言語で回答します
訪問者がページを移動しても開いたままにする
アップロードした文書、よくある質問、指示を使って正確に答えます

プライバシー

パッケージがページに出す値は2つだけです。ウィジェットIDとスクリプトのアドレスです。ページやユーザーに関する情報はAsyntaiに送られません。Asyntaiと通信するのは訪問者のブラウザだけで、しかも訪問者がチャットを開いたときだけです。

プランと料金

Wagtail連携は無料プランを含むすべてのAsyntaiプランで使えます。各プランには月あたりのメッセージ数が含まれ、すべてのチャネルと連携で共有します。料金を見る.

アンインストール

チャットを止めるにはウィジェットIDの欄を空にしてください。パッケージを外すには、ミドルウェアとアプリを設定から取り除き、pipでアンインストールします。

ソースコード

このパッケージは自由なオープンソースで、MITライセンスです。すべての行をGitHubで読めます。

お困りですか？

ご質問や問題がございましたら、[email protected]までお問い合わせください。

ドキュメント