測定経路
1 回の完了した実行が再利用可能な分析契約になる
所有者が最終結果を知った後にのみ発行し、ダッシュボードまたは評価ワークフローがそれに依存する前に保存されたコントラクトを検証します。
- 1
実行が完了しました
アプリケーションは、最終ステータス、ツール、ハンドオフ、期間、トークン、コストを認識しています。
- 2
発行された契約
プロンプトやツールのペイロードをコピーせずに、境界付きフィールドと承認済みの識別子を送信します。
- 3
治具の検証済み
必要なタイプ、プライバシー フィールド、再試行、および 1 つの既知の代替結果を検査します。
- 4
分析の再利用
Power は、品質、信頼性、ユニット経済性 SQL を機能とリリースごとにレビューしました。
穀物
論理エージェントの実行ごとに 1 つの最終結果。
オーナー
製品の結果が決定された後のエージェント オーケストレーター
いつ発行するか
成功、失敗、キャンセル、または人間による引き継ぎが完了すると、最終的な処理となります。
フィールド契約
明示的なプライバシー境界を持つ型付きフィールド
運用クエリが既存のフィールド名とタイプに依存した後も、既存のフィールド名とタイプを安定した状態に保ちます。オプションのコンテキストは、特定の決定によって制限され、文書化され、正当化されたままにする必要があります。
| フィールド | 種類 | 必須 | プライバシー | 意味 |
|---|---|---|---|---|
| timestamp_utc | timestamp | yes | non-sensitive | 結果境界の UTC 時間。 |
| event_id | string | yes | non-sensitive | 重複排除に使用される安定した一意の識別子。 |
| release | string | yes | non-sensitive | イベントを発行したアプリケーションまたはサービスのバージョン。 |
| account_id | string | yes | pseudonymous | 安定した内部アカウント識別子。電子メールや名前ではありません。 |
| run_id | string | yes | pseudonymous | 承認されたステップレベルのイベントによって共有される安定した識別子。 |
| workflow | string | yes | non-sensitive | バージョン管理された製品のワークフローはエージェントによって処理されます。 |
| status | string | yes | non-sensitive | 成功、失敗、キャンセル、または human_handoff。 |
| tool_call_count | number | yes | non-sensitive | 論理実行でのツール呼び出しの合計数。 |
| estimated_cost_usd | number | no | non-sensitive | バージョン化されたプロバイダーの推定コスト割り当て。 |
| task_completed | boolean | yes | non-sensitive | 製品レベルの成功の定義を確認しました。 |
合成 JSON イベント
{
"timestamp_utc": "2026-07-29T09:29:40Z",
"event_id": "evt_agent_01",
"account_id": "acct_8f31",
"release": "2026.07.3",
"run_id": "run_f28c",
"workflow": "support_resolution_v3",
"status": "success",
"tool_call_count": 3,
"estimated_cost_usd": 0.021,
"task_completed": true
}プライバシーのレビュー
取り込む前に識別子を確認する
この例では合成識別子を使用します。仮名の値も個人データである可能性があり、レビュー フィールドによってビジネスまたはプロバイダーのコンテキストが公開される可能性があります。独自の同意、保持、アクセス、常駐、および削除の要件を適用します。
account_id: pseudonymousrun_id: pseudonymous
検証チェックリスト
ダッシュボードを構築する前に契約を証明する
- Send one known ai_agent_run_completed fixture after the documented outcome boundary.
- Verify all 9 required fields arrive with the documented types.
- 同じイベント識別子を再試行し、選択した重複排除動作を確認します。
- ワークフローがサポートしている場合は、制御された失敗または代替結果を送信します。
- 関連する SQL を固定ウィンドウで実行し、結果をフィクスチャと照合します。
よくある間違い
1 つの行を 1 つの永続的な結果と等しく保つ
- Emitting ai_agent_run_completed before agent orchestrator after the product outcome is determined knows the final outcome.
- 1 つのテーブルに複数の穀物を混ぜると、個数と割合が曖昧になります。
- 制御されたカテゴリを生の URL、ペイロード、プロンプト、またはエラー テキストに置き換えます。
- 保存されたクエリとダッシュボードがフィールド タイプに依存した後、その場でフィールド タイプを変更します。
- 文書化された調査、アクセス、保持の必要がない識別子の追加。
契約書を利用する
イベントをクエリして操作可能にする
関連契約
本番トラフィックの前にフィクスチャを送信する
ライブ ワークフローに接続する前に、無料の API キーを作成し、合成イベントを送信し、推論されたテーブルを検査します。