API Metabase : fonctions disponibles et usage avec des agents IA
Metabase dispose d'une API REST qui permet d'exécuter des questions enregistrées, de lire des tableaux de bord, de gérer collections et utilisateurs, et d'automatiser l'administration de l'instance. Startups et équipes data qui veulent une BI accessible l'utilisent. L'instance appartenant en général au client, l'accès se fait avec ses propres identifiants.
Ce que propose l’API Metabase
Questions enregistrées (cards)
Exécution de requêtes enregistrées et retour des résultats dans un format structuré.
Tableaux de bord
Lecture des tableaux de bord et des cards qui les composent.
Collections
Organisation des questions et des tableaux de bord en collections, avec leurs permissions.
Requêtes
Exécution de requêtes sur les bases connectées, selon les permissions de l'utilisateur.
Utilisateurs et groupes
Gestion des utilisateurs, des groupes et des accès.
Alertes et abonnements
Envois périodiques de tableaux de bord et alertes sur condition.
Comment accéder à l’API Metabase
- Avec les identifiants de votre entrepriseClé d'API créée par l'administrateur (dans les versions récentes) ou session d'un utilisateur. Les permissions suivent le groupe associé à la clé.
- Préférez que l'agent utilise des questions enregistrées et relues plutôt que du SQL libre.
- Le groupe de la clé définit ce que l'agent voit : gardez-le restreint.
- Les instances internes exigent un accès réseau contrôlé.
Documentation officielle: www.metabase.com/docs/latest/api
Ce qu’un agent iTeam fait avec l’API Metabase
Le chiffre du jour dans la messagerie
Le responsable demande les ventes d'hier dans Slack. L'agent exécute la question enregistrée officielle et répond avec la valeur et le lien de la card.
Explication d'une variation
Quand un indicateur baisse, l'agent lance les découpages déjà définis et montre dans quel canal, quelle région ou quel produit la baisse se concentre.
Rapport pour ceux qui n'utilisent pas la BI
L'agent exécute les cards convenues et envoie chaque lundi une synthèse en texte à la direction.
Audit des accès
L'agent liste les utilisateurs inactifs et les groupes aux accès trop larges, pour que l'IT les passe en revue.
De l’identifiant à l’agent au travail, avec validation
Créer une clé ou un utilisateur de service
Dans Metabase, créez la clé d'API ou un utilisateur dédié, dans un groupe n'ayant accès qu'aux collections nécessaires.
Stocker dans le coffre-fort d'iTeam
Enregistrez l'identifiant et l'adresse de l'instance dans le coffre-fort. Si l'instance est interne, convenez avec l'IT de l'ouverture réseau.
Valider avec l'équipe data
Définissez les questions enregistrées que l'agent utilise et comparez les réponses au tableau de bord avant d'ouvrir l'accès.
Équipes IA prêtes à l’emploi qui utilisent Metabase
Questions sur l’API Metabase
L'API Metabase est-elle gratuite ?
Oui, l'API fait partie de Metabase, y compris dans la version open source. Certaines fonctions d'administration et de permissions avancées relèvent des éditions payantes.
Faut-il programmer pour utiliser l'API Metabase avec iTeam ?
Pas nécessairement. iTeam lit la documentation, et l'équipe de déploiement relie l'agent aux questions enregistrées que l'équipe data a validées.
La documentation de l'API est-elle stable ?
Metabase prévient lui-même que l'API peut changer d'une version à l'autre. Il vaut donc la peine de tester l'intégration à chaque mise à jour de l'instance.
