Typemark Documentation

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 は利用できません。

回答の仕組み

  1. 該当するページを探す

    Typemarkは質問をサイトの全文検索にかけ、最も一致する上位5ページを選びます。追加の質問の場合は、以前の質問に一致したページを加えて補います。

  2. そのページの内容だけから回答する

    モデルには、これらのページの本文が渡されます。モデルは、そのページだけを根拠に回答し、ページタイトルを引用し、回答が見つからない場合はその旨を伝えるよう指示されています。

  3. ソースを表示する

    回答が始まる前に、該当するページがソースとして表示されます。回答が不十分な場合でも、読者は確認先を得られます。

回答には公開済みのコンテンツが使われます。手動デプロイモードでは、未公開の編集内容は使用されません。

該当するページがない場合は、回答を出さず、読者に質問の言い換えを促します。

プライバシー

質問とページの本文は、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トピックの方が効果的です。