ソリューション概要
EMT BrAInはFlezi EMTの頭脳:持続的なエージェント作業の4つの失敗 — コンテキストの劣化、セッション記憶喪失、暗黙知の属人化、見通せない支出 — を解決する神経科学に着想を得たAIレイヤーであり、4つのモダナイゼーション戦略すべてにわたり300以上のスキル・60以上のエージェント・30以上のワークフローを支えます。
課題 — すべてのプロジェクトで繰り返される4つの失敗
AIコーディングエージェントは強力ですが、長時間にわたるセッションでは不安定になります — そして4つ目の失敗は、誰も測定していないものです。
| 失敗 | 発生する事象 | ビジネスへの影響 |
|---|---|---|
| コンテキストの劣化 | 生のツール出力がワーキングメモリを埋め尽くします — 30分の作業で、タスクに不要なデータでコンテキストウィンドウの40%以上を消費します。 | 精度が下がり、生産性向上なしにトークンコストが上昇します。 |
| セッション記憶喪失 | コンパクションや再起動のたびに記憶が消去されます — 意思決定、作業中のファイル、アクティブなタスクがすべて失われます。 | エンジニアはセッションを重ねるたびに同じコンテキストを説明し直します。 |
| 暗黙知の属人化 | スキル、ドメインパターン、アーキテクチャ上の意思決定は、人の頭の中や分散したファイルにあり、届ける仕組みがありません。 | すべてのセッションがゼロから始まります。 |
| 価値に対する見通しの欠如 | エージェントにいくらかかり、何を生み出し、その両者の関係が適切かを誰も説明できません — そのため、支出の根拠が個人の経験談頼みになります。 | AI予算を正当化、拡大、統制できません。 |
未解決のままでは: これらの失敗は、AIを生産性の増幅器ではなく、生産性を低下させる要因に変えてしまいます。
ソリューション — EMT BrAIn — 5つのモジュール
1つのアーキテクチャ、2つの製品:エンジニアのマシン上のEMT BrAIn Edge、組織全体のFlezi EMT Platform。
モジュールのハイライト
Cortex
モデルがコンテキストを見る前に行うフィルタリング、抑制、圧縮。コンテキスト予算を毎ターン確認:50%で警告 → 60%で注意喚起 → 70%でブロック。セッショントレース、分あたりの消費、コンテキスト健全性、価値を1つのデータセットから読み取り — 削減額は常にEMT自身のオーバーヘッドを差し引いて報告します。
Motor
すべての機能は、1つのインストールライフサイクルを持つプラグイン。実行時ポリシーゲートを12のフレームワークにマッピング、エラー時はフェイルクローズ。成果スコアリング、アンチパターン、実際の利用状況から新しいスキルを提案するスキルファインダー — 人はそれを承認します。セッション開始時には関連する2–3の機能だけが表示されます。
Memory
ツールイベントを観察事項に要約し、その後レッスン、クリスタルへと発展。BM25+ベクトル+グラフの融合検索を最初のプロンプト前に投入、オンデバイス埋め込みで — APIキー、ネットワーク呼び出し、トークン単位コストは不要です。<private>を除去し、パスルールをフック層で強制します。
Synapse
レイヤー1は決定論的:同じコミットを入力すれば、同じグラフを出力 — TS/JS/Java/Py/Go/C#のTree-sitter AST。レイヤー2はモデル支援:ラベルは注釈として保存され、解析済みの事実に混ぜ込まれません。すべてのエッジに来歴バッジ;数秒で影響を確認 — Xを呼び出すもの、Yを使うもの、リネームが影響するもの。
Stem
デフォルトはAnthropicへのパススルー;11のアップストリーム(p0–p10)とアップストリームごとの強制切替。7ベンダーの31モデルを、編集可能な1つの表で100万トークンあたりに価格設定。オンデバイスのペア — Kompressorと埋め込みモデル — はトークンごとのコストがありません。
EdgeとPlatform — マシン上で、そして組織全体で
ローカルとグローバルのコントロールプレーン
2つの制御階層があります:EMT BrAIn Edgeは各開発者のAIエージェントをローカルでオーケストレーションし、プラットフォームはすべてのインスタンスを、単一の制御・テレメトリ・カタログ同期チャンネル経由で監視します。
Flezi EMT Platform — グローバル・コントロールプレーン
-
可観測性ハブ
- セッションブラウザー(Nインスタンス)
- コスト+異常ダッシュボード
- 品質スコア
- スキルトポロジー
- エージェントフリート
-
自律型エージェント
- Motor(300以上のスキル)
- Stem(AI Studio)
- Memory(組織グラフ)
- Synapse(レガシー+モダン)
- Cortex(プログラム戦略)
開発者マシン — EMT BrAIn Edge · 個人/エージェント制御レイヤー
-
統合サーフェス
- フック(10種類)
- MCP stdio(5モジュール)
-
オーケストレーションされたAIエージェント
- Claude Code(本番稼働中 — stdio MCP+10フック)
- GitHub Copilot(対応中 — VS Code拡張フック)
- OpenAI Codex(計画中 — stdio MCP、フックは未定)
エージェントごとに個別に統合されます。ローカルは自律性とオフライン対応を維持し、プラットフォームはその上に組織全体の可視性を追加します。
モジュール詳細
BrAIn Cortex · コンテキスト、コスト、そしてセッションの価値
EMT BrAInの前頭前皮質であり、セッションにかかったコストとその価値に関するすべての数値を管理します。
パッシブ最適化
- モデルがコンテキストを見る前の3層。
- フィルタリング — キャッシュ安定化とシェルフィルタリングにより、バナー、進捗ノイズ、重複読み取りを除去します。
- 抑制 — サンドボックス実行と出力抑制により、長時間実行プロセスをエージェントループから除外します。
- 圧縮 — コード、検索、ログ、HTML、JSON、Markdownを、モデルに届く前に圧縮します。
- 削減額は常に、パイプライン層ごとにEMT自身のオーバーヘッドを差し引いて報告します。
支出と予算
- 利用量 — 任意の期間におけるトークン、コスト、キャッシュ分析、モデル/言語別内訳。
- コンテキスト予算 — 毎ターン確認:50%で警告 → 60%で注意喚起 → 70%でブロック。
- キャッシュのコスト効果 — プレフィックスキャッシュ割引を、EMT圧縮による削減額とは別に追跡します。
証跡と価値
- セッショントレース — すべてのセッションについて、モデル帰属、所要時間、アイドル時間、サイズ、コスト。
- セッション詳細 — 分あたりの消費、サブエージェントのトランスクリプト、リンクされたコミット、キャプチャされたメモリ。
- コンテキスト健全性 — 週別・ワークスペース別の利用率とコンパクションの挙動。
- 消費レポート — Stemカタログの価格に基づき、モデル別・トークン種別に支出を帰属。
- 価値 — 増幅効果、トレンド、セッション台帳、キャリブレーション — 同じセッションを価格化して表示します。
支出、証跡、価値は1つのデータセットから読み取られるため、3つのビューが互いに不一致になることはありません。
BrAIn Motor · エージェントにできることと、許可されること
インストールライフサイクルを備えたプラグインレジストリ、実行時のフレームワークマッピング済みガードレール、そして仕事が実際にどのように実践されているかを把握する機能です。
レジストリとデリバリー
すべてがプラグインです:ワークフロー → エージェント → スキル。解決(resolve)・リンク(link)・チェック(check)・削除(remove)という1つのライフサイクルでインストールされます。セマンティック・デリバリーで、セッション開始時には関連する2–3の機能だけが表示されます。プログレッシブ・ディスクロージャーは実績順に表示します。すべてのアーティファクトはMCPプロンプト経由のスラッシュコマンドとして公開されます。
ガードレール
12のフレームワークに対応(OWASP ASIおよびMCP Top 10、LLM Top 10、EU AI Act、NIST AI RMF、ISO 42001および27001、SOC 2、GDPR、NSA/CISA MCP、CIS v8.1、CSA ATF)。実行時ポリシーゲート、エラー時はフェイルクローズ — フェイルオープンはしません。すべての許可・レビュー・拒否が記録されます;免除にはチケットと有効期限が付きます。
実践と成果
機能ごとの成果(成功・失敗・部分成功 — トークンコスト、ツール呼び出し、エラー、所要時間とともに)、実践パターンとアンチパターンのスコアリング、そして人が承認する提案を行うスキルファインダー。
現在本番で提供:レジストリ、インストールライフサイクル、セマンティック・デリバリー、実行時ガードレール、ワークスペース横断分析。
BrAIn Memory · 長期保存とアクティブな想起
30日目は、1–29日目に得たすべての知見(意思決定、パターン、完了した作業)を引き継いだ状態で始まります — これらは指示しなくても自動的に記録されます。
キャプチャと統合
ツールイベントをローカルモデルにまとめて渡し、読みやすい観察事項に要約し、クリティカルパス外で非同期に実行します。繰り返し現れる観察事項を持続的なレッスンに昇格させ、その後レビューを経て結晶化します。
想起
最も関連性の高い過去の知識を、最初のプロンプト前にコンテキストへ投入します。レキシカル検索(BM25)、ベクトル意味検索、グラフ関係を統合し、画面上で出所を明示します。
構造的なプライバシー保護
<private>内のものは、観察事項の書き込み前にすべて除去されます;privacy_rulesのglobに一致するパスへの書き込みは恒久的にブロックされ、フック層で強制されます。すべての書き込みは監査可能です。
知識は、エンジニアが同期を選択するまで、それを生成したマシンに残ります。
BrAIn Synapse · 承認できる構造マップ
決定論的なコアと任意のモデル層があります — コンソールは両者を混同させません。
レイヤー1 — 決定論的
同じコミットを入力すれば、同じグラフを出力します。抽出、解決、コミュニティ、フロー、影響、レイヤリング違反を、オフラインかつ再現可能に処理します。TypeScript、JavaScript、Java、Python、Go、C#のTree-sitter AST。インクリメンタル:synapse_syncは変更されたファイルだけを再インデックスします。
レイヤー2 — モデル支援
ドメインラベル、フロー確認、ナラティブは、ノードをキーとする注釈として保存され、解析済みの事実としてグラフへ統合されることはありません。すべての注釈には、それが生成されたレイヤー1のフィンガープリントが付与されます。キーがない、ネットワークがない、またはリクエストが拒否された場合には、名前のないドメインが表示されます — 縮退してもエラーにはなりません。
すべてのエッジに来歴を付与
解析済み(構文から直接読み取られる)または推論済み(リゾルバールール:動的CALL、CICS XCTL、ORMバインディング — エッジの約18%)。バッジは5つすべての画面でエッジとともに表示され、各画面で同じ意味を持ちます。
セマンティック検索とBM25+ベクトルのハイブリッド検索により、証明されたものと提案されたものを曖昧にせず、意図に基づいてコードを見つけます。移行の承認の信頼性は、その根拠となる最も弱い事実を超えられません。
BrAIn Stem · 1つの料金表によるマルチモデル・ルーティング
Stemは、どのモデルがリクエストを処理するか、そしてそのコストを決定します — 11のアップストリーム、価格設定済みのマルチベンダーカタログ、2つのオンデバイスモデル。
主要モデル · ルーティング
デフォルトはパススルー(主要オプションはAnthropicへ直接送られ、すべての代替はオプトインです)。11のアップストリーム、p0–p10、それぞれに独自のAPIスタイルとトークンがあります。アップストリームごとの強制切替;オーバーフロー時には、まだアクティブな中で最も低い優先度に送られます。
モデルカタログ
31モデル、7ベンダー(Anthropic、OpenAI、Google、DeepSeek、Zhipu、Moonshot、Alibaba)を1つの表で管理し、100万トークンあたりに価格設定:入力、出力、キャッシュ読み取り、キャッシュ書き込み。モデルは「モデル」タブからのみプロバイダーにリンクされるため、価格とルートが不一致になることはありません。
サポートモデル · オンデバイス
Kompressor(model_int8.onnx)はCortex向けのプロンプト入力を圧縮します;埋め込みモデル(all-MiniLM-L6-v2、Q8、384次元)はMemory、レッスン、Synapseグラフを埋め込みます。重みはインストーラーがコピーするため(22.6MB)、検索時に外部から何もダウンロードしません。
オンデバイスのペアにはトークンごとのコストがありません。有償モデルは、カタログに記載された価格で選択したものを利用します。
結論: EMT BrAInは、持続的なAI支援作業の4つの失敗 — 簡潔なコンテキスト、永続的なメモリ、分散されたスキル、価格設定済みの証跡 — を、エンジニアのマシン上でまず解決し、必要なときに組織規模で、コードやデータを環境外へ出すことなく実現します。
ユーザーマニュアル
EMT BrAIn Edgeはバックグラウンドデーモンとブラウザダッシュボードをhttp://127.0.0.1:3737で実行し、Claude CodeにMCPサーバーとして接続します。
2つの要素が連携しています:
- ダッシュボード — ステータス確認、プラグインカタログ閲覧、トークン削減監視、設定管理のための読み取り専用コントロールパネル。
- MCPツール — Claude Code内で自然言語で呼び出す、スキル/バンドルのインストール、コンテキスト最適化、コードベースグラフの探索。
前提条件: このマシンにEMT BrAIn Edgeがインストール済みで、必要なチャンネル(FPTユーザーはstable、EMT内部開発者はcanary)であること — 以下のどのタブが“SOON”になるかは実行中のチャンネルで決まります。デーモンが稼働中で、Azure ADでサインイン済みであること。
まだインストールしていない場合は、インストールガイドタブに切り替えてください。
ダッシュボード概要
http://127.0.0.1:3737を開きます。レイアウト:モジュールレール(左アイコン)→ セカンダリメニュー(モジュール毎タブ)→ コンテンツエリア。
右上:ライト/ダークトグル、リフレッシュ、通知。左下:サインイン済みアカウント(緑ドット = デーモン起動中 + ログイン済み)、ビルドバージョン — EMT BrAIn Edge · v<version> · <channel>。
“SOON”とチャンネルについて
stableチャンネルでは開発中の機能が無効化され“SOON”バッジで表示されます。canaryチャンネル(EMT内部開発者)では同じ機能が有効です。
モジュール
以下の順序はアプリのモジュールレールと一致します。ステータス列はstableチャンネルでの状態です。canaryではチャンネル制御された項目はすべて有効になります。
Dashboard
| タブ | 機能 | ステータス |
|---|---|---|
| Usage | デーモンヘルス + トークン削減の概要 | 利用可能 |
Cortex — トークン最適化
Cortexはコンテキスト圧縮レイヤー — 圧縮プロキシを実行し削減をレポートします。
| タブ | 機能 | ステータス |
|---|---|---|
| About | Cortexの説明と圧縮の仕組み | 利用可能 |
| Token Optimization → Today / Historical | 本日の削減内訳と、時間経過に伴う推移 | 利用可能 |
| Runtime → Sessions / Sync & Queue | セッション履歴、フリート同期ステータス | 近日公開 |
Motor — エクステンションレイヤー(カタログ + インストール)
スキル、エージェント、ワークフロー、バンドルのカタログを閲覧可能。Claude CodeのMCPツールでインストール。
| タブ | 機能 | ステータス |
|---|---|---|
| Overview → About | 6つのサブシステム:プラグインカタログ、インストール&ライフサイクル、バージョンチェック、バンドル、シンボリックリンクマネージャー、観測 | 利用可能 |
| Catalog → Skills / Agents / Workflows / Bundles | タイプ毎にカタログを閲覧 | 利用可能 |
| Governance → Frameworks / Enforcement | コンプライアンスフレームワーク、ポリシー強制、監査ログ | 近日公開 |
Memory · Synapse · Stem — stableで近日公開
| モジュール | 機能 | ステータス |
|---|---|---|
| Memory | 長期メモリダッシュボード — セッション、メモリ、レッスン、グラフ、監査 | 近日公開 |
| Synapse | コードグラフエクスプローラー — リポジトリのインデックス、シンボル/呼び出し元/呼び出し先の探索、セマンティッククラスター | 近日公開 |
| Stem | ローカルモデルプロファイル + セットアップ(Ollamaバックエンド) | 近日公開 |
Diagnostic
バグ報告に添付するログを取得する場所です。
| タブ | 機能 | ステータス |
|---|---|---|
| Logs → Live Logs | デーモンから直接取得するランタイムログ | 利用可能 |
| Logs → Health | 詳細な診断ヘルスビュー | 近日公開 |
| Logs → Reports | アプリからログ / エラーレポートを直接送信 | 近日公開 |
Settings
| タブ | 機能 | ステータス |
|---|---|---|
| Config | 解決済みデーモン設定を表示 | 利用可能 |
| Projects | フリート同期の送信先プロジェクトを選択 | 近日公開 |
Claude Codeでの使用
ダッシュボードは閲覧用です。実際の作業はMCPツールを通じて行われ、Claude Code内で自然言語でトリガーされます:
- インストール/アップグレード後にClaude Codeを再起動。
- 利用可能なツールを確認 — “run brain_guide — show me the available emt-brain tools”
- プロジェクトをセットアップ — “set up this project with the foundation bundle”
- バンドル/スキルをインストール — “install the internal-sdd bundle for this project”
- アンインストール —
motor_uninstall(ID指定)。
emt-brain CLI
| コマンド | 目的 |
|---|---|
emt-brain start | エッジデーモンを起動しダッシュボードを開く |
emt-brain stop | デーモンを停止 |
emt-brain doctor | 診断 — エッジヘルス、認証ステータス、パス |
emt-brain init | ログイン時の自動起動を登録 |
emt-brain config show | ~/.flezi-emt/config.jsonの解決済み設定を表示 |
emt-brain proxy … | 圧縮プロキシを管理 |
emt-brain --version | バージョンを表示 |
FAQ
データはどこにある? ~/.flezi-emt/以下にすべて保存。アップグレード後も保持 — 再ログイン不要。
一部のタブに“SOON”と表示されるのは? stableチャンネル使用中で、その機能はまだリリースされていません。
“Connecting to the EMT Brain daemon…”が続く? 数秒お待ちください。続く場合は emt-brain doctor を実行してください。
インストールガイド
本ガイドはワンクリックインストーラーをカバーします — 推奨パスです。各ネイティブインストーラーは独自のNode.jsランタイムをバンドルしており、Node.jsやnpmは不要です。FPT企業ネットワークでの使用に適しています。
コントリビューター / 未対応プラットフォーム(Intel Mac、Linux arm64、WSL2)—
emt-brain-local-dev-quick-start.mdのnpm/手動パスを使用(deprecated、コントリビューターのみ保持)。
1. リリースチャンネルの選択
| チャンネル | 対象 | 得られるもの |
|---|---|---|
| Stable(デフォルト) | FPTチーム / 一般利用 | 検証済みのリリース。一部の機能は無効“SOON”表示。 |
| Canary | EMT内部開発者 | developmentブランチの最新ビルド。全機能有効。 |
2. OS毎にインストール
BrAIn Edgeダウンロードページを開きます
Windows (x64)
emt-brain-setup-win-x64.msiをダウンロードしてダブルクリック。ユーザー単位インストール — admin/UAC不要。- 完了ページで“Start EMT Brain in the background now”をチェック。
- デーモン起動後にダッシュボードが自動で開きます。
macOS (Apple Silicon)
curl -fsSL https://cdn.emt-platform.com/brain-edge/install-macos.sh | sh
canary用: curl -fsSL https://cdn.emt-platform.com/brain-edge/install-macos.sh | EMT_BRAIN_CHANNEL=canary sh
注意: Intel Macは未対応 — Apple Silicon (arm64) のみ。
Linux (x64)
# Debian/Ubuntu (.deb):
sudo dpkg -i emt-brain-setup-linux-x64.deb
# またはポータブルAppImage(root不要):
chmod +x emt-brain-setup-linux-x64.AppImage
./emt-brain-setup-linux-x64.AppImage
3. サインイン
- http://127.0.0.1:3737を開く。
- “Login with Azure AD”をクリック(Keycloak経由のMicrosoft Entra ID、OIDC PKCE)。
4. Claude Codeを再起動
emt-brain doctor # エッジヘルス、認証ステータス、パス
5. アップグレード
アップグレードは同じ ~/.flezi-emt フォルダを再利用 — 再ログイン不要。
| OS | アップグレード方法 |
|---|---|
| Windows | 新しい .msi をダウンロードしてダブルクリック。 |
| macOS | curl … | sh コマンドを再実行。 |
| Linux | 新しい .deb/.AppImage をダウンロードしてインストール。 |
6. アンインストール
| OS | アンインストール方法 |
|---|---|
| Windows |
設定 → アプリ → EMT Brain Edge → アンインストール。
またはアプリをそのすべてのデータと共に一括で削除する:
emt-brain uninstall --purge-user-data --yesアンインストーラーはデーモンとアプリのバックグラウンドプロセスをすべて自動的に停止します — 事前に何も終了する必要はありません。
|
| macOS |
次の手順に従ってください:
アプリを削除しただけでは、アプリはバックグラウンドで動き続けます — アイコンがなくなっても動き続けます。
|
| Linux | sudo dpkg -r emt-brain-edge または AppImage を削除。 |
アンインストール後もデータは残ります。 すべて削除するには、まずアプリを終了してから ~/.flezi-emt フォルダを削除してください:
rm -rf ~/.flezi-emt
Windows トレイに関する注意:アンインストーラーはトレイアプリを終了しますが、終了されたトレイアプリのアイコンは Windows が表示を更新するまでトレイに残ることがあります。アイコンにカーソルを合わせると消えます — 再起動は不要です。
7. インストールの確認
以下の3点がすべて満たされている必要があります。1つでも欠けている場合は下の8. トラブルシューティングを参照してください。
| 確認項目 | 確認場所 | 期待される状態 |
|---|---|---|
| MCP接続済み | Claude Codeで/mcpを実行 |
emt-brain-edgeがconnectedと表示(failed / needs authではない)。インストール後にClaude Codeを再起動していること。 |
| システムトレイのアイコン | トレイ:タスクバー右端(Windows)、メニューバー(macOS) | EMT BrAIn Edgeのアイコンがある — アプリ/デーモンが稼働中。クリックでダッシュボードを開きます。 |
| バージョンがインストールしたビルドと一致 | ダッシュボードのセカンダリメニューフッター、またはemt-brain --version |
EMT BrAIn Edge · v<version> · <channel>がインストールしたバージョンとチャンネルを示し、緑ドット(デーモン起動中 + サインイン済み)。警告ドットとversion mismatchは稼働中のビルドがインストール済みのものと異なることを意味します — アプリを再起動してください。 |
3点をまとめて確認するコマンド:
emt-brain doctor
8. トラブルシューティング
| 症状 | 対処 |
|---|---|
| “Connecting to daemon…”が続く | 約10秒待機; emt-brain start または emt-brain doctor を実行 |
| アプリの代わりにログイン画面 | Login with Azure ADをクリック。ループする場合は下の企業SSL修正を参照。 |
| Claude CodeでMCPツールが表示されない | Claude Codeを完全に終了して再起動し、brain_guideを実行。 |
| FPT企業SSL検査でTLSが破損 | NODE_TLS_REJECT_UNAUTHORIZED=0 または NODE_EXTRA_CA_CERTS をFPT CAバンドルPEMに設定。 |
9. 設定に関する注意
ANTHROPIC_BASE_URLに値がある間(すなわちClaude CodeがBrain Edgeのローカルproxy経由の間)は、compact sizeが意図的に200Kトークンに制限され、約80%(約160K)で圧縮が発動します。
compact sizeを自分で指定したい場合は、設定ファイルを開きます:
- macOS / Linux:
~/.claude/settings.json - Windows:
C:\Users\<ユーザー名>\.claude\settings.json
"env"ブロックでCLAUDE_CODE_AUTO_COMPACT_WINDOWを任意の値にし、ANTHROPIC_BASE_URLを空にします:
"CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "80",
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "200000",
"ANTHROPIC_BASE_URL": ""
新しいセッションから有効になります。
proxyがない場合、それに依存する機能は無効になります。
トレーニング — Webインターフェースでのトークン削減
時間: 約10分(任意) · 形式: 読み物としての資料 — ハンズオンはスキップ可 · 前提: 技術的知識不要。
本トレーニングで3つを習得します:
- 理解する — トークンが3つのレイヤー(フィルタリング、抑制、圧縮)でどのように節約されるか。
- 確認する —
http://127.0.0.1:3737/のEMT Brain Edgeダッシュボードですべての数値をブラウザで確認。 - スキルバンドルのインストール/アンインストール — Claudeに1文で指示。Motor › Bundlesで管理。
目標
| # | 習得する | 確認場所 |
|---|---|---|
| 1 | トークン追跡ページを開き、サインインする | Lab 0 |
| 2 | 3つのレイヤー(フィルタリング/抑制/圧縮)を自分の言葉で説明する | 第5章 |
| 3 | Token Optimizationページの各データブロックを読む | 第6章 |
| 4 | 全3レイヤーで削減を発生させ、UIで数値増加を確認 | Lab 1–4 |
| 5 | UIからデータをエクスポートしてチーム/管理報告に使用する | Lab 5 |
| 6 | foundationバンドルをClaudeに1文でインストール/アンインストール | Lab 6–7 |
準備
| # | 必要 | 確認方法 |
|---|---|---|
| 1 | Webページが開く | ブラウザで http://127.0.0.1:3737/ にアクセス — EMT BrAIn Edge UI が表示される |
| 2 | サインイン済み | 左下のアバターをクリック — 名前 + メールが表示(Not authenticatedではない) |
| 3 | Claude Codeを開く | 作業中の任意のプロジェクトでClaude Codeを開く |
トークン節約の3レイヤー
レイヤー1 — FILTRATION / フィルタリング
ClaudeがCLIコマンドを実行するたびに、結果がまずフィルタリングされます:バナー削除、ヒント削除、プログレスバー削除 — 実内容のみ保持。日々の反復コマンドで60–90%節約。
レイヤー2 — SUPPRESSION / 抑制
コマンド結果が長すぎる場合、システムはすべてをチャットに送りません。2つのタイプ:
- Output Mask — ツール出力 ≥ 約2,000文字 → マスクされ、短いラベルに置き換え。Claudeは必要時に取得可能。kompressorが圧縮できるより大きな出力は、コンテンツ種別でCompressionレイヤーに記録される — 1つの応答は常に1つのレイヤーのみで計上。
- Context Index — 複数タスクの質問 → システムが端末ですべて実行し、結果をインデックスし、回答のみをチャットに送信。
レイヤー3 — COMPRESSION / 圧縮
チャットに送る必要があるコンテンツ(JSON、ログ、コード、テキスト)は送信前に圧縮されます。会話が長くなると古いコンテンツも圧縮。サブタイプ:Data (JSON)、Text / Prose、Code / Diff、Logs、Kompressor (MCP)、Cache Hits (CCR)。
ラボ概要
8つのラボ、順次実行、読み物としての資料 — ハンズオンは任意。セットアップ:ブラウザで Today タブを片側に、Claude Codeをもう片側に配置。
Lab 0 — ベースライン記録
3レイヤーの開始数値を記録。
Todayタブを開く → Savings by Pipeline Layerブロックを探す → Filtration、Suppression、Compressionのトークン数をスコアカードに記録。
Lab 1 — FILTRATION
Filtrationバーを増加させる。
Claude Codeで3つの自然言語質問:未コミット変更の確認、srcのファイル一覧、テスト実行。12秒以内にFiltrationバーとRecent Eventsが更新されるのを確認。
Lab 2 — SUPPRESSION · Context Index
Context Indexのサブラインを増加させる。
Claudeに1つの複合質問を投げます。「プロジェクト状態を確認し、srcのファイルを列挙し、テストを実行 — 未コミットは何か、どのテストが失敗したか、どのディレクトリが最もファイルが多いかを教えて。」数百行の生データではなく、簡潔な3項目の回答を確認。
この行が動くのは、Claudeが cortex_execute / cortex_batch_execute ツール経由で実行した場合のみです。通常のシェルコマンドを選んだ場合、節約はFiltrationレイヤーに計上されます — どちらも正しい動作です。
Lab 3 — SUPPRESSION · Output Mask
長い出力がマスクされるのを確認。
Claudeに中程度のサイズのファイル(数KB、例: README.md やログの末尾)の読み取りを依頼。会話にマスクラベルが表示され、UIではOutput Maskラインが増加。非常に長く圧縮可能なファイル(例: package-lock.json)はCompressionレイヤーに入る — それがLab 4。
Lab 4 — COMPRESSION
Compressionバーを増加させる。
Claudeに大きく圧縮可能なテキストファイルの読み取りまたは分析を依頼 — ログファイルが最も確実です。Compressionバーと検出された種別のサブライン(└─ Logs、└─ Data (JSON)、└─ Code / Diff など)が増加し、Compression QualityとEMT Overheadカードが更新されます。
ローカル圧縮モデルの起動中は、その応答はOutput Maskに計上されます — もう一度依頼するとCompression行が現れます。
Lab 5 — HISTORICAL
スコアカードを確定し、レポートデータをエクスポート。
Lab 0のスコアカードの最終列を記入。Historicalタブに切り替え、30日間のトレンドを確認、Export CSVをクリック、ダウンロードしたファイルがUIと一致するか確認。
Lab 6 — MOTOR: バンドルインストール
1文でfoundationバンドルをインストール。
Claude Codeで: “Install the foundation bundle”。確認: Claudeがインストール済みアイテムを列挙し、Motor › BundlesのMembersテーブルと一致し、.claude/skills/ に新しいエントリが追加される。
Lab 7 — MOTOR: アンインストール & 再インストール
アンインストールして再インストール — 両方向とも安全。
Claude Codeで: “Uninstall the foundation bundle”。削除を確認。Lab 6と同じコマンドで再インストール。実験は安全です。
復習質問
- 3つのレイヤーの名前、色、1語の説明は?
- 今日の削減額を見るにはどこをクリック?
- Todayタブはどのくらいの頻度で自動更新?
[kompressor: output compressed…]— どのレイヤー、データは失われる?- 何もしていないのに数値が増加 — なぜ?
- 管理用に30日間のデータをエクスポートする方法は?
- foundationバンドルをインストールするにはClaudeに何を言う?
解答: 1) Filtration — フィルタリング、Suppression — 抑制、Compression — 圧縮。2) Cortex → Token Optimization → Today。3) 12秒毎、F5不要。4) Suppression(Output Mask)— データは失われない。5) 端末全体、全プロジェクト — 同じ端末の他のユーザー。6) Historicalタブ → Export CSV。7) “Install the foundation bundle” — バンドル詳細ページに文があります。
デモ
録画ウォークスルー:BrAIn Edgeのインストール、初回サインイン、ライブダッシュボードで3つの削減レイヤーの動きを確認します。