クイックスタート

このクイックスタートでは、1台のマシンでセッションのレポートを開始し、監査を実行して、ポリシーを展開します。スキルを使って Failproof を設定するか、手動手順に従ってください。Node.js 20.9 以降が必要です。

スキルを使う
手動セットアップ

Failproof AI スキルをインストールする

npx skills add FailproofAI/skills

エージェントにすべてのセットアップを依頼する

Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives.

エージェントがプロジェクトを検査し、適切なインテグレーションを選択して、セットアップを実行し、動作を確認します。個別のスキルや高度なインストールオプションについては、FailproofAI スキルリポジトリを参照してください。

始める前に

Failproof AI ダッシュボードを開き、アカウントを作成するか、仕事用メールアドレスでサインインします。
Administration → Keys に移動し、events:add と policies:pull の権限を持つキーを作成します。
ワンタイムシークレットをコピーして、対象マシンに保存します。

export FAILPROOFAI_KEY="<one-time-secret>"

インストール

Failproof AI をインストールして接続する

npm install -g failproofai
failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY"

セッションのトランスクリプトはデフォルトで送信されます。トランスクリプトの内容を除いてフックのアクティビティとポリシーの決定のみをレポートするには、--no-transcripts を追加してください。このマシンにすでにエージェントの履歴がある場合は、過去7日間のデータをプレビューしてインポートし、配信が完了するまで待ちます。新しいマシンではこの手順をスキップしてください。

failproofai backfill --since 7d --dry-run
failproofai backfill --since 7d
failproofai flush --wait

Failproof AI で Sessions を開き、インポートされたセッションを選択します。

エージェントフックとポリシーをインストールする

これにより、Failproof AI がエージェント CLI に接続され、組み込みポリシーがインストールされます。Failproof AI がセッションを監査してエージェント向けのポリシーを作成する前に、ローカルでのポリシー決定を確認したり、適用をテストしたりするために活用してください。インストーラーにエージェント CLI を自動検出させるか、明示的に指定することもできます。

failproofai policies --install --cli claude --scope user

動作を監査する

初めての障害チェックを実行するに従ってください。「エージェントがアプローチを変えずに失敗したツールを再試行したセッションを見つける」など、具体的な目標を設定して行ってください。

障害を防止する

ポリシーで初めての障害を防止するに従ってください。オブザーブモードから始め、マッチしたものを確認してから、レビュー済みのバージョンを適用してください。

failproofai config --status を実行してください。正常なセットアップでは、クラウド接続、デーモンの状態、適用が一時停止中かどうかが報告されます。

​始める前に

​インストール

始める前に

インストール