0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

AIエージェントのRAG精度を最大化する Obsidian Vault メタデータ・構造化ルール

0
Posted at

はじめに

Obsidian をセカンドブレイン(第二の脳)として運用し、AIエージェント(LLM)にその知識を検索・参照(RAG: Retrieval-Augmented Generation)させる取り組みが増えています。

しかし、人間にとって読みやすいだけの非構造化されたノート群は、LLMが検索する際にベクトル類似度検索(Vector Search)やキーワード検索の精度を低下させ、不要なトークン消費やハルシネーション(誤情報生成)の原因となります。

本記事では、AIエージェントがセカンドブレイン内を高速かつ的確に参照・検索・更新できるように最適化された 「RAGフレンドリーな Vault 構造化ルール」(命名規則・YAML Frontmatter・WikiLink・アトミックノート設計)を解説します。


1. RAG 精度を阻害する4大要因

  1. 曖昧なファイル名: メモ1.md無題.md など、ファイル名からトピックが推測できないノート。
  2. メタデータの不全: 作成日時、ノートの種類(一次資料・要約・議論・成果物)、既読状態が不明なノート。
  3. 巨大な肥大化ノート: 複数のトピックが長文で詰め込まれたノート(LLMのコンテキストウィンドウを圧迫し、チャンク分割時に文脈が断片化する)。
  4. 孤立ノート (Orphan Notes): どのノートからもリンクされておらず、グラフレインにおける知識の関連性が追えないノート。

2. 検索優先(Retrieval-First)命名規則

すべてのノートは、原則として YYYY-MM-DD_[kind]_[topic].md 形式の統一フォーマットに従います。

kind(ノート種別)の標準一覧

kind 意味 対象ディレクトリの例
dash ダッシュボード / MOC (Map of Content) 00_Dashboard/
inbox 未処理の指示・発注メモ 01_Inbox/
agent エージェントの個別作業ログ・思考メモ 02_Agents/
mem 共通ルール・環境設定などの長期記憶 03_Shared_Memory/
raw 外部から収集した一次資料・生データ 04_Knowledge/Raw/
wiki 構造化された知識・要約ノート 04_Knowledge/Wiki/
comp 異分野統合知見ノート 08_Compound/

:

  • 2026-07-25_comp_human-freedom.md
  • 2026-07-20_wiki_ai-agents-operation-guide.md

この命名規則により、AIエージェントは正規表現(Grep / List Dir)のみでファイルの種類と作成時期・トピックを即座にフィルタリング可能です。


3. 標準 YAML Frontmatter の仕様

すべてのノートの先頭には、マシンリーダブルなメタデータとして以下のプロパティを必須記載します。

---
title: "ノートの正確で具体的なタイトル"
created_at: 2026-07-28
updated_at: 2026-07-28
type: dashboard | note | raw | compound
kind: dash | agent | wiki | comp | law | phil
status: raw | literature | permanent | compound | active
ingest_status: unread | processing | ingested  # Inbox / Raw ノートのみ
tags:
  - domain/topic
  - tech/category
aliases:
  - "別名や旧タイトル"
---

プロパティの活用メリット

  • status によるライフサイクル追跡: ノートが「生データ(raw)」か「精緻化された永続的知識(permanent)」かを判別し、AIが優先的にロードすべきノートを識別できます。
  • aliases による表記揺れ吸収: AIが検索クエリを発行する際、エイリアスが含まれていることでヒット率が向上します。

4. アトミックノート原則と WikiLink グラフレイン

1ノート1アイデア(Atomic Note)

RAG のチャンク分割(Chunking)において、1つのノートに複数の話題が混在していると、ベクトル空間上で無関係なコンテキストが混入します。1つのノートには1つの独立した概念・トピックのみを扱い、必要な長さにとどめます。

最低2本の WikiLink 接続ルール

新しく作成されたノートは、必ず既存の親ノート(MOCやダッシュボード)または関連する概念ノートへ 最低2本以上の WikiLink ([[YYYY-MM-DD_kind_topic]]) を接続します。

[[2026-07-20_dash_project-overview]] ──(親MOC)──► [ 新規作成ノート ]
                                                      │
[[2026-07-25_comp_architecture]] ──────(関連知見)──────┘

仮リンク(Forward Reference)の許容

未作成の概念であっても、将来的にアトミックノート化すべきキーワードには [[YYYY-MM-DD_kind_topic]] の形式で仮リンクを先行して貼ることを推奨します。定期的なヘルスチェックツールがこれを検知し、アトミックノートの作成を促します。


5. まとめ

Obsidian を AI エージェントのセカンドブレインとして活用するためには、人間側の配慮だけでなく、「AIが迷わず検索・判定できるメタデータ・構造化ルール」 の徹底が不可欠です。

  1. YYYY-MM-DD_[kind]_[topic].md による検索優先命名
  2. 標準 Frontmatter プロパティによる状態管理
  3. 1ノート1概念のアトミック化と WikiLink ネットワーク維持

この3原則を導入することで、RAG の検索精度とAIエージェントのパフォーマンスを飛躍的に向上させることができます。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?