SSara 0.2 to skrypt Pipeline łączący Open WebUI z platformą automatyzacji n8n. Zapewnia szyfrowanie kluczy API algorytmem Fernet (AES-128), streaming odpowiedzi AI w czasie rzeczywistym oraz pełne zarządzanie kontekstem konwersacji dla firm z sektora TSL i logistyki.
Przegląd zagadnień
| Zagadnienie | W skrócie |
|---|---|
| Czym jest SSara 0.2 | SSara 0.2 to dedykowany kod pozwalający na bezpośrednią komunikację między czatem Open WebUI a agentami AI lub workflowami zbudowanymi w n8n. |
| Bezpieczeństwo kluczy API - szyfrowanie Fernet | SSara 0.2 wprowadza klasę EncryptedStr, wykorzystującą mechanizm Fernet (AES-128 w trybie CBC). |
| Konfiguracja w panelu Valves | Zarządzanie integracją odbywa się bezpośrednio z poziomu panelu administratora Open WebUI, w sekcji Valves. |
| Kontekst i personalizacja | W odróżnieniu od prostych integracji SSara 0.2 dba o to, by AI wiedziało, z kim rozmawia i o czym. |
| Streaming i filtrowanie odpowiedzi | Największym wyzwaniem w pracy z n8n jest obsługa danych technicznych przesyłanych podczas generowania odpowiedzi. |
SSara 0.2 działa jako łącznik między interfejsem czatu Open WebUI a workflowami n8n, umożliwiając uruchamianie zaprojektowanych procesów biznesowych bezpośrednio z poziomu rozmowy z AI. Klucze API są automatycznie szyfrowane i deszyfrowane wyłącznie w pamięci operacyjnej, co zapewnia bezpieczeństwo klasy enterprise nawet przy nieautoryzowanym dostępie do bazy danych.
Czym jest SSara 0.2
SSara 0.2 to dedykowany kod pozwalający na bezpośrednią komunikację między czatem Open WebUI a agentami AI lub workflowami zbudowanymi w n8n. Zapytanie wpisane przez użytkownika nie trafia do standardowego modelu, lecz uruchamia zaprojektowany proces biznesowy, zwracając odpowiedź w czasie rzeczywistym.
W architekturze systemów Pipeline AI pełni funkcję pośrednika, który zarządza przepływem informacji między interfejsem użytkownika a silnikiem logiki biznesowej. W branży TSL rozwiązanie to pozwala błyskawicznie łączyć zapytania o status przesyłki z algorytmami przeszukującymi bazy danych przewoźników, bez ryzyka utraty kontekstu.
Bezpieczeństwo kluczy API - szyfrowanie Fernet
SSara 0.2 wprowadza klasę EncryptedStr, wykorzystującą mechanizm Fernet (AES-128 w trybie CBC). Kod pobiera klucz tajny systemu (WEBUI_SECRET_KEY) i szyfruje nim token n8n. Nawet w przypadku nieautoryzowanego dostępu do bazy danych klucze są widoczne jako nieczytelny ciąg znaków - deszyfracja odbywa się wyłącznie w pamięci operacyjnej w momencie wykonywania zapytania.
W łańcuchu dostaw, gdzie bezpieczeństwo danych handlowych jest priorytetem, Fernet chroni tokeny dostępowe do systemów klasy TMS czy ERP - wrażliwe informacje konfiguracyjne pozostają bezpieczne nawet przy fizycznym dostępie osób trzecich do bazy danych.
Konfiguracja w panelu Valves
Zarządzanie integracją odbywa się bezpośrednio z poziomu panelu administratora Open WebUI, w sekcji Valves. Pozwala to na szybkie zdefiniowanie adresu webhook n8n, klucza autoryzacji (Bearer Token) oraz mapowania pól JSON - bez ingerencji w kod aplikacji.
Kontekst i personalizacja
W odróżnieniu od prostych integracji SSara 0.2 dba o to, by AI wiedziało, z kim rozmawia i o czym. Funkcja budowania paczki danych (payload) przesyła do n8n pełną historię konwersacji, dzięki czemu AI zachowuje ciągłość logiczną rozmowy, dane użytkownika (ID, e-mail, imię) umożliwiające personalizację odpowiedzi, np. weryfikację uprawnień w systemach CRM, oraz metadane - unikalne identyfikatory czatu i wiadomości ułatwiające późniejszy audyt.
Streaming i filtrowanie odpowiedzi
Największym wyzwaniem w pracy z n8n jest obsługa danych technicznych przesyłanych podczas generowania odpowiedzi. SSara 0.2 posiada parser, który odrzuca metadane techniczne (np. identyfikatory węzłów, statusy wewnętrzne) i prezentuje użytkownikowi czysty tekst, kompatybilny z formatem czystego tekstu, JSON oraz standardem OpenAI.
Główna pętla sterująca zarządza interakcją płynnie - zamiast statycznego oczekiwania na odpowiedź użytkownik widzi komunikaty statusu, takie jak "Thinking" lub "Ssara realizuje zadanie", a odpowiedź pojawia się słowo po słowie dzięki streamingowi, co podnosi komfort pracy z systemem.
Słownik pojęć
- PPipeline AI
- Funkcja pośrednicząca w Open WebUI, zarządzająca przepływem informacji między interfejsem czatu a silnikiem logiki biznesowej.
- WWebhook
- Metoda komunikacji między aplikacjami oparta na zdarzeniach, przesyłająca dane natychmiast po wystąpieniu określonej akcji.
- SSzyfrowanie Fernet
- Implementacja szyfrowania symetrycznego (AES-128 w trybie CBC), gwarantująca ochronę danych bez odpowiedniego klucza.
- AAutomatyzacja Workflow (n8n)
- Platforma low-code do projektowania przepływów pracy i integrowania rozproszonych usług cyfrowych.