AI検索
読者が平易な言葉で質問でき、ドキュメントから得た回答と、その根拠となったページへのリンクを表示できます。
2026年11月19日更新
AI検索は、サイトにAsk AIを追加します。ドキュメントの横にチャットが表示され、読者が質問すると、Typemarkが公開済みのドキュメントから回答し、使用したページを一覧で示します。続けて追加の質問もできます。Pro プランと Enterprise プランで利用できます。
有効にする
Settings > Reader features に移動し、AI search をオンにします。検索機能もオンにしておく必要があります。オフのままでは、読者に Ask AI は表示されません。
typemark.json では次のように設定します。
"features": {
"search": true,
"ai_search": true
}
有効かどうかを決めるのはプロジェクトオーナーのプランです。これにより、チーム全員が同じサイトを見られます。Free プランでは、トグルに Pro バッジが表示され、読者には Ask AI が表示されません。
読者に表示される内容
ヘッダーの Ask AI を押すと、ページの右側にチャットパネルが開きます。スマートフォンでは画面全体に表示されます。
- 回答は順次表示され、その下に Sources として、回答の根拠になったページの一覧が表示されます。各ソースは該当ページにリンクしており、回答内で引用されたページタイトルもリンクになっています。
- 「Windowsではどうですか?」のように、読者は追加の質問をできます。Typemarkは直近の数回分の質問と回答を覚えています。
- 回答の生成中は Stop で停止できます。New chat を押すと、新しく始められます。
- 引用されたページを開いても会話は保持されるため、読者はページを読んでから質問を続けられます。
- Esc キーまたは閉じるボタンでパネルを閉じます。
検索から始めることもできます。検索ダイアログの下部にある Ask AI の行を選ぶと、入力した内容がそのままパネルに渡されます。Cmd+Enter(Windows では Ctrl+Enter)でも、ダイアログ内のどこからでも同じ操作ができます。スマートフォンでは、この方法で Ask AI を開きます。
質問は2文字以上500文字以内で入力できます。複数の言語に対応したサイトでは、Ask AI はデフォルトの言語の内容から回答します。プレビューデプロイでは Ask AI は利用できません。
回答の仕組み
該当するページを探す
Typemarkは質問をサイトの全文検索にかけ、最も一致する上位5ページを選びます。追加の質問の場合は、以前の質問に一致したページを加えて補います。
そのページの内容だけから回答する
モデルには、これらのページの本文が渡されます。モデルは、そのページだけを根拠に回答し、ページタイトルを引用し、回答が見つからない場合はその旨を伝えるよう指示されています。
ソースを表示する
回答が始まる前に、該当するページがソースとして表示されます。回答が不十分な場合でも、読者は確認先を得られます。
回答には公開済みのコンテンツが使われます。手動デプロイモードでは、未公開の編集内容は使用されません。
該当するページがない場合は、回答を出さず、読者に質問の言い換えを促します。
プライバシー
質問とページの本文は、OpenRouter を経由して AI モデルに送信されます。Typemarkは、プロンプトを保存せず、それを使ってモデルを学習しないモデルプロバイダーにのみ送信します。
制限
| 制限 | 動作 |
|---|---|
| 読者1人につき1分間に10回の質問 | それ以上の質問には「1分後にもう一度お試しください」と表示されます。 |
| サイトごとに1日300回のAI回答 | 読者には一致したページが引き続き表示され、その日はAI回答が一時停止されている旨が表示されます。翌日に回答が再開されます。 |
| オーナーのすべてのサイトで合計1日500回のAI回答 | 各サイトで同様の動作になります。翌日に回答が再開されます。 |
| 1回の回答につき30秒 | 読者には、より簡単な質問を試すよう案内されます。 |
より良い回答を得るためのヒント
- 各ページに、わかりやすい
titleとdescriptionを設定しましょう。どちらも検索対象になるため、適切なページが上位に表示されやすくなります。 - 読者が使う言葉を使いましょう。検索は単語単位で一致するため、「API keys」について書かれたページでも、本文に明記されていなければ「access tokens」では見つかりません。
- ページは内容を絞りましょう。各ソースページから取り込まれる本文量には上限があるため、長い1ページより、1ページ1トピックの方が効果的です。