API de Metabase: qué se puede hacer y cómo usarla con agentes de IA
Metabase tiene una API REST que permite ejecutar preguntas guardadas, leer dashboards, gestionar colecciones y usuarios, y automatizar la administración de la instancia. La usan startups y equipos de datos que quieren un BI accesible. Como la instancia suele ser del propio cliente, el acceso se hace con las credenciales de esa instancia.
Qué ofrece la API de Metabase
Preguntas guardadas (cards)
Ejecución de consultas guardadas y devolución de los resultados en formato estructurado.
Dashboards
Lectura de dashboards y de las cards que los componen.
Colecciones
Organización de preguntas y dashboards en colecciones y permisos.
Consultas
Ejecución de consultas sobre las bases de datos conectadas, según los permisos del usuario.
Usuarios y grupos
Gestión de usuarios, grupos y accesos.
Alertas y suscripciones
Envíos periódicos de dashboards y alertas por condición.
Cómo acceder a la API de Metabase
- Con las credenciales de tu empresaUsa una clave de API creada por el administrador (en versiones recientes) o la sesión de un usuario. Los permisos siguen al grupo asociado a la clave.
- Prefiere que el agente use preguntas guardadas y revisadas en lugar de SQL libre.
- El grupo de la clave define lo que ve el agente: mantenlo restringido.
- Las instancias internas exigen un acceso de red controlado.
Documentación oficial: www.metabase.com/docs/latest/api
Qué hace un agente de iTeam con la API de Metabase
La cifra del día en el chat
El gerente pregunta por las ventas de ayer en Slack, y el agente ejecuta la pregunta guardada oficial y responde con el valor y el enlace de la card.
Explicación de una variación
Cuando un indicador cae, el agente ejecuta los cortes ya definidos y muestra en qué canal, región o producto se concentra la caída.
Informe para quien no usa BI
El agente ejecuta las cards acordadas y envía un resumen en texto a la dirección cada lunes.
Auditoría de accesos
El agente lista los usuarios inactivos y los grupos con un acceso amplio para que TI los revise.
De la credencial al agente trabajando, con aprobación
Crear una clave o un usuario de servicio
En Metabase, crea la clave de API o un usuario dedicado en un grupo con acceso solo a las colecciones necesarias.
Guardar en la bóveda de iTeam
Registra la credencial y la dirección de la instancia en la bóveda. Si la instancia es interna, coordina con TI la habilitación de red.
Validar con el equipo de datos
Define qué preguntas guardadas usa el agente y compara las respuestas con el dashboard antes de liberarlo.
Equipos de IA listos que usan Metabase
Preguntas sobre la API de Metabase
¿La API de Metabase es gratuita?
Sí, la API forma parte de Metabase, incluida la versión de código abierto. Algunos recursos de administración y de permisos avanzados son de las ediciones de pago.
¿Necesito programar para usar la API de Metabase con iTeam?
No necesariamente. iTeam lee la documentación y el equipo de implementación conecta al agente con las preguntas guardadas que el equipo de datos aprobó.
¿La documentación de la API es estable?
El propio Metabase advierte que la API puede cambiar entre versiones. Por eso conviene probar la integración con cada actualización de la instancia.
