Navigace
ELOWEN · Dokumentace

Poslední aktualizace: 20. října 2026

Procházet dokumentaci · Paměť a embeddingy
Každodenní práce

Paměť a embeddingy

Paměť uchovává užitečné údaje napříč konverzacemi, například preference, rozhodnutí a podrobnosti o projektu. Není to přepis konverzace. Pracovní prostor Paměť otevřete na adrese /memory, kde uložené vzpomínky hledáte a spravujete; v podporovaných chatech můžete používat také nástroje paměti, například MemorySearch.

Paměť je soukromá pro Váš účet, pokud administrátor nenastavil sdílený fond Projektu. Vzpomínky ve fondu Projektu jsou dostupné oprávněným členům, dokud v daném Projektu pracují. Členové sdíleného fondu mohou spravovat dostupné vzpomínky, ale sdílenou kategorii může měnit nebo mazat jen administrátor. Nástroje pro vytváření kategorií a nové roztřídění se týkají Vaší osobní paměti, nikoli sdíleného fondu. Osobní nástroje paměti nejsou dostupné nepřipojeným odesílatelům z platforem ani pracovníkům delegovaných úkolů.

Automatické vybavování

Elowen může hledat v paměti na začátku tahu a, je-li to zapnuté, znovu i během práce. Obě volby jsou ve výchozím stavu zapnuté. Změníte je v Účet → Paměť: Automatické vyhledávání vzpomínek obsahuje volbu Vyhledávat v paměti po každé zprávě a Vyhledávání při přípravě odpovědi obsahuje volbu Znovu vyhledat vzpomínky během přípravy odpovědi. Nastavení vybavování se načítá pro každý tah, takže se změny projeví u další práce bez restartu Elowen.

Je-li nakonfigurovaný model embeddingů, hledání vychází z významu. Jinak Elowen porovnává klíčová slova a aktuálnost. Automatické vybavování na začátku tahu ve výchozím stavu vrátí nejvýše 10 vzpomínek v rozpočtu 20 000 bajtů. Na hledání k původní zprávě čeká nejvýše 5 sekund, pak odpověď spustí bez něj; výsledky, které dorazí později, se předají při dalším volání modelu, případně v následujícím tahu, pokud tento tah už další volání nemá. Používá se přitom stejné hledání. Administrátor může čekání změnit od 0 do 30 sekund v Nastavení → <assistant name> AI → Limity volbou Čekání na vzpomínky na začátku tahu; hodnota 0 znamená, že se na první odpověď nečeká nikdy. Prah relevance paměti a prahy duplicit najdete v Nastavení → <assistant name> AI → Běh.

Průběžné vybavování hledá znovu, když Elowen prochází soubory, nástroje a chyby. Běží na pozadí a výsledky může přidat do některého z dalších volání modelu. Jeho výchozí hodnoty a rozsahy pro celou instanci jsou:

Nastavení (Nastavení → <assistant name> AI → Limity) Výchozí Rozsah
Počet hledání během práce 10 0–20
Počet vzpomínek v jedné dávce během práce 2 0–10
Rozpočet na tah pro vzpomínky načtené během práce 20 000 bajtů UTF-8 10 000–40 000

Hodnota 0 u volby Počet hledání během práce průběžné vybavování vypne; vypne ho i hodnota 0 u volby Počet vzpomínek v jedné dávce během práce. Každé hledání přeskočí vzpomínky, které Elowen už vidí, a Počet hledání během práce omezuje počet požadavků na embeddingy, které smí smyčka nástrojů odeslat. Nová řídicí zpráva rozpočet obnoví. Hledat můžete také přímo nástrojem MemorySearch, který ve výchozím stavu vrací nejvýše 6 výsledků.

Automatické ukládání

Když je v Účet → Paměť → Automatické ukládání zapnutá volba Ukládat nové vzpomínky po každé odpovědi, může průchod na pozadí po každé odpovědi uložit trvalé nové údaje z výměny, upravit vzpomínky, které se změnily, sloučit duplicity nebo smazat vzpomínky, které už neplatí. Ve výchozím stavu je vypnuté. Jedna výměna smí změnit nejvýše 2 vzpomínky; administrátor nastavuje Nejvyšší počet změn vzpomínek na jednu výměnu (0–6) v Nastavení → <assistant name> AI → Běh a hodnota 0 automatické ukládání vypne. Nástroje paměti fungují v obou případech. Průchod používá pomocný model, takže bez nakonfigurovaného pomocného modelu nic nedělá.

Automatická údržba paměti

Elowen umí vzpomínky slučovat také na pozadí: průchod údržby sloučí podobné poznámky, opraví zastaralé údaje a zkrátí texty, aby zůstaly užitečné. Ve výchozím stavu je vypnutá. Zapnete ji v Účet → Paměť → Automatická údržba paměti; dokud je vypnutá, nic neběží samo.

Průchod se spustí, až od posledního průchodu uplyne dost času a dost dalších Vašich konverzací bude mít dokončenou výměnu. Spustit nyní zahájí průchod okamžitě a tyto podmínky ignoruje. Model údržby určuje, který model průchod použije; ve výchozím stavu je to model konverzace, ze které průchod vychází. Průchody pracují jen s Vašimi osobními vzpomínkami, nikdy se sdíleným fondem Projektu. S oprávněními účtu může průchod také vytvářet, mazat nebo znovu třídit Vaše kategorie, aby vzpomínky zůstaly dohledatelné; smazáním kategorie její vzpomínky zůstanou nezařazené, takže se nebudou vybavovat, dokud je něco znovu neroztřídí. Vzpomínku nikdy neodstraní trvale: průchod je může sloučit, přepsat nebo přesunout do koše, odkud je můžete obnovit.

Proběhlé údržby pod přepínačem vypisují každý průchod: čas, zda proběhl automaticky nebo na Váš pokyn, model, počty přidaných, upravených, sloučených a smazaných vzpomínek i to, co změnil. Otevřením průchodu uvidíte stav každé dotčené vzpomínky před změnou a po ní. Zastavit ukončí běžící průchod. Zpracovaná vzpomínka se označí jako zkontrolovaná, takže příští průchod se nejdřív podívá na ostatní; vlastní úprava vzpomínky nebo změna provedená údržbou ji znovu zpřístupní.

Administrátor nastavuje, jak dlouho musí být účet v klidu a kolik dalších konverzací musí být aktivních, v Nastavení → <assistant name> AI → Běh (volby Slučování vzpomínek: hodiny od posledního průchodu a Slučování vzpomínek: konverzace od posledního průchodu).

Učení opakovatelných postupů

Fakta patří do paměti, opakovatelné postupy do skillů. Je-li zapnutý plugin Skills a máte oprávnění vytvářet skilly, nabízí Účet → Paměť také automatické učení skillů. Ve výchozím stavu je vypnuté a týká se jen úspěšných osobních tahů ve webovém rozhraní a v CLI, nikoli naplánované práce, sdílených kanálů, přímých zpráv z platforem ani řízených tahů.

Plugin Skills pravidelně kontroluje dokončenou práci a hledá opakovatelný postup. Nově naučený skill je běžný osobní skill a je dostupný stejně jako skill, který jste si uložili sami; žádné schvalování neprobíhá. Kontrola může později vylepšit jen skilly, které sama napsala, nikdy ten, který jste napsali nebo upravili Vy. Vychází z kontextu dokončené konverzace se stejným modelem a účtem poskytovatele a její využití modelu se účtuje Vašemu účtu. Kontrola se může přeskočit, pokud nelze přesný požadavek konverzace bezpečně rozšířit, není dostupná kapacita nebo je týdenní limit předplatného vyčerpaný alespoň z 90 % či neznámý. Počet pak zůstává čekat na pozdější způsobilou výměnu. Administrátoři nastavují tři limity v Nastavení → <assistant name> AI → Běh: Nejméně volání nástrojů pro kontrolu skillů (1–200, výchozí 1) určuje, kolik úspěšných volání nástrojů musí jedna výměna mít, aby se vůbec počítala; Kontrola skillů po každých N voláních nástrojů (1–200, výchozí 100; Vámi výslovně uložený interval zůstává beze změny) určuje, na kolik takových volání se započítané výměny musí sečíst, než se kontrola spustí; Nejvyšší počet změn skillů na jednu výměnu (0–6, výchozí 1) omezuje zápisy skillů, které smí jedna kontrola navrhnout, a hodnota 0 učení vypne všem.

Správa vzpomínek

V pracovním prostoru Paměť vzpomínky hledáte, filtrujete, řadíte a prohlížíte a pak je vytváříte, upravujete, zařazujete do kategorií, slučujete, obnovujete nebo mažete. Filtry stavu a kategorie Vám pomohou soustředit se na aktivní nebo smazané záznamy. Kromě zobrazení Seznam nabízí také zobrazení Mapa. Smazané vzpomínky se přesunou do koše, odkud je lze obnovit nebo trvale odstranit.

Každá vzpomínka má samostatný text, druh, například user, feedback, project nebo reference, důležitost od 1 do 10 (výchozí 5) a kategorii. Vzpomínky bez kategorie se uloží, ale nelze je vybavit.

Důležitost vyjadřuje, co by zapomenutí údaje stálo, ne jak je jistý nebo čerstvý: 1 je drobná výhoda, 3 úzký odkaz, 5 běžný trvalý údaj nebo preference, 7 důležité rozhodnutí či omezení platné pro několik úkolů, 9 kritické omezení nebo opakovaná lekce ze selhání a 10 výjimečná hranice bezpečnosti, práva nebo vlastnictví. Každá úroveň slábne, když se nepoužívá; vyšší úroveň slábne pomaleji.

Nástroje paměti

Samostatný příkaz elowen memory neexistuje. V podporovaných relacích Elowen můžete používat tyto nástroje:

Nástroj Použití
MemorySearch(query, limit?) Najde relevantní vzpomínky. Výchozí limit: 6.
MemoryAdd(content, kind?, importance?) Uloží jeden trvalý údaj. Důležitost 1–10, výchozí 5.
MemoryUpdate(id, content?, kind?, importance?) Opraví vzpomínku nebo změní její důležitost (1–10).
MemoryMerge(ids, content) Nahradí několik vzpomínek jednou sloučenou vzpomínkou.
MemoryDelete(id) Přesune vzpomínku do koše.
MemoryListRecent(limit?) Vypíše nejnovější vzpomínky. Výchozí limit: 10.
MemoryCategories() Vypíše kategorie.
MemoryCategoryCreate(name, description?, icon?) Vytvoří kategorii.
MemoryCategoryDelete(id) Smaže kategorii a její vzpomínky nechá bez kategorie.
MemoryRecategorize(all?) Zařadí vzpomínky bez kategorie; all: true projde všechny vzpomínky.

MemoryAdd vzpomínku uloží, i když se podobá existující. Zkontrolujte ohlášenou shodu a rozhodněte, zda ponechat obě, jednu upravit, sloučit je, nebo jednu smazat.

Kategorie a paměť Projektu

Kategorie drží vzpomínky v pořádku a určují, které z nich lze vybavit. Dejte každé kategorii užitečný název a konkrétní popis, například:

Deployment layout, service topology, DNS records, and hosting details. No secrets.

Kategorii můžete ve správci kategorií na adrese /memory svázat s Projektem; kategorie svázaná s Projektem se vybavuje jen v něm. Globální kategorie jsou dostupné v každém Projektu, mimo Projekt jsou způsobilé jen globální kategorie. Sdílený fond Projektu mohou vybavovat oprávnění členové daného Projektu.

Nové vzpomínky se zařazují na pozadí. Automatické zařazování používá pomocný model. Administrátor ho nastavuje v Nastavení → Modely → Role modelů → Pomocný model; bez něj se nové vzpomínky automaticky netřídí. Pokud zařazení selže nebo se nehodí žádná kategorie, vzpomínka zůstane uložená, ale nevybavuje se. V Projektu lze použít kategorii Projektu, když se nehodí žádná jiná. MemoryRecategorize zpracovává Vaše osobní vzpomínky, nikoli sdílený fond Projektu.

Při zapnutém automatickém ukládání průchod po každé odpovědi vytěží z výměny trvalé údaje, jak popisuje část Automatické ukládání. Běží na pozadí a bez nakonfigurovaného pomocného modelu nic nedělá.

Smazáním kategorie se její vzpomínky nesmažou, ale nebudou se vybavovat, dokud je znovu něco nezařadí. Trvalé smazání vzpomínek nelze vrátit.

Retence paměti

Vzpomínky mají skóre vitality od 0 do 100. Vybavení vzpomínky zvyšuje signál o jejím používání; nepoužívané vzpomínky slábnou podle důležitosti. Slábne každá úroveň a každou úroveň lze nakonec přesunout do koše; trvalé připnutí neexistuje. Výchozí poločasy pro důležitost 1 až 10 jsou 1, 3, 7, 14, 21, 30, 45, 60, 90 a 180 dní. I úroveň 10 klesne pod výchozí práh po přibližně 418 dnech (zhruba 14 měsících) bez jediného vybavení. Vzpomínka, která se nikdy nevybavila, začíná na 50, tedy na polovině plné vitality, takže u úrovně 10 trvá přibližně 2,3 poločasu, než z 50 klesne na výchozí práh 10. Detail vzpomínky ukazuje datum, kdy se vzpomínka stane způsobilou, ať je jakkoli daleko.

Automatická retence je ve výchozím stavu zapnutá. Po čtrnáctidenní ochranné lhůtě denní úklid přesune vzpomínky pod vitalitou 10 do koše, ve výchozím stavu nejvýše 5 vzpomínek na účet za libovolných 24 hodin; ostatní počkají na další úklid. Limit se počítá z auditovaných automatických smazání, takže restart ho neresetuje. Administrátor může retenci změnit v Nastavení → <assistant name> AI → Retence paměti: ochrannou lhůtu 0–365 dní, minimální hodnotu vzpomínky 1–90, denní limit přesunu do koše 1–200 a poločasy 0,1–365 dní pro každou z deseti úrovní. Nula se u minimální hodnoty ani u žádného poločasu nepřijímá. Hlavní vypínač zcela pozastaví automatické odstraňování. Vzpomínky přesunuté do koše lze obnovit (obnovení vitalitu neosvěží, proto při opravě chyby retenci pozastavte); trvalé odstranění vrátit nelze. Ve sdíleném fondu Projektu může vzpomínku trvale odstranit každý člen, který ji smí číst, bez ohledu na to, kdo ji napsal.

Přeindexování a nové roztřídění

Pokud změníte model embeddingů, obnovte index paměti, aby hledání používalo vektory z nového modelu. V pracovním prostoru Paměť otevřete část Údržba paměti. Řádek Znovu vytvořit index vzpomínek vyžaduje model embeddingů. Řádek Znovu roztřídit vzpomínky vyžaduje pomocný model a nabízí volby Zařadit vzpomínky bez kategorie a Znovu roztřídit všechny vzpomínky; druhá z nich nejdřív požádá o potvrzení. Úlohy pokračují na pozadí, ukazují průběh a počet selhání a jsou soukromé pro Váš účet. Podrobnosti k jednotlivým selháním se zapisují do logů služby. Spuštění úlohy, která už běží, vrátí tuto úlohu místo vytvoření duplikátu.

Zařadit vzpomínky bez kategorie můžete také nástrojem MemoryRecategorize. Volbu all: true použijte jen tehdy, když chcete zkontrolovat i stávající zařazení. Nové roztřídění každou vzpomínku před uložením zkontroluje, takže ruční změna kategorie provedená během běhu se nepřepíše.

Nastavení embeddingů

Administrátor nastavuje poskytovatele a model embeddingů v Nastavení → Modely → Role modelů v polích Poskytovatel embeddingů, Model embeddingů a Dimenze. Výchozí hodnota je prázdná, takže sémantické hledání v paměti není dostupné, dokud model embeddingů nenakonfigurujete. Fungující nastavení potřebuje název modelu a nakonfigurovaného poskytovatele. Poskytovatel musí být buď poskytovatel s klíčem API, nebo propojený účet OAuth, jehož seznam modelů označuje daný model jako poskytující embeddingy, například účet OpenRouter, jehož seznam obsahuje model embeddingů. Pokud to poskytovatel podporuje, lze nastavit i volitelnou dimenzi vektoru; ponechte ji prázdnou, chcete-li použít výchozí velikost vektoru daného modelu.

Průvodce nastavením umí znovu použít existujícího poskytovatele nebo nakonfigurovat OpenRouter:

elowen setup --memory reuse --embedding-model text-embedding-3-small

Další volby nastavení jsou --memory openrouter a --memory skip; --memory-key předá klíč OpenRouter a --skip-test přeskočí testovací běh agenta. Připravenost paměti ověříte příkazem elowen doctor.

Soukromí a správná hygiena paměti

Neukládejte hesla, tokeny, klíče API ani jiné tajné údaje. Výslovné nástroje paměti je nefiltrují.

  • Ukládejte jeden samostatný údaj, ne výňatek z konverzace.
  • Uchovávejte důvod rozhodnutí, ne jen volbu.
  • Když se údaj změní, použijte MemoryUpdate; na duplicity MemoryMerge.
  • Než se na vybavenou vzpomínku spolehnete, ověřte soubory, nastavení a stav mimo Elowen.

Další: Spotřeba a náklady