Skip to main content
ハーネスとは、エージェントが実際に動作する環境のことです。Failproof AI は12種類のハーネスをサポートしており、2つのクラスに分類されます。
  • コーディングCLI（10種）— Claude Code、Codex、GitHub Copilot CLI、Cursor、OpenCode、Pi、Factory Droid、Devin CLI、Antigravity CLI、Goose
  • チャットおよびアシスタントゲートウェイ（2種）— Hermes（Slack、Telegram、cron）、OpenClaw（セルフホスト型アシスタント）
エージェントがどのハーネスで動作していても、同一のポリシーおよびセッション履歴が適用されます。アダプターレイヤーは、各ハーネスのネイティブイベント名・ツール名・ツール入力フィールドを、ポリシーが実行される前に29の標準イベントへとマッピングします。 12種類のいずれにも該当しないハーネスで動作するエージェントには、Python SDK を使って直接インスツルメンテーションを行います。これは異なる契約であり、明示しておく価値があります。SDKはトレーシング・セッション・評価・監査を提供しますが、それ自体でポリシーを適用するわけではありません。 実行前に安全でないアクションをブロックするには、ランタイムのツール境界に適用フックが必要です。お問い合わせいただければマッピングを行います。 各インテグレーションは、ポリシーが実行される前に、ネイティブのフックイベント名・ツール名・ツール入力フィールドを正規化します。ポリシーが作用できるのは、ハーネスが公開しているイベントのみです。ターン終了時や命令の動作については、実際にデプロイするハーネスとバージョンで必ずテストしてください。

​
適用機能

「ブロック」とは、現在のアダプターが返した判定が指定のハーネスによって消費されることを意味します。ツール実行後のブロックは、モデルに表示される結果を差し替えることはできますが、すでに発生したツールの副作用を取り消すことはできません。 機能はバージョンに依存します。特にポリシーがプロンプト・ストップ・パーミッション・ツール実行後の動作に依存している場合（共通のプリツールゲートではなく）、エージェントCLIをアップグレードした後は必ず再テストしてください。

​
キャプチャとポリシーフックのインストール

  1. 管理 → キー を開き、events:add および policies:pull 権限を持つキーを作成します。マシンまたは環境に合わせた名前を付けてください。
  2. 対象マシンで、表示されたキーを使ってローカルCLIを接続し、ハーネスフックをインストールします。
  3. 新しいエージェントセッションを開始し、観察 → イベント でフックとセッションのイベントを確認します。
  4. 同じ時間帯で 観察 → ポリシー を開き、そのマシンに帰属するポリシー決定を確認します。
接続はマシンキーから始まります。シークレットをコピーする前に、取り込みとポリシー配信の両方の権限が含まれていることを確認してください。イベント取り込みおよびポリシー配信権限を付与するための新規APIキードロワー。フックをインストールすると、接続したマシンと環境から新しいイベントがイベントストリームに表示されるはずです。新しくインストールされたハーネスがレポートしていることを確認するためのライブイベントストリーム。最後に、ポリシー決定が同じマシンに帰属していることを確認します。これにより、ハーネスがトレースイベントだけでなくポリシーアクティビティも報告していることが確認できます。新しく接続されたハーネスからのポリシー決定を確認するためのポリシーページ。

​
デフォルト以外のセッションパスの追加

追加パスはクラウドではなく、マシン上に登録されます。追加後、観察 → セッション を開き、マシンの環境でフィルタリングして、新しいパスからのセッションが表示されることを確認します。セッションを開き、監査に使用する前にエージェント・ハーネス・イベントのタイムスタンプを確認してください。追加のキャプチャパスからデータを受信している環境でフィルタリングされたセッションリスト。
インストール後に新しいセッションを1つ実行してください。ロールアウトを拡大する前に、ライブイベントストリームと実際のポリシー決定の両方を確認してください。