Integracje / Supabase

Dokumenty i dane firmy

Integracja AI: Supabase

Podłączamy tabele PostgreSQL z Supabase: auth.users z datami logowań, subscriptions ze statusami planów i support_tickets ze zgłoszeniami. Asystent odpowiada na pytania o aktywność klientów i grupuje błędy z Edge Functions bez znajomości SQL.

Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.

Narzędzie „Subskrypcje z Supabase” w portalu redAi, ekran z danymi z programu Supabase
Narzędzie „Subskrypcje z Supabase” w Waszym portalu. Dane przykładowe.

W skrócie

Jak asystent AI łączy się z systemem Supabase?

Łączymy się z Supabase dwiema drogami. Pierwsza to REST API oparte na PostgREST: każda tabela z schematu public dostępna przez HTTPS pod adresem projektu.

Na start potrzebujemy
Konto z rolą Owner lub Admin w projekcie Supabase
Czego asystent nie robi
Asystent nie zmienia ani nie usuwa danych w bazie Supabase: żadnych UPDATE, DELETE ani INSERT.
Gdzie są dane
Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.

Dane z Supabase w czacie i we własnym module

Pracujecie na dwa sposoby. W czacie pytacie o cokolwiek z programu i dostajecie odpowiedź na Waszych danych. Do rzeczy, które wracają co dzień, budujemy w portalu osobne narzędzie: Subskrypcje z Supabase. Moduł pokazuje aktualny status planów, triali i aktywności kont z tabel subscriptions i auth.users w Supabase w jednym ekranie. Zespół widzi od razu, które konta wymagają kontaktu: wygasające triala, obniżenia planu i klientów bez logowania od wielu dni. Żadnego SQL i żadnego oczekiwania na programistę.

  • Wyświetla status triala dla każdego konta, z licznikiem dni do wygaśnięcia
  • Wykrywa konta, które obniżyły plan w ostatnich 7 dniach
  • Filtruje klientów bez logowania przez wybraną liczbę dni
  • Grupuje nowe rejestracje według providera: Google, Apple, e-mail
  • Łączy dane z auth.users i subscriptions bez pisania SQL
Rozmowa z asystentem AI w portalu redAi o danych z programu Supabase: Błędy Edge Functions: ostatnia noc

Pytanie w czacie

Asystent przejrzał Logs Explorer w Supabase i wskazał funkcje z największą liczbą błędów. Zestawienie z lokalizacją w kodzie i liczbą wystąpień gotowe do przekazania programiście.

Sprawdź w Supabase, jakie błędy powtarzały się najczęściej w Edge Functions ostatniej nocy. Czy pojawiły się nowe błędy w porównaniu z poprzednią dobą?
Karta Nexovo w narzędziu Subskrypcje z Supabase w portalu redAi

Karta w narzędziu

Karta łączy dane z auth.users i subscriptions w Supabase. Asystent wykrywa ryzyko utraty klienta i proponuje kolejny krok z jednym kliknięciem.

Moduł wyciąga dane z tabeli subscriptions w Supabase i pokazuje aktualny stan każdego planu. Jedno kliknięcie otwiera kartę konta z historią zmian i podpowiedzią asystenta.

Ekrany na danych przykładowych. Narzędzie dla Waszej firmy układamy pod Wasz sposób pracy: inne kolumny, inne progi, inne powiadomienia.

Co podłączamy

Zaczynamy od odczytu danych. Zapis i akcje w systemie Supabase włączamy dopiero wtedy, gdy sami tego chcecie.

auth.users (konta)

Czytamyemail, created_at, last_sign_in_at, email_confirmed_at, raw_app_meta_data z rolą, provider logowania: Google, hasło, Apple

AsystentWykrywa konta bez potwierdzonego emaila, grupuje nowe rejestracje według providera i wypisuje klientów niezalogowanych od podanej liczby dni

tabela subscriptions

Czytamystatus planu, trial_ends_at, data zmiany abonamentu, przejścia między planami (np. Pro na Free)

AsystentPodaje liczbę triali kończących się w danym tygodniu i wykrywa klientów, którzy obniżyli plan w minionym miesiącu

tabela orders

Czytamystatusy zamówień, kwoty, daty, czas oczekiwania na realizację od momentu złożenia

AsystentLiczy zamówienia ze statusem pending dłużej niż 48 godzin i zestawia obrót według wybranego przedziału dat

tabela support_tickets

Czytamyotwarte zgłoszenia, czas bez odpowiedzi, treść i data zgłoszenia

AsystentSortuje zgłoszenia po czasie oczekiwania i wskazuje te bez żadnej reakcji od wczoraj lub dłużej

Logs Explorer Edge Functions

Czytamytimestamp, nazwa funkcji, treść błędu z lokalizacją w kodzie (plik i numer linii), liczba wystąpień

AsystentGrupuje błędy według nazwy funkcji i treści, liczy wystąpienia w przedziale czasu i podaje gotową informację dla programisty: co, gdzie, kiedy, jak często

tabela profiles lub users

Czytamyimię, plan, dodatkowe pola dopisane przez programistę do schematu public, uzupełniające auth.users

AsystentŁączy dane konta z polami własnymi tabeli i odpowiada na pytania o konkretnego klienta bez pisania SQL

O co pytają w praktyce

Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.

  • „Ilu użytkowników zarejestrowało się w tym tygodniu?”
  • „Którzy klienci mają aktywny trial i kiedy im wygasa?”
  • „Ile zamówień czeka ze statusem pending ponad dwie doby?”
  • „Jakie błędy powtarzały się najczęściej w Edge Functions ostatniej nocy?”

Co się zmienia

Właściciel aplikacji widzi dane o użytkownikach i błędach serwera bez angażowania programisty przy każdym pytaniu.

Asystent działa na Waszym serwerze, na Waszych uprawnieniach. Każdy odczyt i każda akcja zostawiają ślad w logu. Program zostaje tam, gdzie jest, razem z historią danych i nawykami zespołu.

O programie

Supabase to platforma backendowa zbudowana na PostgreSQL, którą programiści wybierają do szybkiego uruchomienia zaplecza aplikacji SaaS lub mobilnej. Baza danych, logowanie użytkowników, przechowywanie plików i funkcje serwerowe są gotowe w kilka dni. Z Supabase korzystają startupy i rozwijające się firmy produktowe, które chcą skupić się na funkcjach aplikacji, nie na utrzymaniu infrastruktury.

Dane siedzą w bazie PostgreSQL podzielonej na schematy: auth zakładany automatycznie przez Supabase (tabela auth.users z danymi kont) i public z tabelami własnymi programisty: profiles, subscriptions, orders, support_tickets. Pliki trafiają do Storage w bucketach. Edge Functions produkują logi dostępne w panelu Logs Explorer. Właściciel firmy zwykle nie ma do tych danych bezpośredniego dostępu bez pytania programisty.

Gdzie to działa najlepiej

właściciel aplikacji SaaS

Poniedziałkowy poranek, właściciel chce wiedzieć, ile osób anulowało subskrypcję w minionym tygodniu i czy liczba błędów Edge Functions wzrosła. Programista jest niedostępny do południa.

Z asystentem: Asystent odpytuje tabelę subscriptions i Logs Explorer, zwraca liczbę anulowań z podziałem na plan i informuje o błędach: które funkcje, ile razy, o której godzinie.

product manager

Przygotowuje prezentację dla inwestorów i potrzebuje liczby aktywnych użytkowników z ostatnich 30 dni, podziału na provider logowania i liczby nowych rejestracji w każdym tygodniu kwartału.

Z asystentem: Asystent czyta auth.users, filtruje last_sign_in_at i created_at, grupuje wyniki i oddaje gotowe zestawienie w kilkanaście sekund, bez SQL i bez oczekiwania na dewelopera.

kierownik obsługi klienta

Wieczorem przed końcem miesiąca sprawdza, ile zgłoszeń w support_tickets czeka bez odpowiedzi od ponad 24 godzin i które konta trialowe kończą się w ciągu najbliższych 7 dni.

Z asystentem: Asystent łączy dane z support_tickets i subscriptions, podaje posortowaną listę otwartych zgłoszeń po czasie oczekiwania i klientów z wygasającym trialam do follow-upu.

Jak się łączymy

Łączymy się z Supabase dwiema drogami. Pierwsza to REST API oparte na PostgREST: każda tabela z schematu public dostępna przez HTTPS pod adresem projektu. Używamy klucza service_role key z panelu Settings > API. Ten klucz omija Row Level Security, więc trzymamy go wyłącznie po stronie serwera. Druga droga to bezpośrednie połączenie z bazą Postgres przez connection string ze Settings > Database.

Integracja działa wyłącznie w trybie odczytu: klucz i connection string konfiguruje się z uprawnieniami read-only. Klucz zapisujemy zaszyfrowany na serwerze portalu klienta. Do modelu trafia polecenie i fragmenty potrzebne do odpowiedzi, bez trenowania cudzych modeli na Waszych danych. Klucz generujecie sami w Settings > API, bez zgłoszenia do supportu Supabase.

Czego potrzebujemy od Was

  • Konto z rolą Owner lub Admin w projekcie Supabase
  • Klucz service_role key z Settings > API (lub connection string z Settings > Database)
  • Opis tabel: nazwy, pola i znaczenie statusów w schemacie public
  • Jednorazowa pomoc programisty przy przekazaniu klucza i opisaniu struktury bazy
  • Aktywny projekt Supabase z danymi (tabele muszą zawierać rekordy)

Czego asystent nie robi

  • Asystent nie zmienia ani nie usuwa danych w bazie Supabase: żadnych UPDATE, DELETE ani INSERT.
  • Nie wywołuje Edge Functions ani nie uruchamia żadnych operacji po stronie serwera Supabase.
  • Nie zastępuje programisty przy analizie kodu ani przy naprawie błędów wychwyconych w logach.
  • Nie eksportuje danych osobowych użytkowników końcowych poza raporty agregatowe ustalone przy wdrożeniu.

Częste pytania

Czy integracja wymaga zmian w kodzie naszej aplikacji?

Nie. Łączymy się bezpośrednio z bazą Postgres lub przez REST API Supabase, korzystając z istniejących danych. Aplikacja działająca na Supabase nic nie musi wiedzieć o tej integracji i żaden jej fragment kodu nie jest modyfikowany.

Co się stanie, jeśli programista zmieni strukturę tabeli?

Gdy programista doda kolumnę, zmieni nazwę tabeli albo zmodyfikuje schemat, aktualizujemy opis tabel po stronie asystenta. To jednorazowa praca na kilkanaście minut. Bez aktualizacji opisu asystent może nie widzieć nowych pól albo odpytywać dane pod starą nazwą.

Czy możemy ograniczyć, do których tabel ma dostęp asystent?

Tak. Przy wdrożeniu wskazujecie dokładnie, które tabele i schematy mają być dostępne. Klucz można też skonfigurować z uprawnieniami tylko do wybranych tabel. Tabele, których nie opisaliśmy i nie uwzględniliśmy w integracji, asystent pomija.

Czy raporty tygodniowe można dostosować do naszego formatu?

Tak. Format, zawartość i odbiorcę ustalamy razem przy wdrożeniu. Raport może być tabelką, listą punktowaną albo krótkim akapitem z najważniejszymi liczbami. Idzie mailem do właściciela, product managera albo na kanał Slack. Dane osobowe użytkowników końcowych dołączamy tylko na wyraźne zlecenie i do użytku wewnętrznego.

Pełny opis integracji w bazie wiedzy →

Jak zaczynamy

  1. Bezpłatna prezentacja. Mówicie, na czym pracujecie i co Was korkuje. Mówimy wprost, czy da się to spiąć, a jeśli nie ma czego automatyzować, też to powiemy.
  2. Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
  3. Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
Wybierzcie termin → Wolicie napisać?
Wolicie napisać

Pokażemy to na Waszych danych z Supabase

Jedno zdanie wystarczy: czego szukacie w Supabase albo co ma się dziać samo. Odpiszemy, co podłączymy i od czego zacząć.

Supabase jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.