API de Supabase: qué puedes hacer y cómo usarla con agentes de IA
Supabase es una plataforma de backend sobre Postgres que genera automáticamente una API REST para las tablas, y además ofrece autenticación, almacenamiento de archivos y funciones. La usan equipos de producto y desarrolladores que construyen aplicaciones. El acceso se hace con las claves del proyecto, con reglas de seguridad por fila (RLS).
Qué ofrece la API de Supabase
API de base de datos
Consulta y escritura en las tablas de Postgres por REST, respetando las políticas de seguridad.
Autenticación
Registro, inicio de sesión y gestión de los usuarios de la aplicación.
Storage
Almacenamiento y entrega de archivos en buckets.
Edge Functions
Funciones que se ejecutan bajo demanda, llamadas por HTTP.
Realtime
Suscripción a los cambios de las tablas en tiempo real.
API de gestión
Administración de los proyectos de la organización.
Cómo acceder a la API de Supabase
- Con las credenciales de tu empresaUsa las claves del proyecto: la clave pública respeta las políticas de seguridad por fila, y la clave de servicio ignora esas políticas y debe quedar restringida al servidor.
- La clave de servicio ignora las políticas de seguridad: no la uses para el agente sin necesidad.
- Expón vistas con solo las columnas necesarias, sin datos personales innecesarios.
- Los planes tienen límites de uso y de solicitudes.
Documentación oficial: supabase.com/docs
Qué hace un agente de iTeam con la API de Supabase
Preguntas sobre el producto en lenguaje natural
El responsable pregunta cuántos usuarios activaron cierta función esta semana y el agente consulta las tablas habilitadas y responde con el número.
Soporte con datos del cliente
El agente de soporte consulta en la base el registro y el estado de la cuenta del cliente para responder sin recurrir al equipo técnico.
Correcciones con aprobación
El agente prepara ajustes puntuales, como reactivar una cuenta, y se ejecutan tras la aprobación.
Alerta de anomalías
El agente vigila las tablas de pedidos o de errores y avisa cuando el volumen se aparta de lo normal.
De la credencial al agente trabajando, con aprobación
Crea un rol y políticas para el agente
En Supabase, define un rol o una vista con las tablas y las columnas que el agente puede leer, con políticas de seguridad por fila.
Registra la clave en la bóveda
La clave queda en la bóveda de iTeam. Evita la clave de servicio y habilita la escritura solo donde sea necesaria.
Prueba en un proyecto de desarrollo
Valida las consultas en un proyecto de prueba y mantén la aprobación para cualquier cambio en producción.
Equipos de IA listos para este trabajo
Reportes e indicadores
Nina junta los datos, Darwin revisa los números y el informe de indicadores llega a Slack con lo que cambió y por qué.
Análisis de datos
Escribes la pregunta en Slack o en el chat; Nina consulta tu base de datos y responde con el número, la consulta usada y un gráfico.
Mesa de ayuda de TI
Jaca resuelve en Slack o Teams lo que ya está documentado, Nina vigila el SLA en Jira y TI se queda con los problemas de verdad.
Preguntas sobre la API de Supabase
¿La API de Supabase es gratuita?
Supabase tiene un plan gratuito con límites y planes de pago por uso y recursos. La API acompaña el plan del proyecto.
¿Necesito programar para usar la API de Supabase con iTeam?
No necesariamente. iTeam lee la documentación y el esquema habilitado, y el equipo de implantación configura las consultas junto con tu equipo técnico.
¿El agente puede ejecutar SQL libre?
Puede, pero recomendamos limitarlo a vistas y consultas definidas, con la escritura bajo aprobación.
