コンテキスト参照 — 正確な引用

Hermes Agent シリーズへようこそ！今日は、エージェントを劇的に便利にする機能について深掘りします。それがコンテキスト参照です。エージェントが情報を取得した正確な場所を指し示せたらいいのに——まるで学術論文の引用のように——と思ったことがあるなら、この機能はまさにあなたのためのものです。

コンテキスト参照とは？

コンテキスト参照は、本の脚注のようなものだと考えてください。エージェントがドキュメント、会話、ファイルを処理するとき、特定の情報がどこから来たのかを記憶できるようになります。「空は青い」と言うだけでなく、「空は青い（weather_report.md の42行目より）」と言えるのです。

これは以下のような場面でゲームチェンジャーになります：

リサーチタスク — 情報源を即座に検証
コードレビュー — バグがどこで混入したかを追跡
法務・コンプライアンス業務 — 事実の出所を証明
長い会話 — 重要な詳細がどのメッセージに含まれていたかを記憶

仕組み

魔法は舞台裏で起こります。エージェントにドキュメント、チャット履歴、ファイルを渡すと、Hermes は自動的に各コンテンツの出所を追跡します。特別な操作は一切不要で、自動で機能します。

簡単な例を見てみましょう：

hermes chat --with file:contract.pdf

「解約条項は何ですか？」と質問すると、エージェントはPDFの該当セクションを指し示す引用付きで回答します。

新しい設定オプション

最新アップデートでは、コンテキスト参照の動作を制御する強力な新しい方法が追加されました。これらはすべて ~/.hermes/config.yaml ファイルに記述します。

有効化と無効化

デフォルトでは、コンテキスト参照はファイルベースのコンテンツに対してオンになっています。ただし、セッションごとに制御できます：

context_references:
  enabled: true              # マスタースイッチ
  include_line_numbers: true # 引用に行番号を追加
  max_citations: 5           # レスポンスあたりの参照数の上限

引用フォーマット

レスポンス内での引用の表示形式を選択できます：

context_references:
  format: markdown  # オプション: markdown, plain, json

markdown — [source: file.md, line 12]（チャットUIで綺麗に表示）
plain — (file.md:12)（コンパクトでターミナル向け）
json — プログラムでの利用に適した構造化出力

セッションでの活用

コンテキスト参照は長時間のセッションで真価を発揮します。エージェントは、どのメッセージでどの事実が導入されたかを、数時間後でも覚えています：

hermes chat --session research-project

「さっき価格について学んだことは何でしたっけ？」と質問すると、2時間前の正確なメッセージを指し示す引用付きで回答が得られます。

実践的なヒント

1. 説明的なファイル名を使う

引用にはファイル名が含まれるので、意味のある名前にしましょう：

hermes chat --with docs/Q3-financial-report.md

file1.txt よりずっといいですよね？

2. メモリと組み合わせる

コンテキスト参照は Hermes のメモリシステムと美しく連携します。エージェントが何かを memories/ に保存するとき、その出所も一緒に記録されます。後でそのメモリを呼び出すとき、情報が元々どこから来たのかを教えてくれます。

3. 設定を確認する

Hermes をアップデートした後は、以下を実行してください：

hermes config check
hermes config migrate

これにより、最新のオプションがすべて利用可能になります。

簡単な例

実際の動作を見てみましょう：

hermes chat --with ~/notes/meeting-notes.md

あなた： 「合意したアクションアイテムは何でしたっけ？」

エージェント： 「ミーティングノートに基づくと、以下のアクションに合意しました：

Q3予算の確定（meeting-notes.md の15行目より）
クライアントデモのスケジュール設定（meeting-notes.md の22行目より）
プロジェクトタイムラインの更新（meeting-notes.md の28行目より）」

各項目に独自の引用が付いているのがわかりますか？それがコンテキスト参照の仕事です。

設定の優先順位の注意点

設定は以下の順序で解決されることを覚えておいてください：

CLI引数 — 最優先
config.yaml — メインの設定ファイル
.env — シークレットのみ
組み込みデフォルト — フォールバック

つまり、コマンドごとにコンテキスト参照の設定を上書きできます：

hermes chat --with file:report.pdf --set context_references.format=plain

まとめ

コンテキスト参照は、エージェントを「ブラックボックス」から、透明で検証可能なアシスタントへと変えます。リサーチ、コードのデバッグ、あるいは単にエージェントの回答をもっと信頼したい場合でも、この機能は証拠を提供してくれます。

自分のドキュメントで試してみて、すべての回答に出典が付くことでどれだけ自信が持てるかを実感してください。将来の自分——あの事実がどこから来たのか思い出そうとしている——が感謝することでしょう。

素敵な引用ライフを！🎯