アシスタント

ユーザーが製品で成功し、より速く答えを見つけられるよう支援します

アシスタントはPro および Custom プランで自動的に有効になります。

アシスタントについて

アシスタントは、自然言語での問い合わせを通じてドキュメントに関する質問に回答します。ドキュメントサイトに直接埋め込まれており、ユーザーは文脈に即したヘルプにすぐアクセスできます。

アシスタントは、Claude Sonnet 4 を用いたツール呼び出し対応のエージェント型 RAG（retrieval-augmented generation）を使用します。ユーザーが質問すると、アシスタントは次のことを行います。

• 検索と取得: 正確な回答のために、ドキュメントから関連コンテンツを検索・取得します。
• 出典の明示: 参照先のページへ直接移動できるリンクを提示します。
• コピー可能なコード例の生成: ドキュメントに基づく解決策の実装を支援します。

アシスタントに送信された各メッセージは、プランのメッセージ枠にカウントされます。枠を超えた場合は、追加メッセージに超過料金が発生します。支出上限を設定するか、メッセージ枠に達した時点でアシスタントを無効化できます。

ダッシュボードでアシスタントの利用状況を確認し、ユーザー行動やドキュメントの有効性を把握できます。クエリデータをエクスポートして分析することで、次の点を特定できます。

• 改善が必要な可能性があるよくある質問
• ユーザーが回答を見つけにくいコンテンツの不足箇所
• 追加コンテンツの効果が見込める人気トピック

アシスタントの設定

アシスタントは Pro および Custom プランでデフォルト有効です。ダッシュボードから有効／無効の切り替え、応答処理の設定、利用上限額の設定などを管理できます。

アシスタントのステータス

ドキュメントサイトでアシスタントを有効または無効にするには、アシスタントのステータスを切り替えます。

アシスタントのディフレクション

アシスタントが未回答の質問をサポートチームへ案内できるようにします。アシスタントが回答できない質問をしたユーザーに提示する連絡先メールアドレスを指定してください。

検索対象サイト

サイト検索はベータ版です。ドキュメントサイトで有効化するには、営業チームまでご連絡ください。

アシスタントが質問に回答する際、追加のコンテキストとして検索できるサイトを設定します。

• サイトは公開されている必要があります。
• 読み込みに JavaScript を必要とするサイトはサポートされません。

外部サイトを設定する際は、以下のフィルタリング構文を使用できます。

• ドメインレベルのフィルタリング
  • example.com: example.com ドメインのみを検索
  • docs.example.com: docs.example.com サブドメインのみを検索
  • *.example.com: example.com のすべてのサブドメインを検索
• パスレベルのフィルタリング
  • docs.example.com/api: /api サブパス配下のすべてのページを検索
• 複数パターン
  • 複数のエントリを追加して、サイト内の異なるセクションを対象にします

料金上限

メッセージの許容量に達した場合の挙動を管理するために、料金上限を設定します。既定では、許容量に達してもアシスタントはユーザーの質問に回答し続けるため、超過料金が発生します。

Assistant Configurations ページの Billing タブで、許容量超過分のアシスタントメッセージに対する料金上限を設定できます。料金上限に達すると、メッセージの許容量がリセットされるまでアシスタントは無効化されます。

また、料金上限の一定割合に達した際にメール通知を受け取れる使用量アラートも設定できます。

アシスタントの使い方

ユーザーは次の3つの方法でアシスタントにアクセスできます：

• キーボードショートカット：? または Command + I（Windowsでは Ctrl + I）
• 検索バー横のアシスタントボタン
• ページ読み込み時にアシスタントを開くには、末尾に ?assistant=open を付けたURLを使用します。例：https://mintlify.com/docs?assistant=open

いずれの方法でも、ドキュメントの右側にチャットパネルが開きます。ユーザーは自由に質問でき、アシスタントは回答のためにドキュメント内を検索します。関連情報が見つからない場合は、回答できない旨を返します。

コンテンツをAIが取り込みやすくする

アシスタントが正確で関連性の高い回答を返せるよう、ドキュメントを適切に構造化しましょう。明確な整理と十分なコンテキストは、人間の読者にもAIの理解にも有益です。

構造と整理

• セマンティックなマークアップを使う。
• セクションにわかりやすい見出しを付ける。
• 論理的な情報階層を設計する。
• ドキュメント全体で一貫した書式を保つ。
• ページのフロントマターに十分なメタデータを含める。
• 長い文章は短い段落に分割する。

コンテキスト

• 初出時に用語や頭字語を定義する。
• 機能や手順について十分な概念的な説明を提供する。
• 例やユースケースを含める。
• 関連トピックを相互参照する。
• ユーザーには不要だがアシスタントが参照できる追加コンテキストとして、非表示ページを追加する。

クエリのエクスポートと分析

ダッシュボードでクエリを確認・エクスポートし、ユーザーがドキュメントをどのように利用しているかを把握して、改善の機会を見つけましょう。クエリ分析がドキュメント改善に役立つ例:

• 頻出クエリに十分な回答ができていない領域（コンテンツギャップ）を特定する。
• クエリのテーマやパターンから、ユーザー行動や共通の情報ニーズの傾向を見つける。
• トラフィックの多いページを優先して、正確性と品質を改善する。

ダッシュボードからクエリを閲覧できますが、より強力なインサイトを得るには、好みのAIツールで分析できるように、クエリ・レスポンス・ソースを含むCSVファイルのエクスポートをおすすめします。

1. ダッシュボードのアシスタントページに移動します。
2. Export to CSVを選択します。
3. エクスポートしたデータを好みのツールで分析します。

サンプルの分析プロンプト

• クエリの最も一般的なテーマを要約してください。
• 出典が引用されていないクエリをすべて列挙してください。
• 失敗したやり取りのパターンを見つけてください。