ナレッジベース

ナレッジベースは Quickchat AI エージェントの中核となる機能です。企業、製品、サービスについて AI エージェントが理解するための基盤になります。適切に構成された包括的なナレッジベースにより、AI エージェントはユーザーの質問に効果的に対応し、正確な回答を提供できます。

このガイドでは、ナレッジベースの概要、効果的な構築方法、性能を最適化するためのヒントを説明します。

データソース

ナレッジベースページ上部のツールバーから、次のいずれかのソースでナレッジを追加できます。

Add Article

手動で作成する記事です。タイトルとリッチテキスト形式の本文で構成されます。FAQ、社内ポリシー、製品仕様など、文書から貼り付けるような内容の表現を細かく管理したい場合に使用します。

ヒント

各記事は 1 つのトピックに絞ってください。複数のトピックを扱う長い記事は、適切な情報を取得しにくくします。記事を分割すると、AI がより明確な回答を生成できます。

Add Paragraph

完全な記事を必要としない、短く独立した情報です。段落は、たとえば「単一の段落」フォルダーにまとめられ、小さな知識単位として扱われます。_「配送には 3–5 営業日かかります」や「返品は 30 日以内に受け付けます」_のような短い情報に適しています。

Add Website

任意の URL からコンテンツをインポートします。インポート方法は 4 つあります。

• 単一ページ：1 つの Web ページをインポートします。ページの他の部分がナビゲーション、広告、フッターである場合は、高度なオプション → HTMLセレクターを使用して、main、#article-body、.docs-content など、インポートする範囲を特定の部分に限定します。
• 複数ページ：URL のリストを貼り付けます。各 URL が個別の記事になります。
• サイトマップ：sitemap.xml を指定します。サイトマップ内の各ページが個別の記事としてインポートされます。ドキュメントサイトや構造化されたブログに適しています。
• すべてのページ：ドメイン内でアクセス可能なすべての URL をサイト全体から収集します。ドキュメント全体や企業ブログのインポートに使用します。

URL はソースとのリンクが維持されるため、自動または必要に応じて最新の状態に保てます。URL記事を最新の状態に保つを参照してください。

自動更新

URL から取り込んだ記事は、1 日 1 回 自動的に再取得することもできます。これにより、誰も操作しなくてもナレッジベースがソースページに追随します。

利用する前に知っておくべき点が 3 つあります。

• 設定は 記事ごと であり、アカウント全体ではありません。同期を保ちたい記事ごとに有効化してください。
• 有料プランのみ で利用できます。Free では記事を手動で更新してください。
• 記事の本文を手動で編集すると、その記事では自動更新がオフになります。これは意図的な動作です。そうしなければ、翌朝の再取得で編集内容が上書きされてしまうためです。ただしその結果、カスタマイズしたページは、再度有効化するまでソースへの追随を停止します。

日次の更新間隔を変更する方法はありません。

Upload File

ドキュメント（PDF、Word、PowerPoint、Excel/CSV）などをアップロードできます。スキャン画像は OCR で読み取られます。テキストは自動的に抽出され、インデックス化されます。最大ファイルサイズは 32 MB、テキストファイル（txt、md、csv、json など）は 1 MB です。テキストファイルがこれより大きい場合は、小さく分割して個別にアップロードしてください。

Shopify MCP

Shopify ストアを接続すると、AI が最新の商品カタログ、商品情報、ストアポリシーに基づいて質問に回答できるようになります。ストアの URL を貼り付けて接続を設定します。内部では、Shopify MCP のカスタムアクションが設定されます。アクションとMCPから管理することもできます。カスタムアクションでは、注文状況に別のアクションが必要な理由も説明しています。

Intercom記事

接続済みの Intercom Help Center からすべての記事を一括インポートします。先に 外部アプリ → Intercom で Intercom を接続する必要があります。インポートを再実行すると、新しい記事と更新された記事が同期されます。

YouTube

YouTube の URL を貼り付けると、動画の文字起こしを記事としてインポートできます。手動で書き起こしたくないチュートリアルチャンネルや製品紹介動画に便利です。

URL記事を最新の状態に保つ

URL記事はソースページとリンクされたままになるため、手動で再インポートしなくても最新の状態を保てます。これには2つの方法があります。毎日自動的に実行される自動更新と、必要なときに手動で実行する手動更新です。どちらも記事の内容を公開中のページの最新バージョンで置き換え、その後AI Agentを自動的に再トレーニングします。

自動更新

URL記事の自動更新をオンにすると、Quickchatが1日に1回ソースページを再チェックし、ソースが変更されるたびに記事を自動的に更新します。これにより、URLに基づくナレッジが手作業なしでソースと同期されたままになります。

ノート

URLの自動更新は有料プランでご利用いただけます。

オンにする方法

• 1件の記事: 記事を開いて右側のメタデータパネルにある自動更新スイッチを切り替えるか、リスト上の記事の行にあるURLの自動更新トグルを使用します。
• 行メニューから: URL記事の行にある「…」メニューをクリックしてURLを自動更新を選択します。
• 一括で: チェックボックスで複数のURL記事を選択し、選択ツールバーの**URLを自動更新 (N)**をクリックします。

自動更新がオンの間、記事はソースと同期された状態に保たれ、内容は読み取り専用になり、_「この記事はソースと同期しています。編集するには自動更新をオフにしてください。」_というバナーが表示されます。テキストを自分で編集するには、オフにして編集をクリックします（または自動更新をオフに切り替えます）。URL記事を編集すると自動更新が自動的にオフになるため、その後の更新で変更内容が上書きされることはありません。

メタデータパネルの最終更新フィールドには、記事がソースから最後に更新された日時が表示されます。

更新に失敗しても、最後に保存したバージョンは公開されたままで、AI Agent は引き続きそのバージョンを使用します。URL の更新に失敗した場合で、ステータス、理由、再試行の動作を確認できます。

手動更新

毎日のチェックを待たずに、今すぐ最新の内容を取得するには、次のようにします。

• 1件の記事: 記事を開いてメタデータパネルのURLを手動で更新をクリックするか、行の「…」メニューからURLを手動で更新を選択します。
• 一括で: URL記事を選択してURLを手動で更新 (N)をクリックするか、右上のすべてのURLを更新を使用して、URLに基づくすべての記事を一度に再取得します。

手動更新は手動での編集内容を公開中のページの内容で置き換えます。そのため、Quickchatは編集済みの記事を上書きする前に確認を求めます。一括更新は一度に最大1,000件のURL記事に対応します。

効果的なナレッジベースを構築するためのヒント

アップロードするテキスト記事、URL、PDF は、それぞれ単独で内容が完結し、対象のトピックを十分に網羅している必要があります。適切に構成された包括的なナレッジベースにより、AI エージェントは効果的に回答するために必要なコンテキストを得られます。

AI エージェントを効果的に活用するために、以下のヒントを確認してください。

ナレッジベースを構築して改善する手順

1. 目的を明確にする AI エージェントの役割と、回答する質問の種類を定義します。ユーザーのニーズやフローに応じて、ナレッジをカテゴリに整理してください。

   EC サイト向け AI エージェントの例：

   • 閲覧とショッピング：商品情報、比較、よくある質問。
   • 購入：支払い方法、割引コード、税金。
   • 配送：発送、注文内容の変更、追跡。

   学生ローン向け AI エージェントの例：

   • 申請前：利用資格とローン条件。
   • 申請中：ガイド、条件、手順。
   • 卒業後：返済スケジュールと返済猶予。

2. データ品質を確保する AI の回答品質は、アップロードするデータによって決まります。以下の点に注意してください。

   • 可読性：アップロードするコンテンツから、不要な情報、表、重複する見出しを削除します。
   • 関連性：よくある質問に回答し、ユーザーの期待に合うコンテンツにします。
   • 一貫性：矛盾する情報や古い情報を避け、日付や価格などの表記を統一します。
   • テキストのみのコンテンツ：画像はサポートされていないため、重要な情報はテキストで伝えます。

3. 明確さを優先する 各記事を明確かつ簡潔で、理解しやすい内容にします。段落を論理的に構成し、関連する情報に焦点を当ててください。

4. 情報を網羅する 複雑な質問にも対応できるよう、AI エージェントに必要な情報をできる限り詳しく提供します。

5. Q&A ではなく回答を記載する 特定の質問と回答の組み合わせではなく、包括的な情報を提供してください。AI エージェントは必要に応じて関連する情報を抽出できます。

6. URL を本文中に埋め込む
   参照先として URL を必ず本文に含めます。URL インポーターを使用する場合も、商品やフォームへのリンクを本文に含めることで利便性が向上します。

   例： EC サイト向け AI エージェントでは、注文キャンセルフォームなどへのリンクを含めます。 「注文をキャンセルするには、こちらから申請してください：https://example.com/cancel-order。」

7. 十分にテストする ナレッジベースの改善にはテストが不可欠です。ユーザーとのやり取りをシミュレーションして、情報の不足や不整合を特定し、コンテンツを調整してください。

よくある問題

• AI エージェントがリンクを省略する、または回答に URL を含めない 各記事の本文に関連するリンクが含まれていることを確認してください。
• 情報が重複している 複数の記事に同じコンテンツをアップロードしないでください。
• 回答に重要な情報が含まれない 条件や例外などの詳細について、個別の記事を作成することを検討してください。
• 日付や価格が正しくない すべての記事を確認して更新し、情報を正確に保ってください。

効果的なナレッジベースの構築は、継続的な改善を伴うプロセスです。明確な目的を設定し、コンテンツを論理的に整理し、十分にテストして AI エージェントの性能を高めてください。

ノート

ナレッジベースの設定やカスタム連携についてサポートが必要な場合は、contact@quickchat.ai までお問い合わせください。

検索

検索機能では、タイトルと本文の両方を検索して、ナレッジベース内の特定の記事をすばやく見つけられます。

検索方法

1. ナレッジ管理画面上部の検索フィールドにキーワードやフレーズを入力します。
2. 入力したテキストがタイトルまたは本文に含まれる記事が、検索結果にすぐに表示されます。

複数選択と一括削除

複数選択と一括削除の機能を使用すると、ナレッジベース内の複数の記事を簡単に管理できます。

複数選択の使用方法

1. ナレッジベースの記事一覧に移動します
2. 選択する記事の横にある「…」をクリックし、選択をクリックします
3. 選択する記事の左側にあるチェックボックスをオンにします。1 件または複数の記事を同時に選択できます
4. 選択した記事は、その後の操作を行うために強調表示されたままになります

一括削除の方法

1. 複数選択で記事を選んだ後、画面下部の削除をクリックして選択した記事を削除します
2. 操作を確認して、選択したすべての記事を完全に削除します

Tags

タグを使うとナレッジベースを整理でき、AI エージェントが特定の質問に対してどの記事を参照するかを絞り込めるようになります。タグは各記事の行に表示されるほか、一覧上部のフィルターとしても利用できます。

記事にタグを付ける方法は 2 つあります。

• 手動 — 記事を開き、右側のメタデータパネルで + Add Tag を使用します。
• Auto-tag with AI — 同じパネルで Auto-tag with AI をクリックします。Quickchat が記事の内容を読み取り、それに基づいてタグを提案します。Sitemap、All Pages、Intercom などで一括取り込みしたナレッジベースのように、数百件の記事を手作業でタグ付けするのが現実的でない場合に便利です。

ツールバーの Tags フィルターを使うと、1 つ以上のタグに一致する記事だけに一覧を絞り込めます。

変更が反映される仕組み

再学習のステップも、押すべきボタンもありません。ナレッジベースへの変更はすべて、バックグラウンドで 1 記事ずつ 自動的に処理されます。しかも再処理されるのは実際に編集した記事だけなので、その間もナレッジベースの残りの記事は質問に回答し続けます。

これは、コンテンツが変わるあらゆるケースに当てはまります。記事の追加・編集、記事の削除、ウェブサイトやファイルの取り込み、URL の手動更新、そして 1 日 1 回の自動更新のいずれもです。

記事のステータス

ナレッジベース一覧の各行には Status 列があります。

Status	意味
Pending	キューに入っており、処理を待っています。
Processing	現在処理中です。
Ready	反映済みです。AI エージェントがこの記事を使用しています。
Failed	処理が完了しませんでした。記事の処理が失敗した場合を参照してください。
更新に失敗しました	URL の更新に失敗しました。AI Agent は最後に保存したバージョンを引き続き使用しています。

ステータスは自動的に更新されるため、ページを再読み込みする必要はありません。

処理中の記事が残っている間は、画面上部に 「N articles still processing」 と表示され、すべて完了すると消えます。ほとんどの記事は数秒で Ready になりますが、大量の取り込みでは記事がバッチで処理されるため、より時間がかかります。

記事が反映されるタイミング

記事が Ready になった時点で、設置済みのウィジェット、接続中のすべてのチャネル、API、AI Preview のすべてに同時に反映されます。公開やデプロイといった別のステップはなく、あなたとエージェントの間にナレッジベースの下書きコピーが存在することもありません。

注意

コンテンツが段階的に公開される仕組みはないため、編集内容は処理が完了した時点で 本番の AI エージェントに反映されます。エージェントを本番稼働させている場合は、保存する前に記事の内容を確認し、保存後に シミュレーションデータセット を再実行して、変更によるリグレッションが起きていないことを確認してください。

URL の更新に失敗した場合

ステータスが 更新に失敗しました の URL 記事でも、Quickchat が最後に保存したバージョンは引き続き公開されます。ステータスにカーソルを合わせると、ソースを更新できなかった理由を確認できます。たとえば、ページが利用できない、サインインが必要、別のサイトにリダイレクトされた、コンテンツを読み取れないといった理由です。

Quickchat は一時的な失敗に対して再試行を続けます。14 日間にわたる更新試行でソースの取得に失敗し続けると、恒久的に利用できないページを繰り返し取得しないよう、自動チェックを停止します。ソースを修正した後、URLを手動で更新を選択してください。更新に成功すると失敗状態が解除され、自動チェックが再開されます。URLを自動更新をもう一度選択して、再試行期間を最初から開始することもできます。

記事の処理が失敗した場合

Failed の記事は、単に AI エージェントに使用されないだけです。ナレッジベースの他の記事は影響を受けず、エージェントは Ready の記事すべてを使って回答を続けます。

失敗のほとんどは一時的なもので、Quickchat が自動的に再試行するため、通常はそのまま解消します。待ちたくない場合は、画面上部の 「N failed to process」 の横にある Retry をクリックすると、失敗したすべての記事をすぐに再試行できます。

記事が失敗し続ける場合は、たいていソースのコンテンツに原因があります。中身が空のページ、テキストを抽出できないファイル、すでに到達できなくなった URL などです。記事を開いて実際に取り込まれた内容を確認するか、正常なソースから取り込み直してください。それでも失敗する場合は contact@quickchat.ai までご連絡ください。

それ以外はすぐに反映されます

処理を経由するのはナレッジベースのコンテンツだけです。Identity、AI Personality、Languages、Actions、Inbox からの返信、Insights、Conversation Rating といった設定は、保存した瞬間に反映されます。