Supabase es una plataforma de código abierto que proporciona una alternativa a Firebase, ofreciendo un conjunto completo de herramientas de backend, incluyendo bases de datos en tiempo real, autenticación y servicios API.

📌 ¿Qué es este módulo?

Este módulo permite conectar Saturn Studio con Supabase, una plataforma open-source alternativa a Firebase que ofrece una completa suite de herramientas backend como bases de datos en tiempo real, autenticación, almacenamiento y ejecución de funciones Postgres. Ideal para automatizaciones que requieren operaciones con datos dinámicos, embeddings o almacenamiento de archivos.

📚 Descripción de los comandos

📄 Get Table

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Supabase necesaria para acceder a la tabla.	credential
Nombre de la tabla	Nombre de la tabla que se desea obtener.	Clients
Ordenar por fecha de creación	Si está activado, ordena los resultados de más nuevo a más antiguo.	true
Asignar resultado a variable	Variable donde se almacenará el resultado. {“table”[{“id”4,”created_at””2025-03-31T164319.794747+0000″,”name””John”,”lastname””Doe”},{“id”5,”created_at””2025-03-31T164356.786912+0000″,”name””John”,”lastname””Doe”}]}	{var}

Obtiene el contenido completo de una tabla específica.

📄 Filter Table

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Supabase necesaria para filtrar la tabla.	credential
Nombre de la tabla	Tabla a consultar.	Clients
Nombre de la columna	Columna por la que se filtrará.	Id
Valor	Valor por el cual se filtrará la columna.	31233
Asignar resultado a variable	Variable donde se almacenará el resultado. {“table”[{“id”450102905661143,”created_at””2025-04-03T190051.148+0000″,”name””Wikipedia”,”lastname””web”,”embed””[-0.053218544,-0.025654549…]”}]}	{var}

Filtra una tabla por el valor de una columna específica.

📄 Insert Rows

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Supabase necesaria para insertar.	credential
Nombre de la tabla	Tabla donde se insertarán los datos.	Clients
Columnas	Lista de objetos clave-valor para insertar.	[{ “Name”: “John”, “Lastname”: “Doe”, “Age”: 30 }]
Asignar resultado a variable	Variable donde se almacenará el resultado. {“insertedRows”[{“id”14,”created_at””2025-03-31T173647.646493+0000″,”name””John”,”lastname””Doe”},{“id”15,”created_at””2025-03-31T173647.646493+0000″,”name””Dave”,”lastname””Davinson”}]}	{var}

Inserta una o más filas en la tabla especificada.

📄 Update Rows

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Supabase necesaria para actualizar.	credential
Nombre de la tabla	Tabla donde se actualizarán los datos.	Clients
Columna a actualizar	Nombre de la columna a modificar.	Name
Valor	Nuevo valor para esa columna.	John
Columna para filtrar	Columna que se usará para identificar los registros.	Id
Valor del filtro	Valor por el cual filtrar la columna.	31233
Asignar resultado a variable	Variable donde se almacenará el resultado. {“message” “Rows updated successfully”}	{var}

Actualiza filas que cumplan una condición específica en la tabla.

📄 Get a Bucket

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Supabase necesaria para acceder al bucket.	credential
Bucket	Nombre del bucket a obtener.	Rocket
Asignar resultado a variable	Variable donde se almacenará el resultado.	{“bucket”{“id””Rocket”,”name””Rocket”,”owner”””,”public”true,”file_size_limit”1024,”allowed_mime_types”[“image/png”],”created_at””2025-03-31T190849.061Z”,”updated_at””2025-03-31T190849.061Z”}}

Obtiene los detalles de un bucket de almacenamiento.

📄 Create a Bucket

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Supabase necesaria para crear el bucket.	credential
Nombre del bucket	Nombre del nuevo bucket.	Rocket Launches
Público	Si está activo, el bucket será público.	true
Límite de tamaño	Tamaño máximo de archivo en bytes.	1024
Tipos MIME permitidos	Lista separada por comas de tipos MIME permitidos.	image/jpeg, image/png
Asignar resultado a variable	Variable donde se almacenará el resultado.	{“bucket”{“name””RocketbotBucket”}}

Crea un nuevo bucket de almacenamiento en Supabase.

📄 Upload File

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Supabase necesaria para subir el archivo.	credential
Bucket	Bucket donde se subirá el archivo.	Rocket
Ruta del archivo	Ruta local del archivo a subir.	image.jpg
Asignar resultado a variable	Variable donde se almacenará el resultado.	{“file”{“path””C\Users\Desktop\saturn_studio\Rocketbot Icon.jpg”,”id””3aa9f15a-b93c-4765-92cc-e0574f71b446″,”fullPath””AAAAAA/C/Users/Desktop/saturn_studio/Rocketbot Icon.jpg”}}

Sube un archivo (imagen, PDF, etc.) al bucket seleccionado.

📄 Generate and Store Embedding

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Supabase.	credential
Credencial de IA	Credencial del motor de embeddings a usar.	Name
Modelo de embedding	Modelo utilizado para generar embeddings.	Name
Nombre de la tabla	Tabla donde se almacenará el embedding generado.	Clients
Contenido	Contenido a partir del cual se generará el embedding.	{variable} or <!doctype html…
Tamaño de fragmento	Tamaño del bloque de texto a procesar.	1024
Superposición de fragmento	Superposición entre bloques de texto.	100
Asignar resultado a variable	Variable donde se almacenará el resultado.	{“table””saturn_table”,”embed_column””embed”,”processed_rows”[{“id”8550467265849849,”text””{{“data_”[{“filename””sitefetch_1743693799824.txt”,”id””483171b10ebf1f8b5ebcc22ecaad0f2f7851f6613ca22496fb9557c0b485b34f27b388498fbe9b48efe2903645035e38″,”size”154,”provider””sitefetch”}],”content”{“/”{“title””Sitefetch”,”url””https//sitefetch.vercel.app/”,”content””[Buy me a Ko-fi]”}}}.content./.content”,”embedding_preview””[-0.0442160926759243, -0.019968125969171524, 0.024202141910791397, -0.03914377838373184, 0.07313912361860275…]”,”embedding_length”384,”created_at””2025-04-03T152336.083Z”,”name””Wikipedia”,”lastname””web”}],”total_rows”1}

Genera representaciones vectoriales (embeddings) y las almacena en una tabla de Supabase.

📄 Execute Postgres Function

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Supabase para ejecutar la función.	credential
Nombre de la función	Nombre de la función Postgres a ejecutar.	hello_world
Parámetros	Parámetros a pasar a la función (en JSON).	{ “embedding”: […], “match_threshold”: 0.7 }
Asignar resultado a variable	Variable donde se almacenará el resultado. {“result”[{“id”450102905661143,”name””Wikipedia”,”lastname””web”,”similarity”1}]}	{var}

Ejecuta funciones personalizadas definidas en la base de datos Postgres de Supabase.

📄 Retrieve Documents (Vector Store)

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Supabase necesaria.	credential
Credencial de IA	Motor de embeddings a utilizar.	Name
Modelo de embedding	Modelo para generar la consulta vectorial.	Name
Nombre de la función	Función Postgres usada para la búsqueda de similitud.	hello_world
Texto a buscar	Texto base de la búsqueda.	query…
Número de resultados	Cantidad de documentos similares a retornar.	5
Asignar resultado a variable	Variable donde se almacenará el resultado. {“result”[{“id”450102905661143,”name””Wikipedia”,”lastname””web”,”similarity”1}]}	{var}

Realiza una búsqueda de similitud sobre embeddings almacenados en Supabase.

🧪 Ejemplos de uso

Get Table: Listar todos los clientes almacenados en la tabla “Clients”.
Insert Rows: Agregar un nuevo usuario desde un formulario externo.
Generate and Store Embedding: Procesar contenido web y guardar embeddings para búsquedas vectoriales.
Execute Postgres Function: Invocar funciones personalizadas para cálculos avanzados directamente desde RPA.

🧩 Requisitos

Tener una credencial válida de Supabase configurada en Saturn Studio.
Conocer la estructura de las tablas, columnas y funciones a utilizar.
Para embeddings, contar con una credencial de IA compatible y modelo activo.
Si se usa almacenamiento, definir correctamente permisos y límites del bucket.

Saturn Studio – Supabase