Integracje / Metabase

Dokumenty i dane firmy

Integracja AI: Metabase

Podłączamy się do Metabase przez REST API i czytamy wyniki zapisanych pytań, kart z dashboardów oraz alerty progowe ustawione na pytaniach. Asystent odpowiada po polsku na pytania o dane, porównuje okresy i sygnalizuje odchylenia, bez znajomości SQL.

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

Narzędzie „Karty i alerty: Metabase” w portalu redAi, ekran z danymi z programu Metabase
Narzędzie „Karty i alerty: Metabase” w Waszym portalu. Dane przykładowe.

W skrócie

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

Łączymy się z Metabase przez dokumentowane REST API po HTTPS, uwierzytelniając się kluczem API w nagłówku Authorization. Klucz generujecie w Admin > API Keys i przypisujecie go do grupy z dostępem wyłącznie do odczytu.

Na start potrzebujemy
Klucz API wygenerowany w Admin > API Keys, przypisany do grupy z dostępem tylko do odczytu.
Czego asystent nie robi
Nie tworzy nowych zapytań SQL ani nie modyfikuje istniejących pytań w Metabase.
Gdzie są dane
Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.

Dane z Metabase 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: Karty i alerty: Metabase. Moduł zbiera wyniki śledzonych pytań i kart z Metabase i pokazuje je w jednym miejscu, bez logowania do dashboardu. Zespół widzi od razu, które pytania przekroczyły próg alertu i o ile, zanim przyjdzie mail od Metabase.

  • Wyświetla najnowszy wynik każdego śledzonego pytania z Metabase
  • Oznacza karty, których wynik przekroczył ustawiony próg alertu
  • Pokazuje zmianę względem poprzedniego cyklu jako odsetek lub liczbę
  • Grupuje karty według dashboardu: Sprzedaż, Finanse, Magazyn, CRM
  • Po kliknięciu otwiera pełny wynik pytania z historią wywołanych alertów
Rozmowa z asystentem AI w portalu redAi o danych z programu Metabase: Porównanie wyników sprzedaży tygodniowej wg regionów

Pytanie w czacie

Asystent pobiera wyniki kart z Metabase i od razu wskazuje, gdzie szukać przyczyny, zamiast odsyłać do kolejnych dashboardów.

W Metabase widzę, że sprzedaż tygodniowa jest poniżej normy. Możesz porównać ten tydzień z poprzednim i wskazać, który region najbardziej odbiega?
Karta Zaległości pow. 60 dni w narzędziu Karty i alerty: Metabase w portalu redAi

Karta w narzędziu

Karta pokazuje historię alertów dla konkretnego pytania i gotową podpowiedź, co sprawdzić dalej, zanim analityk otworzy Metabase.

Jeden ekran zamiast kilku zakładek Metabase: status śledzonych pytań i alertów bez logowania do dashboardu.

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 Metabase włączamy dopiero wtedy, gdy sami tego chcecie.

Karty dashboardu

CzytamyKażda karta ma własny ID, niezależnie od dashboardu: przychód dzienny, zaległości, wartość zamówień, marża.

AsystentPobiera wyniki każdej karty osobno i składa je w jedno podsumowanie zamiast osobnych tabel z liczbami.

Powiadomienia mailowe z alertów

CzytamyMaile wysyłane przez Metabase po przekroczeniu progu: nadawca, ID pytania i nazwa alertu w treści.

AsystentParsuje treść maila, wywołuje pełny wynik pytania przez API i przygotowuje zestawienie z kontekstem, zanim adresat otworzy skrzynkę.

Porównanie wyników między okresami

CzytamyWyniki tego samego pytania z bieżącego i poprzedniego okresu oraz analogicznego okresu rok wcześniej.

AsystentWskazuje zmianę procentową, region lub kategorię z największym odchyleniem i opisuje, co mogło wpłynąć na wynik.

Wartości odstające w wynikach

CzytamyTabela wynikowa pytania z wartościami liczbowymi: wiersze, kolumny, rekordy z danego okresu.

AsystentWykrywa rekordy znacząco odbiegające od reszty i wskazuje je z wartością i kontekstem, bez ręcznego przeglądania setek wierszy.

Automatyczny raport cykliczny

CzytamyWyniki kilku dashboardów: Sprzedaż, Finanse, Magazyn, pobierane według harmonogramu bez polecenia.

AsystentSkłada krótki raport tekstowy z najważniejszymi wskaźnikami i wysyła go na wskazane adresy, bez angażowania analityka.

O co pytają w praktyce

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

  • „Jak wyglądają wskaźniki finansowe na dziś?”
  • „Które faktury czekają na zapłatę od ponad miesiąca?”
  • „Dlaczego sprzedaż w tym tygodniu spadła?”
  • „W której kategorii produktowej marża brutto się pogorszyła?”

Co się zmienia

Menedżerowie dostają podsumowanie danych z dashboardów w kilka sekund, bez otwierania Metabase i bez znajomości SQL.

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

Metabase to narzędzie do analizy danych, które łączy się z bazą firmy i udostępnia wyniki bez znajomości SQL. Pracownicy budują w nim pytania klikając w graficznym kreatorze albo pisząc SQL, a gotowe raporty i dashboardy udostępniają całemu zespołowi. Firmy produkcyjne, handlowe i usługowe używają Metabase do codziennego śledzenia sprzedaży, finansów i stanów magazynowych.

Dane leżą w bazie firmy, a Metabase łączy się z nią i udostępnia wyniki przez interfejs przeglądarkowy albo przez REST API. Praca odbywa się w kolekcjach, czyli folderach organizujących pytania i dashboardy według obszarów: Finanse, Sprzedaż, Magazyn. Każde pytanie ma unikalny numer ID i opis, dzięki czemu asystent może trafić na właściwy raport, nawet nie znając go z góry.

Gdzie to działa najlepiej

Menedżer sprzedaży

Co poniedziałek rano menedżer sprawdza wyniki tygodniowe, ale same liczby w dashboardzie nie mówią mu, czy tydzień był dobry, czy zły: nie ma punktu odniesienia i nie wie, gdzie zaczął się problem.

Z asystentem: Asystent pobiera dashboard, porównuje z poprzednim tygodniem i tym samym tygodniem rok temu, wskazuje konkretny region z odchyleniem. Zamiast kilkunastu minut z raportami: jedno zdanie z odpowiedzią.

Kontroler finansowy

Kontroler dostaje mail od Metabase, że liczba faktur przeterminowanych powyżej 60 dni przekroczyła próg. Chce wiedzieć szybko, ile ich jest, na jaką kwotę i które firmy są na liście, zanim wejdzie na spotkanie.

Z asystentem: Asystent parsuje alert, wywołuje wynik pytania przez API i układa zestawienie: liczba faktur, łączna kwota, nazwy kontrahentów. Odpowiedź jest gotowa, zanim kontroler otworzy Metabase.

Dyrektor zarządzający

Co piątek analityk eksportował dane z trzech dashboardów i ręcznie składał raport dla zarządu. Trwało to kilkadziesiąt minut, a przy rotacji w zespole zdarzało się, że raport nie wyszedł w terminie.

Z asystentem: Asystent pobiera dane z dashboardów Sprzedaż, Finanse i Magazyn według harmonogramu, składa raport z najważniejszymi wskaźnikami i wysyła go na wskazane adresy. Analityk nie musi pilnować terminu.

Jak się łączymy

Łączymy się z Metabase przez dokumentowane REST API po HTTPS, uwierzytelniając się kluczem API w nagłówku Authorization. Klucz generujecie w Admin > API Keys i przypisujecie go do grupy z dostępem wyłącznie do odczytu. Główne wywołania: POST /api/card/{id}/query po wynik pytania, GET /api/dashboard/{id} po listę kart, GET /api/collection/{id}/items po zawartość folderu.

Asystent pracuje na serwerze klienta. Poziom dostępu ustawiacie w Admin > Permissions: grupie przypisujecie View tylko do wybranych kolekcji, co fizycznie blokuje zapis nawet dla klucza z pełnym dostępem. Konfiguracja działa tak samo w Metabase self-hosted i w Metabase Cloud. Reagowanie na alerty wymaga osobnej integracji ze skrzynką pocztową.

Czego potrzebujemy od Was

  • Klucz API wygenerowany w Admin > API Keys, przypisany do grupy z dostępem tylko do odczytu.
  • Metabase open source (self-hosted) lub Metabase Cloud z dostępnym REST API.
  • Pytania i dashboardy z czytelnymi nazwami i opisami w polu Description.
  • Osoba po stronie firmy znająca strukturę kolekcji i wiedzącą, które pytania są aktualne.
  • Dostęp sieciowy między serwerem asystenta a adresem Metabase: sieć lokalna lub bezpieczny tunel.

Czego asystent nie robi

  • Nie tworzy nowych zapytań SQL ani nie modyfikuje istniejących pytań w Metabase.
  • Nie zmienia danych w bazie: widzi wyłącznie wyniki, czyli wiersze i kolumny, bez dostępu do bazy bezpośrednio.
  • Nie odbiera alertów w czasie rzeczywistym: bez integracji ze skrzynką pocztową monitorowanie wymaga cyklicznego odpytywania API co kilkanaście minut.
  • Odpowiada wyłącznie na podstawie pytań zapisanych wcześniej w Metabase: nie wnioskuje z danych spoza tych wyników.

Częste pytania

Jak długo trwa uruchomienie integracji z Metabase?

Sam klucz API i połączenie z Metabase konfigurujemy w godzinę. Więcej czasu zajmuje przegląd kolekcji z osobą z firmy: żeby asystent trafiał na właściwe dane, nazwy i opisy pytań muszą być czytelne. Przy kilkudziesięciu pytaniach to kilka godzin roboczych z Waszej strony.

Czy kilku pracowników może zadawać pytania jednocześnie, każdy ze swojego konta?

Tak. Integracja działa przez jeden klucz API przypisany do grupy z dostępem do odczytu. Każdy użytkownik portalu pyta asystenta niezależnie: asystent wywołuje zapytania do Metabase sekwencyjnie. Przy bardzo dużym obciążeniu czas odpowiedzi może się wydłużyć, bo Metabase przetwarza zapytania do bazy jedno po drugim.

Gdy dodamy nowe pytanie do Metabase, czy asystent od razu je zobaczy?

Tak, bez zmian w konfiguracji integracji. Asystent przegląda kolekcje przez API i widzi każde pytanie dostępne dla grupy, do której przypisany jest klucz. Wystarczy nadać pytaniu czytelną nazwę i opis, umieścić w odpowiedniej kolekcji i upewnić się, że ta kolekcja ma ustawiony poziom View dla tej grupy.

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

Tak, to mechanizm wbudowany w Metabase. W Admin > Permissions przypisujecie grupie poziom View tylko dla wybranych kolekcji, np. wyłącznie Sprzedaż i Finanse. Pozostałe kolekcje są niewidoczne dla asystenta, nawet jeśli są w tej samej instancji Metabase. Uprawnienia zmieniacie sami, bez naszego udziału.

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 Metabase

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

Metabase 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.