Czy Librus Synergia ma API i jak połączyć AI z dziennikiem szkoły?

Librus Synergia ma własne API, jednak nie jest ono publicznie dostępne dla każdego, kto chce się do niego podłączyć. Żeby korzystać z niego oficjalnie, trzeba być autoryzowanym partnerem Librus SA, co oznacza osobną umowę z producentem systemu. Bez tej umowy legalna droga do danych to eksporty z panelu administratora szkoły oraz praca na koncie użytkownika: frekwencja, oceny, wiadomości do rodziców, plan lekcji. AI potrafi z tych danych wyciągnąć realną wartość dla sekretariatu, dyrektora i wychowawców, o ile Wasza szkoła lub firma szkoleniowa wie, co i kiedy pobierać.

Czy Librus Synergia ma API i co to oznacza w praktyce?

Tak, Librus posiada API. To interfejs REST z autoryzacją OAuth 2.0, działający pod adresem api.librus.pl. Problem polega na tym, że to nie jest otwarte API w stylu "pobierz klucz i działaj". Producent udostępnia je wybranym partnerom technologicznym, z którymi podpisał umowę. Szkoła ani firma szkoleniowa nie podłączy się do niego samodzielnie bez przejścia przez ten formalny proces.

W sieci można trafić na nieoficjalne biblioteki, napisane w Pythonie, PHP lub JavaScript, które próbują korzystać z tego API przez sesję rodzica lub nauczyciela. Nie zalecamy tej drogi. Po pierwsze narusza regulamin Librusa. Po drugie, przy przetwarzaniu danych uczniów, czyli danych osobowych dzieci, naraża szkołę na poważne konsekwencje prawne. Pozostaje legalna droga: eksporty i konto administratora. Dla szkoły z pełnym dostępem administracyjnym to zaskakująco dużo możliwości.

Jeśli Wasza placówka poważnie rozważa integrację przez oficjalne API, warto skontaktować się bezpośrednio z Librus SA i zapytać o program partnerski. Proces nie jest krótki, ale taka droga daje dostęp do danych w czasie zbliżonym do rzeczywistego.

Co wyciągacie z panelu administratora Librusa?

Panel administratora w Librus Synergia daje znacznie więcej niż widzi zwykły nauczyciel. Administrator szkoły ma wgląd w dane całej placówki i może pobierać je w formie plików.

Frekwencja uczniów. Eksport CSV z zestawieniem obecności w wybranym przedziale czasu. Każdy wiersz to jeden wpis: uczeń, klasa, data, numer godziny lekcyjnej, typ nieobecności. Librus rozróżnia: nieobecny, spóźniony, zwolniony, usprawiedliwiony, zwolniony przez szkołę. To jest ten plik, który sekretariat zwykle otwiera w Excelu i sumuje ręcznie przed zebraniem rady pedagogicznej.

Oceny cząstkowe i semestralne. Eksport zawiera: przedmiot, kategorię oceny (sprawdzian, kartkówka, zadanie domowe, aktywność, praca klasowa), wartość numeryczną lub opisową, wagę, datę wpisania i inicjały nauczyciela. Przy kilkuset uczniach i kilkunastu przedmiotach plik robi się naprawdę duży. AI radzi sobie z nim bez problemu.

Uwagi o uczniach. Moduł Uwag w Librusie zbiera notatki wychowawców i nauczycieli: pochwały, nagany, informacje o zachowaniu. Dostępne w panelu administratora jako zestawienie po klasach lub po uczniach, z datami i autorami wpisów.

Zastępstwa. Moduł zastępstw pokazuje dzień po dniu: który nauczyciel jest nieobecny, kto go zastępuje, z jakim przedmiotem i w której klasie. Dane można przeglądać i kopiować do arkusza lub bezpośrednio wkleić do narzędzia AI.

Plan lekcji. Widoczny w panelu administratora. Nie ma dedykowanego eksportu CSV planu lekcji, ale dane są dostępne do przeglądania i kopiowania. Przy cyklicznych zmianach planu to kilka minut ręcznej pracy przed podaniem danych AI.

Czego nie ma w standardowych eksportach: danych kontaktowych rodziców. Numery telefonów i adresy e-mail są w bazie Librusa, ale administrator szkoły nie pobiera ich jako gotowego pliku CSV. Do wysyłki wiadomości służy wbudowany moduł Wiadomości Librusa, a nie lista kontaktów do pobrania.

Jak fizycznie wygląda podłączenie AI do Librusa?

Zacznijmy od jasnej odpowiedzi: Wasza szkoła nie zintegruje się z Librusem przez API w weekend bez umowy partnerskiej z Librus SA. To nie jest kwestia techniczna, to formalna. Producent decyduje, kto dostaje dostęp do API, i jest to kilkutygodniowy lub kilkumiesięczny proces.

Co zamiast tego? Trzy realne drogi:

• Eksporty ręczne z panelu administratora. Administrator pobiera plik CSV raz dziennie albo raz w tygodniu, wgrywa go do platformy AI lub przesyła do systemu obsługi szkoły. Proste, legalne, sprawdzone. U jednego z naszych klientów, szkoły z ponad 300 uczniami, cały przepływ danych frekwencji wygląda tak: o 15:30 administrator klika eksport frekwencji z bieżącego miesiąca, plik trafia do wyznaczonego folderu, AI analizuje go automatycznie i do 16:00 sekretariat ma gotową listę uczniów z przekroczoną absencją.
• Automatyczne pobieranie przez konto administratora. Można napisać skrypt, który loguje się na konto administratora i pobiera dane eksportu cyklicznie. Wymaga zgody szkoły i ostrożności, bo maszynowe logowanie jest na granicy regulaminu producenta. Przed wdrożeniem warto skonsultować to z Librus SA lub prawnikiem obsługującym placówkę.
• Praca w module Wiadomości. Nauczyciel lub sekretariat pisze wiadomości do rodziców bezpośrednio w interfejsie Librusa. AI pomaga przygotować treść: dostaje informacje o zdarzeniu i generuje gotowy projekt wiadomości, który sekretariat kopiuje i wysyła. Bez integracji technicznej, ale z realnym odciążeniem biura.

Żadna z tych dróg nie daje integracji na żywo. Oceny wpisane przez nauczyciela teraz nie trafią do AI za sekundę. To praca na eksportach, nie na zdarzeniach w czasie rzeczywistym. Dla większości potrzeb szkoły to absolutnie wystarcza.

Co AI robi z danymi z Librusa? Konkretne przypadki

Wyłapywanie uczniów z dużą absencją. AI dostaje CSV z frekwencją za ostatni miesiąc. Zlicza nieobecności na ucznia, pomija usprawiedliwione, oznacza tych, którzy przekraczają próg przyjęty przez szkołę. Dyrektor i wychowawcy dostają zestawienie gotowe do działania, bez ręcznego sumowania kolumn. Typowo wygląda to tak, że wychowawca klasy dostaje wiadomość od sekretariatu z gotową listą zamiast sam liczyć z arkusza dziennika przed wywiadówką.

Raporty miesięczne i semestralne dla dyrektora. Na podstawie eksportów ocen cząstkowych AI przygotowuje zestawienie: ile ocen niedostatecznych wpisano w podziale na klasy i przedmioty, jak kształtuje się rozkład ocen na poszczególnych etapach semestru, które kategorie (sprawdziany, kartkówki, zadania domowe) ciągną średnią najniżej. Dyrektor dostaje dokument zamiast godziny spędzonej przy Excelu.

Projekty wiadomości do rodziców. Sekretariat opisuje sytuację: "W czwartek zmieniony plan klasy 3B, matematyka przesuwa się na 5. lekcję, angielski odpada". AI przygotowuje gotową wiadomość w odpowiednim tonie, do skopiowania do modułu Wiadomości w Librusie. Przy kilku klasach dziennie i kilkunastu różnych powiadomieniach w tygodniu oszczędność czasu jest wyraźna, szczególnie gdy każda klasa wymaga nieco innej treści.

Ogłoszenia o zastępstwach. Sekretariat wklepuje dane zastępstw na kolejny dzień: kto jest nieobecny, kto zastępuje, jakie lekcje i w której sali. AI formatuje ogłoszenie według przyjętego wzoru szkoły: wersję do wklejenia w Librusie i wersję do wydrukowania na tablicę przy wejściu. Koniec z formatowaniem tabelki o 7:00 rano.

Obsługa zapytań rekrutacyjnych w szkole niepublicznej. AI odpowiada na typowe pytania kandydatów i rodziców: jakie dokumenty są wymagane przy zapisie, jakie są terminy składania dokumentów, jak wygląda rozmowa kwalifikacyjna, kiedy ogłaszane są wyniki rekrutacji. Po wstępnym pytaniu AI może automatycznie zapisać zgłoszenie do kolejki sekretariatu i wysłać formularz wstępny, zanim ktokolwiek ze szkoły otworzy skrzynkę mailową.

Firma szkoleniowa współpracująca ze szkołami. Firma nie ma bezpośredniego dostępu do Librusa żadnej ze szkół, z którymi współpracuje. Może jednak dostać eksport danych od szkoły, na przykład frekwencję uczestników prowadzonych przez siebie zajęć, i na tej podstawie przygotowywać raporty postępów dla dyrektora szkoły i na potrzeby własnego rozliczenia z placówką. AI składa zestawienie z kilku plików od różnych szkół w jeden zbiorczy raport.

Szkoła językowa a Librus: czy to ten sam system?

Warto postawić tę kwestię wprost. Librus Synergia to system zaprojektowany głównie dla szkół prowadzących pełne dzienniki lekcyjne z obowiązkiem raportowania do MEN. Wiele szkół językowych prowadzi klientów przez inne narzędzia: LangLion, ActiveNow, własne arkusze. Jeśli Wasza szkoła językowa używa Librusa, opisane wyżej podejście działa dokładnie tak samo.

Jeśli natomiast macie LangLion lub ActiveNow, integracja z AI wygląda zupełnie inaczej, bo te systemy mają inne możliwości eksportu i inne moduły komunikacji z uczniami. Opisaliśmy ten temat oddzielnie, żeby nie mieszać dwóch różnych podejść w jednym artykule.

RODO i dane uczniów: co trzeba mieć zanim zaczynacie

To jest kwestia, której nie można pominąć. Dane uczniów z Librusa to dane osobowe. Gdy szkoła prowadzi klasy z uczniami poniżej 16. roku życia, podlegają one szczególnej ochronie jako dane dzieci.

Zanim plik CSV z frekwencją trafi do systemu AI, szkoła musi:

• podpisać umowę powierzenia przetwarzania danych z dostawcą platformy AI,
• sprawdzić, czy dostawca przetwarza dane na serwerach spełniających wymogi RODO (serwery w UE lub umowy SCCs z odpowiednimi gwarancjami),
• upewnić się, że dane uczniów nie trafiają do ogólnych usług AI, które uczą się na przesyłanych danych i wykorzystują je do trenowania modeli.

W praktyce: eksportu frekwencji z imionami i nazwiskami uczniów nie wklejamy do publicznego chatbota bez takiej umowy. Nawet jeśli "przecież to tylko lista". Dobry dostawca AI powinien mieć gotowy wzór umowy powierzenia i jasno opisać, gdzie fizycznie przechowuje dane.

Warto też sprawdzić, czy szkoła ma już umowę powierzenia z samym Librusem. Jeśli tak, zwróćcie uwagę na to, co ta umowa mówi o eksportowaniu danych i przekazywaniu ich podmiotom trzecim. W razie wątpliwości to pytanie do prawnika obsługującego placówkę, nie do administratora systemu.

Od czego zacząć?

Zanim wybierzecie narzędzie AI, sprawdźcie jedną rzecz: zalogujcie się do Librusa na konto administratora i wejdźcie do sekcji raportów lub eksportów. Zobaczcie, jakie pliki są dostępne w Waszej wersji systemu. Librus oferuje różne pakiety dla szkół i nie każda placówka ma dostęp do tych samych eksportów.

Rekomendujemy zacząć od frekwencji. To najprostszy przepływ: eksport CSV, analiza przez AI, lista uczniów z alertem dla sekretariatu lub wychowawców. Wynik widać w ciągu jednego dnia roboczego, a cały mechanizm nie wymaga integracji technicznej z Librusem, tylko regularnego pobierania pliku. Potem można dołożyć raporty dla dyrektora i szablony wiadomości do rodziców.

Zanim przekażecie plik z danymi uczniów do jakiegokolwiek systemu AI, podpisujcie umowę powierzenia. To nie jest formalność do ominięcia, to warunek konieczny przy danych dzieci.

Chcecie zobaczyć, jak działa taki przepływ u szkoły lub firmy szkoleniowej, która już to wdrożyła? Zerknijcie na realne wdrożenia. A jeśli macie konkretne pytania o Waszą placówkę, umówcie się na 15 minut rozmowy: pokażemy, co da się zrobić legalnie na eksportach i koncie administratora, bez czekania na umowę partnerską z Librusem.