Exécution de code avec le serveur MCP

Documentation > Datadog MCP Server > Exécution de code avec le serveur MCP

Présentation

L’ensemble d’outils code-exec du Datadog MCP Server permet à votre agent IA d’écrire et d’exécuter du JavaScript via les API Datadog en un seul appel d’outil MCP, au lieu d’un appel d’outil par requête API. Le code généré par l’agent s’exécute dans un bac à sable géré par Datadog. La seule donnée renvoyée à l’agent est la valeur que le code retourne. Cela permet d’éviter d’inclure les réponses API volumineuses dans le contexte du modèle.

Utilisez l’exécution de code pour les investigations qui couvrent plusieurs produits Datadog ou qui nécessitent que l’agent assemble, filtre ou résume des données issues de plusieurs appels. Un exemple est la corrélation des logs d’erreurs avec la latence APM pour le même service et la même fenêtre temporelle.

Pourquoi utiliser l’exécution de code

Sans exécution de code, un agent chargé d’enrichir les services générant le plus d’erreurs avec des données de latence APM nécessite un appel d’outil distinct pour chaque service. Il nécessite également des itérations supplémentaires pour combiner les résultats. Chacun de ces appels et itérations consomme de l’espace dans la fenêtre de contexte.

Avec l’exécution de code, l’agent exprime la même investigation sous la forme d’un script unique :

Interroger les logs pour les services ayant le plus grand nombre de logs d’erreurs dans une fenêtre temporelle.
Pour chaque service renvoyé, interroger les spans pour obtenir des données de latence.
Joindre les deux ensembles de résultats et renvoyer un objet compact.

Le serveur MCP exécute le script et renvoie uniquement le résultat joint. L’agent termine l’investigation en un seul appel d’outil au lieu d’un appel par service.

Outils disponibles

L’ensemble d’outils code-exec fournit :

execute_code : Exécute du JavaScript rédigé par l’agent dans le bac à sable et renvoie un résultat structuré. Consultez execute_code dans la référence des outils du serveur MCP pour les autorisations et des exemples d’invites.
search_datadog_sdk : Recherche les fonctions SDK et les méthodes d’API disponibles pour l’agent afin d’écrire des scripts. Consultez search_datadog_sdk dans la référence des outils du serveur MCP.

Le code généré est du JavaScript basé sur le client Datadog API pour TypeScript public.

Ce à quoi le bac à sable peut accéder

Le code exécuté par l’ensemble d’outils code-exec s’exécute sur les API Datadog en utilisant votre identité utilisateur. Un agent ne peut lire que les données auxquelles vous avez l’autorisation d’accéder. Les autres limitations d’accès incluent :

Le bac à sable est isolé. Les scripts ne peuvent pas accéder à votre machine locale, au système de fichiers, à des destinations réseau arbitraires ou à des identifiants Datadog bruts.
Le bac à sable n’expose que des appels de Datadog API en lecture seule. Un agent ne peut pas utiliser execute_code pour effectuer des actions d’écriture, telles que la création d’un monitor ou la mise à jour d’un dashboard.
Les appels d’API effectués à partir d’un script appliquent vos autorisations de rôle existantes. Si vous n’avez pas accès à un jeu de données, l’agent ne peut pas non plus l’interroger via execute_code.
Les réponses d’API brutes restent dans le bac à sable pendant que le script les traite. La seule donnée renvoyée à l’agent est la valeur que le code retourne. Examinez ce qu’un script renvoie si les données sous-jacentes sont sensibles, comme des données client stockées dans des logs.

Activer l’exécution de code

Pour activer l’exécution de code, incluez code-exec dans le paramètre de requête toolsets lorsque vous connectez votre client IA au Datadog MCP Server. Consultez Configurer Datadog MCP Server pour des instructions de connexion spécifiques au client.

Par exemple, en fonction de votre site Datadog sélectionné (), cette URL active l’ensemble d’outils principal ainsi que l’exécution de code :

?toolsets=core,code-exec

code-exec est inclus dans toolsets=all, vous n’avez donc pas besoin de l’ajouter séparément si vous activez déjà tous les ensembles d’outils généralement disponibles.