
AIエージェント向けの改ざん防止監査証跡:ハッシュチェーン化されたRuntime Records、依存関係なし、誰でも検証可能
改ざん検知可能なAIエージェントの監査証跡 — ハッシュチェーンで連結されたRuntime Recordを、顧客自身が検証できるRuntime Reportとしてレンダリングします。
計測機構が捕捉するあらゆるアクション(ツール呼び出し、モデル呼び出し、データアクセス、承認)は、追記専用でハッシュチェーン化されたログ内の1つのRuntime Recordになります。Runtime Reportは、そのチェーンをHTMLページとしてレンダリングしたもので、読者のブラウザ内でハッシュチェーンを再計算し、検証済みのレコードから表示内容をレンダリングします(ページ自身のコードに依存しない検証を行うには、JSONLに対してhalo verifyを実行してください)。チェーンのチェックポイントを保持している者は誰でも、そのチェックポイントまでのレコードが取得以降に改変されていないことを、作成者を信頼することなく検証できます。このチェックポイントこそが要となる部分です。チェーン単体では、記録装置を運用する当事者以外の全員に対して改ざん検知可能です(LIMITS.md §1)。顧客のセキュリティチームが「あなたのエージェントは我々のデータで何をしたのか」と尋ねてきたとき、長い説明文の代わりにリンクを1つ渡せば済みます。セキュリティレビューではすでにSOC 2チェックリストの隣でAIに関する質問がなされており、さらに近年はISO 42001、EU AI Actの記録保持条項、顧客独自のアンケートからそうした質問が来るようになっています。今日のところは、書面による保証でもまだ通ります。このプロジェクトの背後にある賭けは、それが長くは続かないというものです。
「フォレンジックに20年携わると、証拠は相手側が検証できて初めて証拠になるということが身に染みてわかる……信頼を求めるAI製品ばかりの分野において、[Halo]は信頼を不要にするよう設計された稀有な存在だ。」
Johannes Stillig、Tidebreak AIの創業者兼CEO、某プライベート投資オフィスのグループCISO
Help Net Securityで紹介 · その週のShow HNローンチで上位4% · 5つのコントロールに対してAgentic Trust Controlsに掲載
レコード形式はオープンで、自由に実装できます。本パッケージはリファレンス実装です:レコーダー、検証ツール、ウィットネスクライアント、レポートサーバー。
halo-recordを使っていますか、導入を検討していますか? あなたが誰で、何のために使うのか教えてください → Who's using halo-record?
あなたはエージェント内にレコーダーを組み込むよう求められています。それを鵜呑みにするべきではありません:
pip install halo-record でインストールされるパッケージはちょうど1つだけです。halo serve --verify-email($HALO_SMTP_HOSTで設定したサーバー経由のSMTPで、ワンタイムコードとレポートのサブジェクト名を、レポート閲覧者が入力したアドレスに送信)。いずれも明示的に呼び出さない限り無効であり、その他のレコード内容があなたのインフラ外に出ることはありません。summaries=False)ではサマリーは一切保持されません。秘匿化はベストエフォートです(一般的なシークレットおよびPII形式に対する正規表現に加え、エントロピーによるキャッチオール)。防御の多層化として扱い、保証とは考えないでください。summary以外に指定した結果フィールドも同じパターンでスキャン・マスクされますが、200文字に切り詰められることはありません(LIMITS §13)。各レイヤーが証明するもの — このプロジェクトにおける最重要の区別(LIMITS.md §1):自分で保持するチェーンは、すでに誰かが保持しているヘッドを基準として、レコードが編集されていないことを証明します。運用者の外部で保持されるチェックポイントのみが、レコードが削除されていないことを証明します。そして、すべてのアクションが捕捉されたことを証明するハッシュは存在しません。
| 主張 | 自己保持チェーン | + 外部チェックポイント | + 信頼できる捕捉 |
|---|---|---|---|
| 確立済みアーティファクトへの編集を検出 | ✔ | ✔ | ✔ |
| コミット済み履歴の書き換えを検出 | — | ✔ | ✔ |
| 欠落/遅延チェックポイントを検出 | — | ✔(合意された頻度) | ✔ |
| すべてのアクションが記録されたことを証明 | — | — | 捕捉境界に依存 |
インストール前に実物を見る: サンプルのRuntime Report — 架空のデータ、本物のチェーン。開くと、そのスクリプトが埋め込まれたレコードのハッシュチェーンをブラウザ内で再計算します。
エージェントは不要です。uvがあれば、インストールするものは何もありません:
uvx --from halo-record halo demo --serve
または従来の方法:
pip install halo-record
halo demo --serve
いずれかを選ぶと、2社の顧客を持つ架空のサポートエージェントベンダーをスキャフォールドし、チェーンを目撃し(オペレーター外部の1つを代行するローカルwitnessファイルについてはLIMITS.md §1を参照)、ゲート付きのRuntime Reportsを配信し、ブラウザでオペレーターコンソールを開きます。次に改ざんテストを試してください:.jsonlファイルの1つから行を削除して再読み込みします。レポートがそれを検出します。
境界での1行:
from halo_record import trace
agent = trace(run_my_agent, profile="my-agent", log="audit.jsonl") # wraps your entrypoint; records the run boundary to ./audit.jsonl — add record_call() or a framework adapter at each tool boundary to capture individual calls
from halo import ... という便利なシムも同梱されていますが、PyPI 上の halo という名前は無関係なターミナルスピナーパッケージのものであり、そのパッケージがインストールされている場合はそちらがインポートされます。halo_record は曖昧さがないため、例ではこちらを使用しています。
log= を指定しない場合、レコードは ~/.halo/my-agent.jsonl に書き込まれます(エージェントごとに1つのチェーン)。ラッパーは実行境界を封止し、証拠は呼び出しごとのレコードに残ります。これらはフレームワークアダプター(下のマトリックス)で取得するか、明示的に取得します。後者は委任リンクの仕組みも示します:
from halo_record import Recorder, record_call
rec = Recorder("audit.jsonl")
with record_call(rec, "crm.lookup", {"account": "acct-9"}) as call: # one sealed record per tool call
call.result = crm.lookup("acct-9")
with record_call(rec, "payments.refund", {"amount": 120},
parent_id=rec.last_record_id()) as call: # child links to the action that spawned it
call.result = payments.refund(120)
次に、レポートをレンダリングします:
halo report audit.jsonl -o report.html # one chain -> HTML that re-verifies in the browser
halo serve ./records --port 8721 # all tenants, gated per customer
0.2.45 で最初に配信されたディレクトリをアップグレードする場合、halo serve は起動時に以前の各グラントを再読み込みします。レコードに subject id が含まれていないファイル(agent.jsonl のような単純な Recorder ファイル)に対するグラントは隔離され、起動のたびに、それを再発行する halo grant コマンドとともに出力されます — LIMITS.md §17, "Serving a directory first served by 0.2.45" を参照してください。
クイックスタートは、ブラウザで自分のエージェントの Runtime Report を表示した時点で終了します。JSONL ファイルだけが得られてレポートがない場合は、何かがおかしいので issue を開いてください。
ガードレールまたはポリシーレイヤーがアクションを検査した場合、その判定結果はレコードに付随させることができます — ゲートが何を決定したかを記録するオプションのブロックで、他のすべてのフィールドと同様にハッシュチェーンに封入されます:
from halo_record import build
build("tool_call", "security", tool="payments.refund",
verification={"status": "allowed", "verifier": "gate/1.2",
"policy_ref": "sha256:1f3a...",
"checked_at": "2026-08-01T12:00:00Z"})
命名に関する注意点が1つあります。パッケージは record 関数(デコレータ)をエクスポートしており、これがパッケージオブジェクト上の halo_record.record モジュールを隠蔽します。内部を利用したい場合は、import halo_record.record as record ではなく、モジュールパスから直接インポートしてください — from halo_record.record import build。
これは次のようにレコードに封入されます:
"verification": {"status": "allowed", "verifier": "gate/1.2", "policy_ref": "sha256:1f3a...", "checked_at": "2026-08-01T12:00:00Z"}
record_call(...) は同じ verification= キーワードを受け付けます。status はブロック内で必須であり、verifier、policy_ref、checked_at は任意です。各ステータスの意味は次のとおりです:
| ステータス | ゲートが報告する内容 | アクションは実行されたか? |
|---|---|---|
allowed | アクションを許可した | はい — アクションは続行された |
blocked | アクションを拒否した | 統合側によって決まるものであり、このフィールドによるものではない — レコードが結果を保持している場合もあり、ブロックだけでは未実行を証明できない |
modified | 実行前にアクションを変更した — action.input は変更後の、実行されたままのアクションを記述する | はい、変更された形で |
unverified | 実行された(または参照された)が、判定は下されなかった — ブロックが存在しない場合とは異なる。後者は検証の主張が一切なされなかったことを意味する | はい — アクションは判定なしで続行された |
このブロックはオペレーターの統合コードによって提供され、ゲートが述べたと報告する内容を記録します — principal と同じ信頼姿勢です(LIMITS を参照)。封印はステータスが事後に編集されていないことを証明しますが、チェックが実際に行われたこと、判定が正しかったこと、またはブロックされたアクションが実行されなかったことを証明するものではありません。これは独立した検証ではありません。
policy_ref を証拠として使用可能にするには、ルールセットのコンテンツハッシュを使用し、ルールセットの成果物を保持してください — 解決できないラベルはこのフィールドを飾りにするだけです。
| 境界でキャプチャ | 既存のテレメトリから取り込み |
|---|---|
ネイティブレコーダー(from halo_record import trace) | OpenTelemetry GenAI スパン |
| MCP インターセプター | LiteLLM コールバック |
| LangChain / LangGraph コールバック | Langfuse エクスポート |
| OpenAI Agents SDK フック | 任意のゲートウェイ / リバースプロキシログ |
| Claude Agent SDK フック | Claude Code および Codex CLI の PostToolUse フック(ツール実行後に発火) |
halo door によってバイヤー側で読み取られるプラットフォームログエクスポート(GitHub セキュリティログ、Salesforce Event Monitoring) |