AI チャット
公開ページに AI チャットを設置すると、読者がドキュメントについて質問でき、AI がドキュメントの内容をもとに回答します。
AI チャットの設定
新しく作成したプロジェクトは、初期状態で AI チャットを利用できるようになっています。公開すると、公開ページの右下に AI チャットが表示されます。
設定を変更する場合は、次の手順で行います。
- プロジェクトの設定の画面を開き、左のメニューで「AI チャット」を選びます。プロジェクトの設定の画面は、編集画面の上のバーにある歯車のボタン、またはダッシュボードの「プロジェクトの設定」から開きます。
- 次の項目を入力して「保存」を押します。公開ページに AI チャットを表示しない場合は、「AI チャットを使えるようにする」をオフにします。
- プロジェクトを公開します。設定は、見出しの右に「公開すると反映」と表示されているとおり、公開したときに反映されます。
| 項目 | 説明 |
|---|---|
| サービス名 | ドキュメントが説明しているサービスの名前です(例: 〇〇クラウド)。 |
| サービスの概要 | どのようなサービスか、誰が何のために利用するものかを記載します。AI が、質問の前提として使用します(「このドキュメント」が何を説明しているのかなど)。 |
| あいさつ | チャットを開いたときに、最初に表示する文言です。空欄の場合は、既定の文言を表示します。 |
| メッセージテンプレート | 読者がよく聞く質問の例です。会話を始める前のチャットに、あいさつの下にボタンとして表示します(下記「メッセージテンプレート」)。 |
| 表示の形 | 読者が初めてチャットを開いたときの表示形式です。「フロート(右下に浮かぶ窓)」か「右ペーン(本文の右側に並べる)」を選択します。読者はチャットの中で切り替えられます。 |
| 埋め込んでよいサイト | AI チャットを、ほかのサイトに埋め込むときに使用します(下記)。 |
編集画面の本文の右上にある「プレビュー」を開くと、右下の AI チャットで、公開前の内容をもとに質問できます。プレビューでの質問は、AI 回答枠に含まれません。
メッセージテンプレート
メッセージテンプレートを設定すると、会話を始める前のチャットに、質問の例がボタンとして表示されます。読者がボタンを押すと、その文を送信してチャットが始まります。読者は質問を入力しなくても、すぐに回答を確認できます。
- プロジェクトの設定の「AI チャット」の「メッセージテンプレート」で、「テンプレートを追加」を押します。
- 入力欄に、質問の文を入力します(例: 料金プランの違いを教えてください)。
- 「保存」を押して、プロジェクトを公開します。
- 件数と文字数: 最大5件まで設定できます。1件あたり100文字までです。
- 並び順: 入力欄の右の矢印のボタンで並べ替えられます。チャットには、この順に表示されます。削除するには「×」のボタンを押します。
- 表示されるとき: 新しい会話を始めるときなど、会話がまだないときのみ表示されます。会話が始まると表示されません。ほかのサイトに埋め込んだチャットにも表示されます。
下記「Q&A の履歴を見る」で、読者が実際によく聞いている質問を確認し、ドキュメントで回答できるものを設定すると効果的です。
読者の使い方
- 公開ページの右下のボタンを押すと、チャットが開きます。
- メッセージテンプレートを設定している場合は、質問の例のボタンを押すと、その質問でチャットを始められます。
- 回答ごとに、よかった・よくなかったを評価できます。
- 過去のチャットは、チャットの左上のボタンから開き直せます(下記「チャットの履歴が残る期間」)。
- 回答は AI が自動で生成するため、誤りを含む場合があります。
本文に「AI チャットの入力欄」ブロックを配置すると、ページの中から直接質問を始められます(ブロックの追加はプロジェクト作成を参照)。
チャットの履歴が残る期間
読者は、公開ページを同じブラウザで開くと、自分のチャットの履歴を確認できます。
- チャットが残る期間: 最後に AI チャットを利用してから24時間です。利用するたびに、その時点から24時間に延長されます。
- 24時間利用しなかった場合: 履歴は表示されなくなり、新しいチャットから始まります。
- ブラウザごと: 履歴は、ブラウザごとに分かれます。別のブラウザや端末、プライベートブラウズでは表示されません。ブラウザの Cookie やサイトのデータを削除した場合も、表示されなくなります。
- 埋め込んだチャット: ほかのサイトに埋め込んだチャットの履歴は、埋め込み先のサイトごとに分かれます。埋め込んだチャットの回答にあるリンクから公開ページを開いた場合は、その会話を公開ページでも続けられます。
読者の画面に表示されなくなったあとの質問と回答の取り扱いは、プライバシーポリシーに従います。
ほかのサイトに埋め込む
AI チャットを、自社のサイトなど、ほかのサイトに埋め込めます。
- プロジェクトの設定の「AI チャット」の「埋め込んでよいサイト」に、埋め込むサイトを1行に1つ、https://example.com の形式で入力します(最大10件)。空欄の場合は、どのサイトにも埋め込めません。
- 保存して、プロジェクトを公開します。
- 「埋め込み用のコード」をコピーし、埋め込むサイトの HTML に貼り付けます。
埋め込んだチャットの言語
翻訳する言語を追加しているプロジェクトでは、「埋め込み用のコード」の右上の「チャットの言語」で、埋め込むチャットの言語を選べます。原文以外の言語を選ぶと、コードの URL の末尾に ?lang=en のような言語の指定が付きます。
言語を指定したチャットは、あいさつ・メッセージテンプレート・チャットの画面の文言・AI の回答がその言語になります。回答の中のリンクからは、その言語の公開ページが開きます。
言語を指定しない場合や、翻訳を公開していない言語を指定した場合は、原文の言語で表示します。読者のブラウザの言語では切り替わらないため、言語ごとにページがあるサイトでは、ページの言語に合わせてコードを使い分けてください。
質問の数を確認する
プロジェクトのダッシュボードの「Q&Aの発生回数」に、読者の質問の数が日ごとに表示されます。期間は「7日」「30日」「90日」から選択できます。集計の対象は、公開ページと埋め込んだチャットでの読者の質問です。削除した会話の質問は含まれません(下記「会話を削除する」)。
Q&A の履歴を見る
ダッシュボードの「Q&A の履歴を見る」を押すと、読者が AI チャットでした質問の一覧が、新しい順に表示されます。編集画面やプレビューで試した質問は含まれません。
- 絞り込み: 「期間」「経路」(「公開ページ」「埋め込み」)、「バージョン」、回答の評価(「役に立った」「役に立たなかった」「評価なし」)、「質問の文で探す」で絞り込めます。評価の件数は、一覧の上に表示されます。
- バージョン: 質問ごとに、AI が回答したときに公開していたプロジェクトのバージョン(v1、v2…)が表示されます。「バージョン」で選ぶと、そのバージョンのときの質問だけを表示できます。プロジェクトを公開し直したあとに、回答の評価が変わったかを確認するときに使えます。
- 会話を見る: 質問を押すと、その質問を含む会話(読者の質問と AI の回答)が表示されます。AI の回答の右下には、その回答のもとにしたバージョンが表示されます。
- ドキュメントの見直し: 「役に立たなかった」の質問から見ると、ドキュメントに足りない内容を見つけやすくなります。
MCP 連携で接続した AI ツールからも、Q&A の履歴を読み取れます(削除した会話は含まれません)。
会話を削除する
個人情報を含む会話や、動作確認のために送った会話などは、Q&A の履歴から削除できます。
- Q&A の履歴で、削除したい会話の質問を押して、会話を開きます。
- 会話の右上の「会話を削除」(ごみ箱のボタン)を押します。
- 確認の画面で「削除」を押します。
削除した会話は、次のようになります。
- 削除の単位: 会話の中の質問と回答が、すべて削除されます。質問を1件ずつ削除することはできません。
- Q&A の履歴と件数: 一覧・評価の件数・ダッシュボードの「Q&Aの発生回数」に含まれなくなります。MCP で読み取る Q&A の履歴にも含まれません。
- 読者の画面: 読者の AI チャットの履歴からも削除されます。
- 元に戻す: 削除した会話は、元に戻せません。
公開チャットの制限
公開ページと、ほかのサイトに埋め込んだ AI チャットには、過度な利用を防ぐための制限があります。制限に達すると、読者が質問しても AI は回答せず、チャットにメッセージが表示されます。
| 制限 | 内容 | 読者に表示されるメッセージ |
|---|---|---|
| 読者ごとの送信回数 | 1人の読者(ブラウザ)が送信できる質問は、直近24時間で30回までです。 | 「送信できる回数の上限に達しました。時間をおいてお試しください。」 |
| 組織の AI 回答枠 | 組織の今月の AI 回答枠と AI 追加枠を使い切ると、その月は回答できなくなります。BYOK のプランには、回答数の上限はありません。 | 「現在、AI チャットは回答できません。しばらくしてから、もう一度お試しください。」 |
- 読者ごとの送信回数の数え方: 送信した時刻から24時間が経過した質問は、数えません。決まった時刻にまとめてリセットされるのではなく、時間の経過とともに、再び送信できるようになります。
- 読者の数え方: 読者は、ブラウザごとに区別します。同じ方でも、別のブラウザや端末から利用すると、別の読者として数えます。
- プレビュー: 編集画面のプレビューで試した質問は、どちらの制限にも含まれません。