Vercel Observability でエージェントセッションの追跡とデバッグが可能に
Vercel は、OpenTelemetry の設定不要でエージェントセッションの完全な追跡とデバッグを可能にする「Agent Runs」機能を Vercel Observability に追加し、開発者と非技術者の双方に対応する二重ビューを提供した。
キーポイント
OpenTelemetry 不要の即時観測性
複雑な設定なしでエージェントセッションのトリガー、実行時間、トークン使用量を即座に可視化でき、ランタイムエラーも失敗したステップと直接相関付けられる。
開発者と非技術者向けの二重ビュー
デバッグ用の「Developer mode(JSON/トークン詳細)」と監査用の「Business mode(平易な要約・機密情報の隠蔽)」の 2 つのモードで同一データを異なる視点から表示する。
柔軟なデータ保持ポリシー
プランに応じたデフォルト保持期間(Hobby:12 時間、Pro:1 日、Enterprise:3 日)に加え、Observability Plus を利用することで最大 30 日間まで拡張可能。
既存インフラとの連携
カスタムの OpenTelemetry バックエンドを使用しているチーム向けに、AI SDK スパンを Braintrust や Datadog などの外部ツールへエクスポートする機能も維持されている。
影響分析・編集コメントを表示
影響分析
この機能は、複雑化する AI エージェントの開発・運用において、観測性の確保という重大な課題を解決する画期的な進展です。特に、技術的な背景を持たない関係者もエージェントの挙動を検証できる仕組みは、AI プロジェクトのガバナンスと信頼性向上に直結し、企業導入の加速要因となるでしょう。
編集コメント
Vercel が提供するこの機能は、AI エージェント開発の「ブラックボックス化」を解消する重要なステップであり、特に非技術ステークホルダーとの対話を円滑にする点で実用価値が高い。
Agent Runs は、Vercel ダッシュボード内のすべてのエージェントセッションに対して、OpenTelemetry の設定を不要とした厳選された観測性ビューを eve プロジェクトに提供します。
Agent Runs タブでは、各セッションのトリガー、実行時間、トークン使用量を一目で確認できます。任意の実行をクリックして、会話内のすべてのターン、モデル呼び出し、ツール呼び出しを検査できます。以前は関数ログの中に埋もれて見つけられなかったランタイムエラーが、失敗したステップと関連付けられるようになりました。
2 つのビューが同じデータを読み込みます:
デベロッパーモード(デフォルト)では、エンジニアが障害をデバッグするために、生のツール名、入力・出力 JSON、およびステップごとのトークンカウントが表示されます。
ビジネスモードでは、ツール名が人間に読みやすい形に変換され、JSON は非表示となり、非技術的なレビュー担当者がエージェントの行動を検証できるように、平易な英語によるサマリーが生成されます。
実行データはデフォルトで暗号化されます。保持期間はプランに応じてスケーリングします:
Hobby: 12 時間
Pro: 1 日
Enterprise: 3 日
Pro および Enterprise チームは、Observability Plus を利用することで、保持期間を最大 30 日まで延長できます。
カスタムの OpenTelemetry バックエンドを使用しているチームも、agent/instrumentation.ts から AI SDK のスパンを Braintrust や Datadog などの任意の宛先にエクスポートし続けることができます。
プロジェクトで Agent Runs を開き、ドキュメントを読んでスタートしましょう。
原文を表示
Agent Runs gives eve projects a curated observability view for every agent session in the Vercel dashboard, with no OpenTelemetry setup required.
The Agent Runs tab surfaces the trigger, duration, and token usage for each session at a glance. Drill into any run to inspect every turn, model call, and tool call in the conversation. Runtime errors that previously vanished into function logs now correlate to the failing step.
Two views read the same data:
Developer mode (default) shows raw tool names, input and output JSON, and per-step token counts for engineers debugging a failure.
Business mode humanizes tool names, hides JSON, and generates a plain-English summary so a non-technical reviewer can audit what an agent did.
Run data is encrypted by default. Retention scales with plan:
Hobby: 12 hours
Pro: 1 day
Enterprise: 3 days
Pro and Enterprise teams can extend retention to 30 days with Observability Plus.
Teams using a custom OpenTelemetry backend can still export AI SDK spans from agent/instrumentation.ts to any destination, such as Braintrust or Datadog.
Open Agent Runs in your project and read the documentation to get started.
Read more
関連記事
今日のまとめ
AI日報で今日の重要ニュースをまとめ読み