Datadog MCP Serverによるコード実行

ドキュメント > Datadog MCP Server > Datadog MCP Serverによるコード実行

概要

Datadog MCP Serverのcode-execツールセットを使用すると、AIエージェントはAPIリクエストごとにツールを呼び出すのではなく、単一のDatadog MCP Serverツール呼び出しでDatadog APIに対してJavaScriptを作成および実行できます。エージェントが生成したコードは、Datadogが管理するサンドボックス内で実行されます。エージェントに送り返されるデータは、コードが返す値のみです。これにより、大規模なAPIレスポンスがモデルのコンテキストに含まれるのを防ぎます。

複数のDatadog製品にまたがる調査や、複数の呼び出しからのデータを結合、フィルタリング、または要約する必要がある調査には、コード実行を使用してください。例として、同じサービスおよび時間枠のエラーログとAPMレイテンシーを関連付けることが挙げられます。

なぜコード実行を使用するのか

コード実行がない場合、エラーが最も多いサービスにAPMレイテンシーデータを付与するよう指示されたエージェントは、サービスごとに個別のツール呼び出しを行う必要があります。また、結果を結合するために追加のターンも必要になります。それらの呼び出しやターンはそれぞれ、コンテキストウィンドウのスペースを消費します。

コード実行を使用すると、エージェントは同じ調査を単一のスクリプトとして表現できます。

特定の期間内にエラーログが最も多いサービスについてログをクエリします。
返された各サービスについて、レイテンシーデータのスパンをクエリします。
2つの結果セットを結合し、コンパクトなオブジェクトを返します。

Datadog MCP Serverがスクリプトを実行し、結合された結果のみを返します。エージェントは、サービスごとに1回ではなく、1回のツール呼び出しで調査を完了します。

利用可能なツール

code-execツールセットは以下を提供します。

execute_code: エージェントが作成したJavaScriptをサンドボックス内で実行し、構造化された結果を返します。権限とプロンプトの例については、MCP Server Tools リファレンスの execute_code を参照してください。
search_datadog_sdk: エージェントがスクリプトを作成するために利用可能な SDK 関数と API メソッドを検索します。MCP Server Tools リファレンスの search_datadog_sdk を参照してください。

生成されるコードは、公開されている Datadog API Client for TypeScript に基づく JavaScript です。

サンドボックスがアクセスできるもの

code-exec ツールセットによって実行されるコードは、ユーザーのアイデンティティを使用して Datadog API に対して実行されます。エージェントは、ユーザーがアクセス権を持つデータのみを読み取ることができます。その他のアクセス制限は以下の通りです。

サンドボックスは分離されています。スクリプトは、ローカルマシン、ファイルシステム、任意のネットワーク宛先、または Datadog の生の認証情報にアクセスできません。
サンドボックスは、読み取り専用の Datadog API 呼び出しのみを公開します。エージェントは execute_code を使用して、モニターの作成やダッシュボードの更新などの書き込みアクションを実行することはできません。
スクリプトから行われる API 呼び出しには、既存のロール権限が適用されます。データセットへのアクセス権がない場合、エージェントは execute_code を通じてもそのデータセットをクエリすることはできません。
生の API レスポンスは、スクリプトによる処理中、サンドボックス内に留まります。エージェントに送り返されるデータは、コードが返す値のみです。ログに保存されている顧客データなど、基盤となるデータが機密性の高いものである場合は、スクリプトが何を返すかを確認してください。