AIはDocsをどう読むか

このドキュメント（Meax Docs）は、人が読むためだけでなく、Meax AIが回答の根拠として参照する知識ベースでもあります。この記事では、その仕組みを説明します。

全体の流れ

1. すべてのMarkdown記事が、JSONのAPIとして公開されます。
2. Meax AIは、質問に関係する記述をこのAPIから検索します。
3. 見つかった抜粋を根拠にして、回答を生成します。

公開されているAPI

全記事は、次の形式で機械可読なJSONとして取得できます。

[
  {
    "title": "投票と質問箱",
    "category": "機能ガイド",
    "slug": "02-features/06-votes-and-questions",
    "content": "Markdown本文..."
  }
]

• title：記事のタイトル
• category：カテゴリ（はじめる / 機能ガイド / アカウント管理 / Meax AI など）
• slug：記事の一意なID（index.php?page=slugで開ける）
• content：Markdownの全文

検索のされ方

AIは、質問文から語を抽出し、各記事のタイトル・カテゴリ・本文を照合して関連度をつけます。

関連度が高い順に、質問の語が現れる付近が抜粋としてAIに渡されます。日本語の連続した語も、2文字のまとまりで部分一致させることで、分かち書きなしでも拾えるようにしています。結果は短時間キャッシュされ、Docsの更新は数分以内に反映されます。

書き方のコツ

Meax AIにより正確に読んでもらうには、次の点に注意して記事を書くと効果的です。

• 質問で使われそうな言葉をタイトルに入れる（例：「退会」「コイン」「認証バッジ」）
• 本文の冒頭で、その記事のテーマを一文で述べる
• 数値・制限は表や箇条書きで明示する
• 1記事1テーマに絞る

つまり、このDocsを丁寧に整えること自体が、Meax AIの回答品質を高めることになります。