add_dashboard_widget
Ajouter un widget à un dashboard.
Ajouter un widget à un dashboard.
Destructif · Écriture de données · Appelle des systèmes externes. Cet outil peut modifier ou supprimer des données. Vérifiez les arguments avant de laisser un agent l'appeler.
Paramètres
| Champ | Type | Requis | Description |
|---|---|---|---|
acknowledge | boolean | Non | Définir à true après que l'utilisateur approuve la poursuite au-delà de la limite d'édition. NE JAMAIS définir sans approbation explicite de l'utilisateur. |
dashboard_uid | string | Oui | UID du dashboard (depuis list_dashboards ou create_dashboard) |
h | number | Non | Hauteur en lignes de la grille. Omettre pour la valeur par défaut du type. |
preview | boolean | Non | Mode simulation : valide, normalise et positionne automatiquement sans PATCHer le dashboard ni consommer le budget d'édition. Renvoie la grille ASCII + données normalisées + avertissements. |
w | number | Non | Largeur en colonnes de la grille. Omettre pour la valeur par défaut du type. |
widget_json | string | Oui | Chaîne JSON de la section données du widget (depuis get_widget_template, remplie avec des valeurs réelles, sans _metadata) |
x | number | Non | Position x dans la grille (0-23). Omettre pour le positionnement automatique. |
y | number | Non | Position y dans la grille. Omettre pour le positionnement automatique (ajouté en bas). |
Exemple d'arguments
Arguments illustratifs qu'un agent fournit lors de l'appel de cet outil :
{
"dashboard_uid": "string",
"widget_json": "string"
}Description
Valide le widget, génère un identifiant unique, le positionne automatiquement et l'ajoute à la disposition du dashboard via PATCH.
Prérequis : utilisez query_metrics avec SHOW MEASUREMENTS et SHOW FIELD KEYS pour découvrir le schéma InfluxDB avant de construire les requêtes du widget. Les valeurs placeholder seront REJETÉES.
Workflow : get_widget_template → remplir avec des valeurs réelles → validate_widget → add_dashboard_widget → get_dashboard (vérifier).Associé
Et ensuite ?
Last updated on