Typowe pytania dotyczace Seizn Memory API, od pierwszych krokow po zaawansowane operacje.
Q1Czym jest Seizn Memory i jaki problem rozwiazuje?
Seizn Memory to infrastruktura pamieci AI, ktora zapewnia trwala, przeszukiwalna pamiec dla aplikacji AI. W przeciwienstwie do baz wektorowych, ktore tylko przechowuja/wyszukuja wektory, Seizn zawiera pelna warstwe produktu: ekstrakcje pamieci, zarzadzanie politykami, zarzadzanie kluczami, usuwanie, dzienniki audytu i SDK. Rozwiazuje problem utrzymania kontekstu miedzy sesjami AI i umozliwia spersonalizowane doswiadczenia AI.
Pierwsze Kroki
Q2Czym Seizn rozni sie od baz wektorowych jak Pinecone czy Weaviate?
Bazy wektorowe to infrastruktura przechowywania/wyszukiwania dla wektorow. Seizn to kompletny system pamieci zbudowany na nich, zapewniajacy: automatyczna ekstrakcje pamieci z rozmow, klasyfikacje typow pamieci, zarzadzanie namespace/scope, rotacje kluczy API, dzienniki audytu, SDK i funkcje governance. Pomysl o tym jako 'infrastruktura pamieci' vs 'infrastruktura wyszukiwania'.
Pierwsze Kroki
Q3Czy potrzebuje RAG do korzystania z Seizn?
Nie. Najczestszy punkt startowy to: zapisz pamiec -> wyszukaj -> wstrzyknij do promptu. RAG (automatyczna kompozycja kontekstu + generowanie odpowiedzi) to nastepny krok. Mozesz zaczac prosto i dodawac zlozonosc w miare potrzeb.
Pierwsze Kroki
Q4Jaki jest najszybszy sposob na zbudowanie PoC?
1) POST /api/memories aby zapisac preferencje uzytkownika. 2) GET /api/memories aby wyszukac. 3) Wstrzyknij wyniki do promptu LLM. 4) Pozniej dodaj /api/extract do auto-ekstrakcji i /api/query do odpowiedzi wzbogaconych pamiecia.
Pierwsze Kroki
Q5Co powinienem przechowywac w /api/memories?
Przechowuj informacje, ktore pozostaja wazne miedzy rozmowami: preferencje (ton, jezyk, format), fakty (praca, narzedzia, struktura projektu), instrukcje ("zawsze podsumowuj w tabelach"), relacje ("Alice jest liderem zespolu"). Unikaj przechowywania tymczasowych lub specyficznych dla sesji danych, chyba ze uzywasz session scope.
Podstawowe Koncepty
Q6Jakich danych NIE powinienem przechowywac?
Nigdy nie przechowuj: hasel, kluczy API, tokenow, ciasteczek sesji (info auth), SSN, numerow paszportow, kont bankowych (PII), danych kart kredytowych (dane platnicze). Dla danych tymczasowych uzyj session scope z TTL jesli potrzeba.
Podstawowe Koncepty
Q7Dlaczego namespace jest wazny?
Namespace oddziela pamieci wedlug projektu/tenanta/srodowiska. Bez niego dane sie mieszaja, jakosc wyszukiwania spada, a usuwanie/eksport staje sie trudne. Zalecane: 'org:acme/app:chat/env:prod' lub 'project:myapp/env:staging'. Nigdy nie uzywaj samego 'default' w produkcji.
user: Preferencje obowiazujace globalnie dla uzytkownika. session: Cele lub kontekst wazny tylko dla tej rozmowy. agent: Reguly specyficzne dla jednego agenta w systemie multi-agentowym. Prawidlowe uzycie scope skraca dlugosc promptu i poprawia spojnosc odpowiedzi.
Podstawowe Koncepty
Q9Czym sa memory_types i dlaczego sa wazne?
memory_type klasyfikuje pamieci: fact (niezmienne info), preference (wybory uzytkownika), instruction (reguly do przestrzegania), relationship (powiazania osob/org), experience (przeszle wydarzenia). To najpotezniejsza os do filtrowania, usuwania i stosowania polityk.
Podstawowe Koncepty
Q10Jak dzialaja threshold i limit?
limit: Liczba kandydatow pamieci do pobrania (za mala = pomijanie istotnych, za duza = zaszumiony kontekst). threshold: Prog podobienstwa 0-1 (wyzszy = bardziej rygorystyczny). Zacznij od limit=10, threshold=0.7. Jesli pomijasz pamieci, obniz threshold do 0.6 i zwieksz limit do 20. Przy nieistotnych wynikach zwieksz threshold do 0.75-0.8.
Wyszukiwanie i Pobieranie
Q11Dlaczego moje wyniki wyszukiwania sa nieistotne?
Zwykle jedno z: 1) namespace pomieszane, 2) za duzo przechowywanych pamieci (szum), 3) threshold za niski, 4) tresc za abstrakcyjna ('lubi rzeczy' vs konkretne fakty). Rozwiazanie: rozdziel namespace, uczyni tresc konkretna, zwieksz threshold.
Wyszukiwanie i Pobieranie
Q12Jakosc wyszukiwania spadla przy rosnacych pamieciach. Co robic?
Dodaj scoring waznosci i zachowaj tylko wazne pamieci. Uzyj TTL do automatycznego wygasania starych pamieci. Okresowo lacz podobne pamieci w streszczenia. Rozdziel namespace aby zmniejszyc zakres wyszukiwania.
Wyszukiwanie i Pobieranie
Q13Jak powinienem uzywac /api/extract?
Zalecany przeplyw: 1) Wywolaj z auto_store=false aby podejrzec wyekstrahowane pamieci. 2) Pokaz wyniki uzytkownikowi do potwierdzenia. 3) Przechowuj tylko zatwierdzone pamieci. 4) Gdy jakosc ekstrakcji zostanie udowodniona, przejdz na auto_store=true dla automatyzacji.
Ekstrakcja
Q14Jaka jest roznica miedzy model=haiku a model=sonnet?
haiku: Szybszy, tanszy, dobry dla wiekszosci przypadkow. sonnet: Dokladniejszy, lepszy dla waznych ekstrakcji (onboarding, umowy, polityki). Uzyj haiku do masowej/poczatkowej ekstrakcji, sonnet do scenariuszy wysokiego ryzyka.
Ekstrakcja
Q15Czy moge modyfikowac pamiec po zapisaniu?
Tak, ale zalecany wzorzec to: utworz nowa pamiec + usun/zarchiwizuj stara. To podejscie jest lepsze dla sciezek audytu i zapobiega problemom regresji.
Operacje
Q16Jak usuwac pamieci?
Dwa podejscia: 1) Usun po ID (precyzyjne), 2) Usun po namespace (masowe czyszczenie). Dla enterprise/zgodnosci zapewnij 'calkowite usuniecie + dziennik audytu'. Jasno udokumentuj swoja polityke usuwania.
Najwieksze czynniki kosztow: 1) Czestotliwosc ekstrakcji - zmniejsz wywolania. 2) Zakres wyszukiwania - uzyj namespace do zawezenia. 3) Wybor modelu - uzyj haiku do rutyny, sonnet do waznych. 4) Caching - cache powtarzajace sie zapytania. 5) Operacje wsadowe gdy mozliwe.
Operacje
Q19Czy moge uzywac klucza API w przegladarce (frontend)?
Niezalecane - wysokie ryzyko ujawnienia klucza. Wywoluj Seizn z serwera (Next.js Route Handler, Cloudflare Worker, funkcja serverless) i pozwol przegladarce wywolywac twoj serwer. Nigdy nie eksponuj kluczy API w kodzie client-side.
Beda chcieli: 1) Zakres danych (co jest/nie jest przechowywane), 2) Szyfrowanie (w spoczynku: AES-256, w tranzycie: TLS), 3) Metoda izolacji tenantow, 4) Polityka usuwania/retencji, 5) Dostep do dziennikow audytu, 6) Polityka rotacji/wygasania kluczy. Prowadz strone Bezpieczenstwo i Governance w dokumentacji.
Bezpieczenstwo i Zgodnosc
Masz jeszcze pytania?
Sprawdz nasza dokumentacje lub skontaktuj sie z zespolem wsparcia.