ガイド
サポートボットとAIエージェントに製品ドキュメントの唯一の情報源を与えるには
製品に関する事実 — 仕様、制限、プラン、ポリシー — ごとに正規の文書を1つ決め、AIツールが読みやすいテキスト形式で恒久的なリンクに公開し、サポートボット、社内エージェント、公開AIのクローラーをコピーではなくそのリンクに向けてください。バージョン管理し、その場で更新し続ければ、すべてのボットが同じ最新の忠実性チェック済みの内容から回答します。
ボットごとに答えが違う理由
サポートボットは与えられたものから回答します。ヘルプセンターの書き出し、古いPDFの仕様書、誰かが昨年コピーしたWikiページ。公開アシスタントはWeb上で見つけたものから回答します。同じ事実が5か所にあれば、ボットはそれぞれ別のものを選びます。
その結果、廃止された制限や昨年の価格、1つのプランにしかない機能を引用するボットと、それを信じる顧客が生まれます。
何を唯一の情報源にするか決める
それ以外のコピー — スライド、オンボーディングメール、営業資料 — は、内容を言い直すのではなく正規の文書にリンクしてください。
| 事実の種類 | 正規の文書 | 担当 |
|---|---|---|
| 仕様と制限 | 製品ごとの仕様書 | プロダクト |
| プランと価格 | プラン文書 | プロダクトマーケティング / 財務 |
| ポリシー(返金、SLA、データ) | ポリシー文書 | 法務 / サポート |
| 使い方とトラブルシューティング | ヘルプセンターの記事 | サポート / ドキュメント |
| リリースでの変更 | 変更履歴 | プロダクト |
ボットが正しく答えられるドキュメントを書く
- 1つの事実は1か所に、1つの言い回しで。制限を3つの記事で言い直さないでください。
- 制限や数値は単位と範囲を付けて書きます。「Teamプランでワークスペースあたり最大10 GB」のように。
- その記述がどのプラン、バージョン、地域に当てはまるかを書きます。
- 変わる事実には日付を付け、非推奨の機能は明確に表示します。
- 本物の見出しと表を使い、設定画面や表のスクリーンショットは避けます。
- 各文書の冒頭に、最もよくある質問に答える短い要約を置きます。
ボットを情報源につなぐ
- サポートボットのナレッジソースを正規の文書に向けます。できればPDFではなくMarkdownかJSONで。
- 正規の文書を一覧にしたルームのインデックス(llms.txt)を公開し、外部のAIツールが見つけられるようにします。
- 正規の文書が変わるたびにボットを再同期するか、ライブのリンクを読ませます。
- ボットの会話記録を確認し、正規の文書にたどれない回答がないかを調べます。
The Papersの位置付け
The Papersは各正規文書を恒久的なURLのAIバージョンとして公開します。人向けのページ、フロントマター(正規URL、バージョン、ステータス、AIレディネス)付きのMarkdown、そしてブロック・指標・ページの出典情報を含むJSONです。/{room}/llms.txt と /{room}/index.md にあるデータルームのインデックスがすべての文書を一覧にします。
公開前に、すべての数字・日付・期間が原本と一致している必要があり、「最大」などの条件は結び付いたまま保たれます。文書を更新してもURLとバージョン履歴は保たれるため、ボットや公開アシスタントは常に最新版を読みます。アナリティクスで、どのAIエージェント、クローラー、ツールが各文書をどの形式で読んだかを確認できます。
公開文書は一覧に掲載してインデックス可能にでき、ai.yourcompany.com のようなカスタムドメインでルームを自社のアドレスに置けます。主要な参照文書に適しており、文書ごとの忠実性チェックなしにアーカイブ全体を一括変換する用途向けには作られていません。
よくある質問
- ヘルプセンター自体を唯一の情報源にすべきですか?
- 使い方の内容については、多くの場合そうです。制限、プラン、ポリシーのような確定的な事実については、ヘルプ記事がリンクする1つの正規文書のほうが正確に保ちやすくなります。
- サポートボットにはどの形式を読ませるべきですか?
- MarkdownやJSONのようなテキスト形式は、PDFより検索に使いやすく、誤りも起きにくいです。The Papersは各文書について両方を公開します。
- 公開AIアシスタントはどうやって自社の文書を見つけますか?
- 正規の文書を公開してインデックス可能にし、llms.txtのインデックスに掲載してください。そうすればAIツールやクローラーが見つけられます。
- 文書が変わるとリンクはどうなりますか?
- The Papersでは、URLは変わらずバージョン履歴も保持されるため、そこへのリンクが切れることはありません。