イベントと設定

​

イベントの種類

• エージェントの開始・終了・一時停止・再開
• モデルのリクエストとレスポンス
• ツールの使用と結果
• フックのトリガーと完了
• 人間の待機・入力・一時停止・割り込み
• 明示的なエラー

​

イベントコントラクトの確認

• ダッシュボード
• CLI

1. Observe → Events を開きます。
2. 短い時間ウィンドウを設定し、環境・エージェント・イベントタイプでフィルタリングします。
3. イベントを選択して正規化されたフィールドと生のペイロードを確認し、セッションを開いて実行コンテキストを確認します。
4. ペアになっている所要時間が欠けている場合は、開始イベントと完了イベントが同じ相関IDを使用しているか確認してください。

Eventsストリームを使って、データを1つのエージェント実行に絞り込み、正規化されたイベントフィールドを確認します。次に、イベントからそのセッションへと追っていきます。トレースには、そのイベントの直前と直後に何が起きたかが示されており、ペイロードだけでは判断が難しい場合に役立ちます。ペアになったイベントや所要時間が欠けている場合は、両方のビューで相関IDとタイムスタンプを比較してください。

有効なフィルター値を確認した後、1つのセッションの完全なイベントペイロードを取得します：

fp list event_types
fp list envs
fp events --since 1h \
  --env production \
  --event-type tool_use,tool_result \
  --session-id <session-id> \
  --full

機械可読な形式で確認するには fp --json events ... --fields ts,event_type,session_id,payload を使用してください。

​

SDKの予約フィールド

​

ローカルの境界

• Failproof AI の状態は、明示的に設定が変更されない限り ~/.failproofai 以下に保存されます。
• failproofai-sdk はレガシーのベースディレクトリ上書き用として AGENTEYE_HOME を使用します。
• 環境ラベルはSDK設定または AGENTEYE_ENVIRONMENT を通じて設定できます。
• デーモンの認証情報はシークレットでない設定とは別に保存されます。

​

環境ラベルの変更

export AGENTEYE_ENVIRONMENT=production-us-east
failproofai config
failproofai config --status
fp sessions --since 1h --env production-us-east