📖 Uživatelská příručka

Laický průvodce pro Martina (a každého, kdo nechce číst kód)

Verze 1.2 · aktualizováno 2026-06-10

Ptát se a hledat

Second Brain umí dva režimy: hledání (najde kousky textu) a odpověď (sestaví souhrn z tvých dat).


Kdy použít co

Chceš Použij Příklad
Najít poznámku /search nebo „najdi v poznámkách…“ „search projekt Raw Future“
Konkrétní číslo normální otázka „Kolik jsem utratil za dopravu v dubnu?“
Stres / spánek / kroky normální otázka „Jaký průměrný stres za poslední týden?“
Naběhané km normální otázka „Kolik km jsem naběhal v květnu?“
Souvislosti napříč oblastmi analytický dotaz „Analyzuj spánek a jídlo poslední 3 měsíce“
Obecné shrnutí /ask „Co vím o produktivitě?“

Hybridní směrování dotazů

Před odpovědí systém zvolí zdroj:

  1. Pravidla — rychle rozpozná typ (finance, Garmin stres, email…).
  2. LLM směrovač — u nejednoznačné věty vybere službu podle toho, co je na serveru zapnuté (kalendář, Poste email, Penízky…).
  3. Handler — spočítá nebo načte data (bez halucinací u čísel).

Nemusíš pamatovat syntaxi — stačí česky. Příkazy /ask, /email, /kalendar jsou volitelné zkratky.


Odpovědi s citacemi

U dotazů z vaultu bot často ukáže odkud to vzal — cesta k souboru v trezoru.

To je záměr: můžeš si ověřit, že AI nefantazírovala.


Přesná čísla vs. odhad

Oblast Jak to funguje
Penízky (finance) Počítá se z transakcí v databázi — přesně
Garmin (stres, spánek, km) Z domain_records po syncu — přesně u přímých dotazů
Obecné poznámky AI hledá v textu — může něco přehlédnout

Když sync nestihl nové záznamy, čísla budou starší. Stav: /projekty nebo web app.


Vault agent (obecné dotazy)

U /ask a volných otázek nad poznámkami (ne finance/Garmin) běží agentní smyčka:

  1. Dostane mapu složek vaultu (20_projects/, 40_health/, 10_inbox/…).
  2. Přesný text → grep v souborech.
  3. Mlhavý význam → embedding search jako záchranná síť.
  4. Přečte soubor a odpoví s citacemi cest.

Doporučený model: Claude (Anthropic API)ANTHROPIC_API_KEY v brain.env. Flash/Gemini nech na rutinní věci.

Vypnout: VAULT_AGENT_ENABLED=false (vrátí se klasický jednorázový RAG).


Cross-domain analýza

Když napíšeš „analyzuj souvislosti spánku a jídla“, systém načte tabulky za období, spočítá korelace a pošle dataset modelu k interpretaci.

Cross-domain = napříč oblastmi (zdraví × finance × sport).


Tipy pro dobré dotazy


Co systém neumí (zatím)