# Szybki start dla agentów LLM
SUMMARY: W 3 wywołaniach API: recall wszystkich wspomnień, zapis nowego, wyszukiwanie. Niezbędny przepływ LLM.

KEY CONTEXT:
Base URL: https://synapse.schaefer.zone
Auth: Authorization: Bearer YOUR_MIND_KEY (header, required — ?key= DISABLED by default, AUTH_QUERY_KEY_MODE=deny hardened default; 401 + hint)
ALWAYS call /memory/recall at the start of every session.
Wichtigste Befehle: GET /memory/recall, POST /memory, GET /memory/search?q=...
Categories: identity, preference, fact, project, skill, mistake, context, note, credentials
Priorities: low, normal, high, critical
FTS5 search: multiple words = AND, "phrases" in quotes, prefix* for prefix search

Szybki start dla agentów LLM
Między sesjami tracisz całą pamięć. Synapse jest twoim zewnętrznym mózgiem. Ten
przewodnik pokazuje trzy niezbędne wywołania API, które musi znać każdy agent LLM.
> [!CRITICAL]
> Należy wywołać  na POCZĄTKU KAŻDEJ sesji.
> Bez tego wywołania agent nie ma pamięci o tym, kim jest użytkownik, co obiecał
> ani nad czym pracował ostatnio.
Krok 1: Recall wszystkich wspomnień (ZAWSZE NAJPIERW)
[CODE BLOCK]
Zwraca ustrukturyzowane, tekstowe podsumowanie wszystkich zapisanych wspomnień.
Należy je przeanalizować, aby odbudować model mentalny użytkownika, jego projektów
i przeszłych interakcji.
Przykładowa odpowiedź:
[CODE BLOCK]
Krok 2: Zapis nowego wspomnienia
Gdy poznasz coś warte zapamiętania:
[CODE BLOCK]
Kategorie: , , , , , , , , 
Priorytety: , , , 
> [!TIP]
> Zawsze należy dołączyć pole  — krótki identyfikator wspomnienia. Pozwala to
> zaktualizować to samo wspomnienie później przez ponowne POST z tym samym kluczem.
Krok 3: Wyszukiwanie konkretnego wspomnienia
[CODE BLOCK]
> [!TIP]
> Składnia FTS5: wiele słów = wyszukiwanie AND. Frazy w cudzysłowach: .
> Wyszukiwanie prefiksem: . Wartość logiczna: .
Narzędzia otwarte (bez nagłówków autoryzacji) — domyślnie wyłączone
Jeśli narzędzie potrafi tylko otwierać URL-e (bez własnych nagłówków): parametr  jest
wyłączony przez utwardzony domyślny  — API jest tylko Bearer,
a  odpowiada 401 i wskazówką "Query-param auth (?key=) is disabled". Tylko jeśli operator jawnie ustawi :
[CODE BLOCK]
> [!WARNING]
> Tylko w trybie allow  jest ograniczone do 60 żądań/minutę. Zewnętrzne klienty Bearer otrzymują
> 120 req/min na tożsamość; zaufane sieci wewnętrzne są bez limitu. Preferuj nagłówek Bearer.
Pełny przepływ sesji
1. Początek sesji:  — załadowanie wszystkich wspomnień
2. Podczas pracy:  — znalezienie konkretnych faktów
3. Przy nowej informacji:  — zapis (z kategorią, kluczem, tagami, priorytetem)
4. Okresowo:  — sprawdzenie wiadomości od człowieka
5. Koniec sesji: Zapis końcowych ustaleń przez 
Typowe wzorce
Aktualizacja istniejącego wspomnienia
Wykonać POST  z tym samym  i  — istniejące wspomnienie
jest aktualizowane, a nie duplikowane.
Zapis statusu projektu
[CODE BLOCK]
Zapis błędu (aby go nie powtórzyć)
[CODE BLOCK]
Sprawdzanie wiadomości od człowieka
[CODE BLOCK]
Zwraca nieprzeczytane wiadomości od człowieka. Odpowiedź przez:
[CODE BLOCK]
Następne kroki
- Autoryzacja — Mind Key vs JWT
- Dokumentacja Memory API — wszystkie 22 endpointy pamięci
- Chat API — asynchroniczna komunikacja z ludźmi
- Książka kucharska LLM — praktyczne wzorce