Observra Agent テレメトリの始め方
ガイド
AIエージェントのコードを書き換えることなく、モデル呼び出し、ツールの動作、コスト、エラーを収集するためのステップバイステップガイド
既存の人工知能エージェントにテレメトリを追加するには、モデルの呼び出し、ツールの呼び出し、コスト、エラーをキャプチャし、それらを1つの正規化されたイベント形式でローカルファイル、Webhook、OpenTelemetryコレクター、またはSIEMに転送するフレームワークアダプターを接続します。
AIエージェントは、モデルを呼び出し、ツールを使用し、独自に意思決定を行います。セッションのコストが突然通常の10倍に跳ね上がった場合や、エージェントが同じツールを繰り返し呼び出した場合、あるいはユーザーから予期せぬ動作が報告された場合、ほとんどのチームには何が起きたのかを示す信頼できる記録がありません。そのような記録がなければ、エージェントの活動をデバッグしたり、監査したり、調査したりすることはできません。
このクイックスタートガイドでは、Exabeamがスポンサーを務めるオープンソースの Python SDK「Observra」をインストールし、Google Agent Development Kit (ADK)、Claude Agent SDK、OpenAI Agents SDK、LangChain、LangGraph、または Pydantic AI に接続する方法を、3つのステップで解説します。 その後、最初のテレメトリデータを確認し、データの送信先を選択します。
このガイドが役立つ主な質問
- 既存の人工知能エージェントにテレメトリ機能を追加する前に、何が必要ですか？
- エージェントのロジックを変更せずに、Observraをエージェントフレームワークに接続するにはどうすればよいでしょうか？
- トークンの数からコストに至るまで、単一のエージェントのテレメトリイベントにはどのような情報が含まれているのでしょうか？
- 1つの共通イベント構造で、あらゆるフレームワークにおいてダッシュボード、アラート、クエリを正常に機能させるにはどうすればよいでしょうか？
- コスト追跡、デフォルトの黒塗り処理、プロンプト挿入シグナルなど、どの制御機能が自動的に適用されますか？
- 同じテレメトリデータを、ローカルファイル、Webhook、OpenTelemetryコレクター、またはSIEMのいずれかに送信するにはどうすればよいですか？
Observraがお客様のセキュリティおよび可観測性スタックにどのように適合するか
Observraは、各フレームワークがすでに提供しているコールバックや計測機能を通じてエージェントのアクティビティを収集し、それを単一のCommon Information Model（CIM）イベント形式に変換します。 すべてのバックエンドは、同じイベントオブジェクトを受け取ります。ローカルのJSON Linesファイルから開始し、OpenTelemetryを介してDynatrace、Grafana、Honeycomb、New Relicなどのプラットフォームにエクスポートしたり、対応するエクストラをインストールすることでExabeamにイベントを直接送信したりできます。送信先は設定で変更でき、アプリケーションコードを変更する必要はありません。
ガイドをダウンロードして、最初のAIエージェントでObservraを稼働させましょう。
