ナレッジベース

ナレッジベース は Quickchat の AI エージェントの中核です。企業や製品、サービスの理解の土台となります。

このガイドでは概要、効果的な構築方法、最適化のコツを説明します。

データソース

以下の形式で知識を追加できます：

• テキスト記事
  手早く内容を追加できます。

  ヒント

  1 記事につき 1 トピック、4,000 文字以内 を目安に。

• URL
  Web ページ本文、AI 要約、複数ページを取り込み可能。
  1 URL = 1 記事として登録されます。

  オプション：

  • 単一ページ（AI 強化）
  • 複数ページ
  • サイトマップ（sitemap.xml）
  • 全ページ（全 URL）

• ファイル
  ドキュメント（PDF、Word、PowerPoint、Excel/CSV）などをアップロードできます（最大 32MB）。スキャン画像は OCR で読み取られます。テキストは自動的に抽出・インデックス化されます。

自動更新

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

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

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

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

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

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

自動更新

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

ノート

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

オンにする方法

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

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

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

手動更新

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

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

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

効果的なナレッジのためのヒント

各記事/URL/ファイルは自己完結で、対象トピックを十分にカバーしましょう。

構築と改善のステップ

1. 目的を明確に
   エージェントの役割と回答する質問の種類を定義し、ユーザーのニーズ別に整理します。

2. データ品質の確保

   • 可読性：不要な情報や重複ヘッダーを除去
   • 関連性：よくある質問に焦点
   • 一貫性：矛盾や古い情報を排除（価格・日付など）
   • テキストのみ：重要情報はテキストで明記

3. 明瞭さを優先

4. 十分な詳細を

5. Q&A ではなく解説形式を優先

6. URL を本文中に埋め込む
   例：
   「注文をキャンセルするには https://example.com/cancel-order から申請してください。」

7. 十分にテストする

よくある問題

• リンクが回答に含まれない：本文中に適切に含める
• 重複情報：記事間の重複を避ける
• 重要な詳細の欠落：特殊ケースは個別記事に
• 日付や価格の誤り：定期的に更新

ナレッジ構築は反復的なプロセスです。明確な目的、論理的な構成、徹底したテストが鍵です。

ノート

導入支援やカスタム連携が必要な場合は contact@quickchat.ai まで。

検索

検索 では タイトルと本文 の両方を対象に記事を探せます。

使い方

1. 画面上部の Search にキーワードを入力
2. 一致する記事が即時に表示

複数選択と一括削除

複数記事をまとめて管理できます。

複数選択

1. 記事一覧を開く
2. 対象記事の「…」→ Select
3. 左側のチェックで選択
4. 選択状態は保持されます

一括削除

1. 選択後、下部の Delete をクリック
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	処理が完了しませんでした。以下の「記事の処理が失敗した場合」を参照してください。

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

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

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

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

注意

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

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

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

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

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

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

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