コアガイド

ナレッジ: キャラクターに本棚を持たせよう

ドキュメントをアップロードして、キャラクターがその内容から回答できるようにしましょう — 親しみやすく、実践的なガイド

読みやすい HTML レイアウト 対象読者:ドキュメントを信頼できるナレッジとして追加する制作者
青いブロック console で行う具体的な操作。
オレンジのブロック よくある落とし穴・制限・注意点。
緑のブロック 正しく動いているか確かめるチェック。
紫のブロック AI ツールに渡せるプロンプト断片。

ナレッジは、キャラクターの本棚に並んだ本だと考えてください。誰かが質問すると、あなたのキャラクターは本棚から本を取り出し、実際にそこに書かれている内容から回答できます — でっち上げるのではなく。

やることはシンプルに3つだけです。ファイルをアップロードする準備が整うのを待つ、そしてそれを必要とするシーンの本棚に置く。以上です。

ここでは一貫した例を使います。あなたはオンライン靴店のサポートキャラクターを作っているとしましょう。配送、返品、そして自社の商品に関する質問に — 自分自身のドキュメントから直接 — 回答できるようにしたいのです。


1つのドキュメントの旅(全体像)

始まりから終わりまで、流れ全体は次のとおりです。

  1. ドキュメントをアップロードする。
  2. 準備が整うまで少し待つ(タグがActiveに変わるのが見えます — 詳しくは後述)。
  3. キャラクターがその内容から回答できるようにしたいシーンにアタッチする。
  4. 公開する(「投稿」を押す)と、キャラクターがその内容から回答できるようになります。

それだけです。技術的なセットアップも、格闘するような設定もありません。アップロードしてアタッチするだけ。あとはプラットフォームが舞台裏ですべて処理します。


ステップ1 — ドキュメントをアップロードする

👉 やること: ナレッジベースページに移動します。これは、すべてのファイルが並んだシンプルで検索可能な1つのリストです — フォルダーで仕切られた書類棚ではなく、1つの本棚のようなものです。(フォルダーもタグもありません。検索してスクロールするだけです。)

使えるファイルの種類

✅ 次のファイル形式に対応しています。

  • テキストファイル(.txt)
  • PDF(.pdf)
  • Word ドキュメント(.doc, .docx)
  • CSV として保存したスプレッドシート(.csv)

サイズと件数の上限

アップロードボックスへの入力

👉 やること: ファイルをアップロードエリアにドラッグし、次の2項目を入力します。

  • 名前 — ファイル名から自動的に入力されます。名前は変更できます(最大64文字)。
  • 説明 — 任意です。「2024年返品ポリシー」のような、自分用の短いメモです。

ステータスタグの読み方(これは重要)

アップロード直後、各ファイルには小さなステータスタグが表示されます。これらの意味を覚えておきましょう — 余計な悩みを大きく減らせます。

タグ 意味
Processing… キャラクターがまだファイルを「読み込み中」です。まだ準備できていません。 ページは数秒ごとに自動で更新されるので、待つだけで大丈夫です。
未使用 使用できる状態 — ただし、まだどのシーンの本棚にも置かれていません。
Active 準備が整っており、かつ少なくとも1つのシーンで使用中です。タグをクリックすると、どのシーンか正確に確認できます。
エラー ファイルの読み込み中に何か問題が発生しました。もう一度アップロードしてください。

おまけ: ウェブサイトをナレッジに変える

ウェブサイトのスクレイピングというオプションもあり、ウェブサイトのページを取得してナレッジに変換してくれます — 情報がすでにヘルプサイトにあって、手動でファイルをダウンロードしたくない場合に便利です。入り口はナレッジベースのページではなく、AIアバターの作成フローにあります — AIアバターページで「AIアバター設定をカスタマイズする」を選ぶと、メッセージ入力欄の横に「ウェブサイトのスクレイピング」ボタンがあります。取り込まれると、それらのページはアップロードしたドキュメントとまったく同じように動作します。


ステップ2 — 本を正しい本棚に置く

ファイルをアップロードしただけでは、ライブラリに存在するというだけです。まだどのキャラクターの本棚にも置かれていません。どの本にどのシーンが手を伸ばせるかは、シーンごとにあなたが決めます。

👉 やること: ストーリーボード(シーンを並べた漫画のコマ割り)を開きます。そして:

  1. 左サイドバーでナレッジタブを見つけます — ここにアップロード済みのファイルが一覧表示されます。(まだ Processingエラーを表示しているファイルはグレーアウトされ、まだ使えません。)
  2. その内容から回答できるようにしたいシーンにファイルをドラッグします。これで、そのシーンの本棚にその本が置かれました。
  3. シーンのエディターには、その本棚に何があるかを一覧表示するナレッジセクションが表示されます。そこから確認したり、外したりできます。
  4. 公開します(「投稿」を押す)。公開するまで、変更は訪問者に反映されません。

誰もがつまずく唯一のルール

キャラクターがどの本に手を伸ばせるかについて、覚えておくべきことがあります。会話のどの時点でも、キャラクターが読めるのは次のものだけです。

他のシーンにある本には、今は手が届きません。シンプルな2つのポイント:

  • 「誰にとっても必要」なドキュメントは最初のシーンに置きましょう。 最初のシーンの本棚は、会話がどこへさまよっても常に手の届く範囲にあります。ですから、靴店の一般的な FAQ、配送の基本、連絡先情報など — これらは最初のシーンに置きます。
  • トピック固有のドキュメントは、そのトピックを扱うシーンに置きましょう。 返品シーンに置いた「返品ポリシー」ドキュメントは、誰かが商品閲覧シーンでチャットしている間は読まれません — そしてこれは通常まさにあなたが望むことです。回答が焦点を絞った、テーマに沿ったものに保たれます。(シーンの仕組みについてはストーリーとシーンのガイドをご覧ください。)

「回答はこれと完全に一致しなければならない」についての補足

ときには、ドキュメントに何が書かれていようと一字一句正確でなければならない事実があります — たとえば「50ドル以上は送料無料、それ以外なし」のように。Perxona には、そうした正確で手書きの回答を設定し、ドキュメントを上書きする方法があります。


本当に違いを生むヒント

  • テキストが豊富で整ったドキュメントをアップロードしましょう。 実質的にページのスキャンや写真にすぎない PDF (選択可能なテキストがないもの)は、キャラクターには読みにくいです。本物のテキストの方がはるかにうまくいきます — Word ドキュメント、テキストベースの PDF、プレーンテキストファイルなど。
  • 可能なら1ファイルにつき1トピックに。これにより「どのシーンにどのファイルを割り当てるか」の判断が簡単になり、回答も的確に保たれます。
  • 大局的な事実 → 最初のシーン。トピック固有の事実 → そのトピックのシーン。 これが整理の極意のすべてです。
  • 準備完了の合図を待ちましょう。 まだProcessing中のファイルをアタッチしても、キャラクターにはまだ読むものが何もありません。
  • 無駄を省きましょう。 よく選ばれた少数のドキュメントの方が、持っているものすべてを放り込むよりも優れています — それにいずれにせよファイル件数とストレージの上限があります。

うまくいかないとき

見えている状態 おそらく起きていること 解決方法
ファイルがProcessing…のまま固まっている まだ準備中(または大きなファイル) 待ちましょう — リストは自動で更新されます。エラーに変わったら、もう一度アップロードしてください。
アップロードしたドキュメントについて、キャラクターが「わかりません」と言う ファイルが正しいシーンの本棚(最初のシーンまたは現在のシーン)に置かれていない、または公開していない ファイルを正しいシーンに置いてから、公開してください。
キャラクターが別のシーンにあるドキュメントを使ってくれない キャラクターが手を伸ばせるのは最初のシーン + 現在のシーンだけです ファイルを現在のシーンに移動または追加するか、最初のシーンに置いて常に手の届く状態にしてください。
アップロードが拒否される ストレージ不足、または一度に 20 件を超えた ファイルを縮小または分割する、使っていないファイルを削除する、あるいはプランをアップグレードしてください。
ファイルを削除できない Active(シーンで使用中)です まずすべてのシーンから外してから、削除してください。
誤ったファイル形式が拒否される ナレッジが受け付けるのはtxtpdfdocdocxcsvのみです 人に見せるための画像 / 動画 / スライドなら、代わりにメディアを使ってください。
ドキュメントを編集したのに、キャラクターがまだ古い内容で回答する キャラクターは公開済みのバージョンを読みます 何かを変更したら、もう一度公開してください。

1ページのおさらい

  1. ナレッジ = キャラクターの本棚にある本 — キャラクターがそこから回答できるもの。メディア(キャラクターが見せるもの)や、性格、流れとは別物です。
  2. アップロード → タグが「Processing」から離れるのを待つ → シーンにアタッチ → 公開。 タグを見守りましょう: Processing → Idle → Active。
  3. ファイル形式: txtpdfdocdocxcsv。上限: 一度に20件、およびプランのストレージ容量。検索可能な1つのリストで、フォルダーはありません。AIアバターの作成時にウェブサイトのスクレイピングでウェブページをナレッジとして取り込むこともできます。
  4. 各本を、シーンにドラッグして正しい本棚に置き、公開しましょう。 キャラクターが手を伸ばせるのは最初のシーンの本棚 + 現在のシーンの本棚だけです — ですから「誰にとっても必要」なドキュメントは最初のシーンに置きましょう。
  5. 正確な回答の上書きは存在しますが、まだ管理画面の画面ではありません — 当面は、正確でなければならない事実をシーンの指示に書き込む、および / または、短く明快なドキュメントに記載しておきましょう。
  6. 覚えておきましょう: 「準備完了」には少し時間がかかること、使用中のファイルは削除できないこと、そしてどんな変更にも新たな公開が必要なこと。