用語集

プロジェクトの用語をアルファベット順に掲載します。各用語はコードベースで実際に使われている 通りに定義しています。詳細はリンク先のコンセプトページを参照してください。

捏造防止ガード

構造化チャネルが found のファクトを返さなかった場合に、回答を「見つかりません」へと書き換える オーケストレーターのステップ。プロンプトではなく制御フロー（agent/agent.py）で強制されます。 捏造防止 を参照してください。

チャンクストア

ナラティブ文書チャンクのための sqlite ベースのストア （retrieval/chunking/chunk_store.py）。各チャンクは doc_id + source_locator （NOT NULL）に加え、メタデータ（title、entity、period、sensitivity など）を保持します。 現在の行は、生成専用の small-to-big / ウィンドウ展開のために parent_id、heading、 window_text、parent_locator も永続化しています。

エコノミー検索モード

economy / bm25 / lexical のサービスプリセット。埋め込みバックエンドもベクトルストアも 構築せず、字句検索のみを実行します。

明確化ゲートウェイ

意図的な非対称性に基づいて、まず質問する（メトリックの欠落）、前提を明示したうえで回答する （エンティティ/期間の欠落）、拒否する（スコープ外エンティティ）のいずれかを決定するステップ （clarify_scope、agent/intent.py）。

複合（ルート）

数値的かつナラティブでもある質問（認識されたメトリック + ナラティブの手がかり）。 エージェントは構造化パスを実行したあと、ナラティブの帰属セクションを追記します。

二重チャネル

構造化数値パスとナラティブ RAG パスを決定的に実行し、複合質問の場合には比較・マージします。 二重チャネル を参照してください。

dim_key

ファクトの_アイデンティティ_を成す次元（metric、entity、channel、period）に対する、 正規化されたソート済み JSON の自然キー。ファクトストアにおける UNIQUE upsert の競合キーであり、 ストレージ専用で、書き込み時に再計算されます — Fact のフィールドになることは決してありません。

fact_metric

すべての構造化数値ファクトを保持する sqlite テーブル。メトリック × エンティティ × 期間 × チャネルごとに 1 行で、完全なリネージ（source_doc_id、source_locator）を伴います。 storage/fact_store.py が背後で支えています。

FAQ ショートサーキット

LLM をバイパスする、SME が精査した質問→回答キャッシュ（service/faq/）。捏造防止ガードの 前段に位置し、保守的な除外条件の背後に置かれています。 FAQ ショートサーキット を参照してください。

found / not_found / unrecognized_param

query_metric ツールが返す三値状態：値が存在する（found）、一致する行がない （not_found）、パラメータを統制コードへ正規化できなかった（unrecognized_param）。 構造化チャネルは決して推測を返しません。

用語集（同義語正規化）

中国語/英語/略語の同義語を、統制されたメトリック / エンティティ / 期間コードへと正規化する マッピング層（common/glossary.py）。認識できないものに対しては推測せず None を返します — 構造化チャネルへの入り口です。

ホームカンパニー / CompanyProfile

デプロイメント自身の会社アイデンティティ、メトリック、エンティティ、競合他社リストであり、 設定（config/company.example.toml）から読み込まれます。どの会社もどこにもハードコード されていません。「ACME」は架空のデモプロファイルにすぎません。

インテントスロット

インテントパーサーによって質問から抽出され、ルーティングとクエリに使用される 4 つの 解析済みスロット — metric、entity、period、channel（agent/intent.py）。

履歴ターン

answer_question(history=...) または /v1/ask に渡される (role, text) タプル。履歴は LLM の 生成コンテキスト専用であり、インテント/セキュリティの判定、検索クエリ、エビデンスからは 除外されます。

IR / StyledGrid

文書がファクトストアとチャンクストアへ取り込まれる前に抽出される、凍結された中間表現 （スタイルと色を認識）。

IntentParser（Protocol）

インテント抽出のためのプラガブルなシーム（ADR 0010）。デフォルトは LLM を一切使わない、 設定駆動の RuleIntentParser です。セキュリティはプラガブルではありません — セキュリティゲートは、パーサーとは独立に生の質問からスコープを再導出します。

リストワイズ再ランキング

上位候補を LLM ジャッジに送って関連度順に並べ替える、オプションの第 2 パスのリランカー （retrieval/rerank/listwise_rerank.py）。いかなる失敗時にも RRF の順序へフォールバック します。RESTRICTED の候補は決してジャッジのプロンプトに入りません。

MockProvider

決定的でオフラインな LLMProvider 実装（agent/llm_provider.py）。API キーなしでコアを 完全にオフラインで実行できます — デモとテストのデフォルトです。

ナラティブチャネル

「なぜ / 何が起きたのか」という質問のための RAG パス：ハイブリッド検索 → オプションの 再ランキング → 引用付きの合成。デフォルトのチェーンは純粋な BM25 + RRF です （ベクトルバックエンドは接続されていません）。

メタデータフィルタ

チャンクメタデータに対する、検証済みの絞り込み述語。サポートされる演算子は eq、ne、in、 nin、gt、gte、lt、lte、between で、フィルタリングは入力された結果の順序を保持します。

マルチインデックス検索

ライブラリごとの検索のあとに RRF 融合を行います。各結果は library_id の来歴を保持し、 ルーティングに失敗した場合は設定済みのすべてのライブラリへフォールバックします。

親子展開

子がランクと引用を決定し、永続化された親/ウィンドウのテキストが別個の生成専用 prompt_text になる small-to-big 検索。制限対象の子とそのウィンドウは一緒に破棄されます。

出典追跡

すべてのファクト、チャンク、回答が保持する source_doc_id（または doc_id）+ source_locator。エンドツーエンドで運ばれ、決して失われません。 出典追跡 を参照してください。

Protocol シーム

外部依存が注入される、型付きの Protocol 境界（LLM プロバイダ、埋め込みバックエンド、 リストワイズジャッジ、OCR バックエンド、ナラティブリトリーバー、タスクキュー）。 コアは SDK を一切 import せず、これらの抽象にのみ依存します。

プレビュープロトコル v1

バージョン、秘匿化されたノード/エッジ、決定的なジオメトリを含む、表示専用のワークフロー射影。 プロンプト、変数、プロバイダ、認証情報、実行可能な設定は一切含みません。

query_metric

構造化チャネルの function-calling ツール（agent/query_tools.py）。パラメータを用語集で 正規化し、fact_metric にクエリを発行し、リネージ付きの三値状態の結果を返します — 捏造された数値を返すことは決してありません。

Reciprocal Rank Fusion（RRF）

ハイブリッド検索において BM25 とベクトルのランキングを組み合わせるランク融合手法 （rrf_fuse、k=60）。各ランキングは、アイテムの融合スコアに 1 / (k + rank) を寄与します。

RESTRICTED 分離

RESTRICTED 階層のコンテンツがプロンプトに到達しうる前に、2 つの出口（retrieval/link と retrieval/rerank）で除去されるという不変条件。 RESTRICTED 分離 を参照してください。

レビューキュー

低信頼または競合のある取り込みアイテムのための、人間（SME）によるレビューキュー状態機械 （ingestion/review/）。非同期ジョブキューとは別物です。ファクトの review_status （例：pending、approved、rejected、blocked）がクエリでの可視性を制御します。

セキュリティゲート

決定的で、決してプラガブルにならないフロントドア（agent/security_gate.py、ADR 0010）。 最長一致によって外部/競合エンティティを検出し、同じ長さの空白でマスクし、あらゆるツール / リトリーバー / LLM 呼び出しに先立ってスコープ外の質問を拒否します。

機密度階層

チャンクごとの分類（common/sensitivity.py）：デフォルトは INTERNAL で、決定的かつ 設定駆動でフェイルセーフなシグナルによって RESTRICTED へエスカレートされます。

構造化チャネル

決定的な数値パス：用語集による正規化 → fact_metric ストアに対する query_metric → ファクト値からリネージ付きでレンダリングされた回答。数値を捏造することは決してありません。

ワークフローカタログ

ひな形生成コマンドとウェブサイトが使用する、パッケージ所有のテンプレート。7 個の厳選された ワークフローと、39 業種・27 ユースケース・5 つのアーキタイプにわたる 993 個の生成済み ディスクリプタを含みます。上流の Dify/n8n のページはあくまでソースメタデータであり、 そのワークフロー設定が再配布されたり、ランタイムにダウンロードされたりすることはありません。

ワークフローのひな形生成

カタログテンプレートを明示的に選択またはマッチングし、それ以外の場合は固定の Dify 0.6 start → llm → end グラフを生成する、純粋な設定操作。設定を返しますが、書き込みも実行も 行いません。安全なファイル出力は CLI が別途行います。