> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# インテグレーションとリファレンス
> 対応エージェントハーネス、SDK、CLI、HTTP API の接続方法。
エージェントがすでに動作している環境に最も近いインテグレーションを選択してください。
対応するコーディング・自律エージェント CLI 向けにフックをインストールします。
カスタムエージェントの障害を検出するためにトレースを計装し、ランタイムへの防止策の追加についてお問い合わせください。
ローカルプロジェクト、セッション、ポリシーアクティビティ、オフライン監査を確認します。
ローカルキャプチャ、フック、ポリシー、監査、配信、マシン状態を設定します。
Cloud のセッション、監査、Issues、アラート、キー、ユーザー、設定をクエリ・管理します。
FastAPI サービスを使って完了済みまたは非アクティブなセッションをスコアリングします。
ワークフロー固有の allow、instruct、deny の判定を作成・テストします。
顧客管理の Kubernetes クラスター上に Cloud コントロールプレーンをデプロイします。
自動生成された [HTTP API リファレンス](/ja/reference/http-api) は公開 `/v1` エンドポイント全体をカバーしています。手書きのページでは、複数のエンドポイントにまたがるワークフローや、その公開サーフェス外の管理インターフェースを使用するワークフローについて説明しています。
## エージェントを接続してデータを検証する
1. **Administration → Keys** を開き、`events:add` と `policies:pull` 権限を持つキーを作成してシークレットをコピーします。
2. 上記の対応するページを参照してインテグレーションを設定します。
3. **Observe → Events** を開いてイベントが届いていることを確認し、続いて **Observe → Sessions** でイベントが完全な実行として形成されていることを確認します。
4. インテグレーションの環境でフィルタリングし、監査に必要なモデル、ツール、エラー、ポリシーのフィールドが含まれているセッションを 1 つ確認します。
まずキードロワーから始めてください。選択した権限によって、マシンがイベントを送信し、Cloud 管理のポリシーを受信できるかどうかが決まります。
インテグレーションを接続したら、セッションリストを使用して、イベントが期待される環境で完全な実行としてグループ化されていることを確認してください。
インテグレーションが完了と見なす前にこれらのセッションの 1 つを開いてください。トレースには、監査に必要なモデル、ツール、エラー、ポリシーの証跡が含まれているはずです。
マシンキーを作成し、Failproof デーモンを接続して、最初のセッションを検証します。
```bash theme={null}
fp keys create agent-production \
--add events:add \
--add policies:pull
failproofai config \
--connect https://app.befailproof.ai \
--token
failproofai flush --wait
fp sessions --since 1h --env production
fp events --since 1h --env production --limit 20
```
別のツールで結果を利用する場合は `fp --json sessions ...` を使用してください。`--json`、`--org`、`--base-url` などのグローバルフラグはコマンドの前に指定する必要があります。
ローカルコマンドについては [Failproof AI CLI リファレンス](/ja/reference/failproof-cli) を、`fp` コマンドについては [Failproof Cloud CLI リファレンス](/ja/reference/cloud-cli#cli-commands) を参照してください。