Blog

Pomnilnik Grok Build med sejami: nastavitve in omejitve

Markdown

Kako omogočiti pomnilnik, kje so shranjeni zapiski ter kako delujejo /flush, /remember, /dream in /memory. Prednostni vrstni red nastavitev, preverjanje in brisanje vnosov.

Preberi celoten članek

Grok Build, terminalski agent podjetja xAI, ima pomnilnik med sejami: zapomni si lahko projektne konvencije, odločitve in uspešne korake odpravljanja napak ter jih nato brez opomnikov doda v kontekst nove seje. Funkcija je privzeto izklopljena in je poskusna — omogočite jo lahko z eno samo nastavitvijo.

Ta opis temelji na uradnem vodniku v repozitoriju xai-org/grok-build na dan 20. septembra 2026. Avtor izvirnega članka izdelka ni zagnal: delovanje je opisano na podlagi dokumentacije, ne osebnega preizkušanja.

Praktične informacije o uporabi Ailoota so na voljo v dokumentaciji.

Kaj omogoča pomnilnik v Grok Buildu?

Ključna ugotovitev

Brez pomnilnika nova seja Grok Build ne prejme nobenih informacij iz prejšnjih sej: ne konvencij, ki ste jih pojasnili, ne odločitev, ki ste jih sprejeli, razen če so zapisane v datoteki z navodili v repozitoriju. Ko je pomnilnik omogočen, agent poišče shranjene zapiske in ustrezne samodejno doda v kontekst nove seje. Zapiski so shranjeni kot običajne datoteke Markdown, ki jih lahko berete in urejate.

V eni seji ste na primer agentu pojasnili, da projekt uporablja zamik z dvema presledkoma, da se migracije podatkovne zbirke izvajajo z ločenim ukazom in da določen modul obravnava plačila. V novi seji morate te informacije podati znova.

Ko je pomnilnik omogočen, lahko Grok Build:

  • prikliče projektne konvencije, ki ste jih pojasnili prej;
  • uporabi korake odpravljanja napak, ki so se že izkazali za uspešne;
  • prenese arhitekturne odločitve v poznejše seje;
  • se izogne ponovnemu spraševanju o že odgovorjenih vprašanjih.

Funkcija je poskusna in privzeto izklopljena. Dokler je ne omogočite, se vedenje agenta ne spremeni.

Kako omogočiti pomnilnik?

Ključna ugotovitev

Za enkratni zagon nastavite okoljsko spremenljivko GROK_MEMORY=1. Če želite, da ostane omogočen, v ~/.grok/config.toml dodajte razdelek [memory] z nastavitvijo enabled = true. Če želite, da se shranjeni zapiski dodajo ob začetku dela, po omogočanju pomnilnika začnite novo sejo z /new.

Enkrat, za en zagon:

GROK_MEMORY=1 grok

Spremenljivka velja samo za ta zagon. Ukaz export GROK_MEMORY=1 ohrani nastavitev v trenutni lupini in omogoči pomnilnik za vse naslednje zagone grok iz te lupine — dokler se terminalska seja ne konča oziroma ne zaženete ukaza export GROK_MEMORY=0.

Trajno, prek konfiguracije. V ~/.grok/config.toml dodajte:

[memory]
enabled = true

Znotraj seje, brez ponovnega zagona: odprite /memory in pritisnite t.

Ta preklop velja samo za trenutno sejo in se ne zapiše v konfiguracijo. Uporabite ga lahko za omogočanje ali onemogočanje pomnilnika. Če ga onemogočite, izgubite dostop do orodij za pomnilnik, vendar se datoteke z diska ne izbrišejo; če ga znova omogočite, se shramba ponovno odpre. Preklop ne more razveljaviti prisilne izključitve pomnilnika za celoten proces prek GROK_MEMORY=0: /memory ostane nedostopen ves čas seje.

Če so nastavitve določene na več mestih, imajo naslednjo prednostno razvrstitev:

  • GROK_MEMORY=0 prisilno onemogoči pomnilnik za celoten proces in ima najvišjo prednost.
  • Izrecni enabled = false v konfiguraciji onemogoči pomnilnik, tudi če ga omogoča upravljana oddaljena nastavitev.
  • Pomnilnik lahko omogočite z GROK_MEMORY=1, z enabled = true v konfiguraciji ali z upravljano oddaljeno nastavitvijo.
  • Če ni določeno nič, je pomnilnik izklopljen.

Zapiski se dodajo v prvem koraku seje. Če ste pomnilnik omogočili sredi dela in želite, da agent začne uporabljati shranjene informacije o projektu, zaženite /new. Ali je pomnilnik omogočen, lahko preverite v izpisu ukaza grok inspect.

Kaj Grok Build beleži in kam?

Ključna ugotovitev

Zapiski so shranjeni v ~/.grok/memory/ kot datoteke Markdown: globalna datoteka MEMORY.md za vse projekte, ločena datoteka MEMORY.md za vsak projekt in dnevniki sej. Samodejni povzetek ob koncu seje se zapiše brez klica modela, podrobni zapiski pa nastanejo z ukazoma /flush in /remember; /dream razvrsti nepovezane vnose po temah.

Struktura imenika ~/.grok/memory/:

LokacijaObsegVsebina
~/.grok/memory/MEMORY.mdGlobalnoDejstva in preference za vse vaše projekte
~/.grok/memory/ + imenik projekta s hashom + /MEMORY.mdProjektKonvencije in kontekst za določen repozitorij
~/.grok/memory/ + imenik projekta s hashom + /sessions/SejePovzetki in dnevniki posameznih sej

Imenu projektnega imenika je dodan kratek hash identifikatorja repozitorija. Za identifikacijo se uporabi oddaljeni repozitorij origin v obliki »organizacija/repozitorij« ali pa pot do imenika, če ni Gitovega repozitorija. Tako kloni in delovna drevesa (ločene delovne kopije Gitovih vej) istega repozitorija uporabljajo skupni pomnilnik projekta: kar si agent zapomni v eni kopiji, je na voljo tudi v drugi.

Vnosi nastanejo na štiri načine:

  1. Samodejni povzetek ob koncu seje. Ko se seja konča, Grok Build shrani kratek servisni povzetek v dnevni dnevnik: število sporočil, do pet prvih vsebinskih izmenjav ter datum in čas. Povzetek se ustvari iz metapodatkov brez klica modela ali zamika. Zelo kratke seje se preskočijo: če je manj kot tri vsebinske izmenjave ali manj kot 50 bajtov vašega besedila, se vnos ne ustvari. Povzetek ne vključuje uporabljenih orodij, poti do datotek ali ukazov. Samodejne povzetke lahko onemogočite z nastavitvijo session.save_on_end = false.
  2. /flush—podroben zapisek na zahtevo. S tem ukazom model povzame najpomembnejše točke trenutne seje: odločitve, vzorce, korake odpravljanja napak in ugotovitve o API-ju. Povzetek se zapiše v dnevnik z datumom in indeksira za prihodnje seje. Dokumentacija priporoča zagon ukaza /flush pred strnitvijo konteksta, ob koncu uspešne seje odpravljanja napak in po odkritju pomembnih vzorcev.
  3. /remember—izrecna zahteva, naj si nekaj zapomni. Vnesite /remember always open PR links after sending ali agentu recite: »zapomni si, da ...«. Pred zapisom vnosa se odpre pregledovalna plošča: zapisek se shrani šele po vaši potrditvi, v viru pa se prikaže Memory saved to ~/.grok/memory/MEMORY.md. Informacije o projektu se shranijo v projektno datoteko MEMORY.md, informacije, ki veljajo za vse projekte, pa v globalno datoteko.
  4. /dream—konsolidacija. Ukaz razvrsti razpršene dnevnike in zapiske po temah ter odstrani podvojene vnose, da so rezultati iskanja natančnejši. Tako kot pri ukazu /flush konsolidacijo izvede model — prebere zbrane vnose in jih preuredi po temah, zato rezultat občasno preglejte z ukazom /memory. Na voljo je tudi samodejni način: privzeto Grok Build preveri pogoje ob zagonu in enkrat na uro ter začne konsolidacijo, ko je minilo vsaj 24 ur in se je zbralo vsaj 5 sej. Pragove lahko nastavite v razdelku [memory.dream] v konfiguraciji.

Zapiski se iščejo prek indeksa SQLite: privzeto uporablja iskanje po celotnem besedilu FTS5, če je nastavljen vektorski model, pa je dodano še semantično vektorsko iskanje.

Kako se pomnilnik prenese v novo sejo?

Ključna ugotovitev

V prvem koraku seje Grok Build poišče vnose v pomnilniku, povezane s projektom, in jih samodejno doda v kontekst — opominjanje ni potrebno. Iskanje se ponovi po samodejni strnitvi konteksta. Starejši vnosi sej so označeni tako, da jih je treba preveriti glede aktualnosti.

Začetno vstavljanje uporablja prag izbire min_score = 0.9, ki ga lahko spremenite v razdelku [memory.initial_injection]. Po samodejni strnitvi konteksta agent znova poišče informacije v pomnilniku, da obnovi tiste, ki so bile morda odstranjene iz konteksta skupaj s starejšimi izmenjavami.

Agenta lahko tudi neposredno vprašate: »Česa se spomniš?« Odgovor razvrsti po viru: globalne preference, znanje o projektu in zgodovina sej.

Vnosi sej imajo oznake aktualnosti. Starejši ko je vnos v dnevniku seje, izraziteje je označen z opozorilom: »Preden se zanesete na to, preverite, ali je še vedno aktualno.« Globalne in projektne datoteke MEMORY.md takih oznak ne prejmejo: namenjene so dolgoročni uporabi, zato morate sami spremljati njihovo točnost.

Kako si ogledati, urediti in izbrisati zapiske?

Ključna ugotovitev

Ukaz /memory odpre pregled vseh datotek pomnilnika s predogledi. Datoteke lahko urejate v katerem koli urejevalniku besedila — spremembe bodo uporabljene pri naslednjem iskanju. Zahteva »pozabi ...« ne zagotavlja izbrisa; če želite zanesljivo odstraniti določen vnos, uredite datoteko.

Ukaz /memory v seji odpre okno z vsemi datotekami pomnilnika, razvrščenimi po obsegu: globalno, projektno in seje (v obratnem kronološkem vrstnem redu). Seznam datotek je na levi, predogled izbrane datoteke samo za branje pa na desni.

Uporabne tipke v pregledu:

TipkaDejanje
↑/↓ ali j/kPremikanje po seznamu
/Filtriranje seznama
yKopiranje poti do izbrane datoteke
xBrisanje izbranega zapiska (za potrditev pritisnite še enkrat)
tOmogočanje ali onemogočanje pomnilnika
EscZapiranje okna

V oknu lahko izbrišete posamezne zapiske in datoteke sej; ustvarjenih indeksov MEMORY.md (globalnega in projektnega) ni mogoče izbrisati.

Drugi način je neposredno urejanje datotek. Nahajajo se v ~/.grok/memory/ in jih lahko odprete s katerim koli urejevalnikom. Spremembe v imeniku se spremljajo: nove in spremenjene datoteke se znova indeksirajo, izbrisane datoteke pa se ob naslednjem iskanju odstranijo iz indeksa.

Zahteva »pozabi na snake_case« ne zagotavlja izbrisa: model poišče in odstrani ustrezne vnose, vendar lahko katerega spregleda. Če želite zagotoviti izbris, odprite datoteko (njeno pot lahko preprosto kopirate s tipko y v oknu /memory) in ročno odstranite vnos. Pomnilnik lahko v celoti počistite v ukazni vrstici: grok memory clear za projektni pomnilnik, grok memory clear --global za globalni pomnilnik in grok memory clear --all za oboje.

Kako se pomnilnik razlikuje od datoteke z navodili za repozitorij?

Ključna ugotovitev

Napišete datoteko z navodili, kot sta CLAUDE.md ali AGENTS.md, in jo dodate v repozitorij — prek Gita jo delite z ekipo. Agent Grok Build vzdržuje zapiske v pomnilniku in jih shranjuje zunaj repozitorija, v ~/.grok/memory/: zapiski so osebni in se ne delijo prek Gita.

Navodilo v repozitoriju je v skupni rabi z vsemi, ki delajo na projektu, in je vidno v kodi ter zgodovini sprememb. Pomnilnik se dopolnjuje med sejami, shranjen je v vašem računalniku in se ne objavi samodejno.

Pomnilnik ne nadomesti datoteke z navodili. Splošna projektna pravila, ki jih potrebuje celotna ekipa in vsak agent, so še vedno smiselna v repozitoriju. Imamo ločen vodnik o uporabi ene datoteke z navodili za Claude Code, Codex in Cursor: AGENTS.md in CLAUDE.md skupaj. Pomnilnik ohranja osebni kontekst: vaše preference, kaj ste že poskusili in do katere odločitve ste prišli.

Claude uporablja podobno razlikovanje: v članku Claudeov pomnilnik in CLAUDE.md pojasnjujemo, kako se pomnilnik razlikuje od datoteke CLAUDE.md. Primerjavo samih orodij najdete v članku Grok Build ali Claude Code.

Omejitve in preverjanje, ali pomnilnik deluje

Ključna ugotovitev

Funkcija je poskusna: ukazi in nastavitve se lahko spremenijo. Če želite, da se zapiski po omogočanju pomnilnika dodajo v prvem koraku, začnite novo sejo z /new. Nekatere vnose ustvari model, zato zapiske občasno preglejte in mu naročite, naj si ne zapomni skrivnosti.

Upoštevajte naslednje omejitve:

  • Poskusna funkcija. Ukazi, pragovi in vedenje se lahko v prihodnjih različicah spremenijo; če kaj ne deluje po pričakovanjih, preverite vodnik za pomnilnik v repozitoriju.
  • Začetno vstavljanje v novo sejo. Po omogočanju pomnilnika začnite delo z /new, da bodo shranjeni zapiski dodani v prvem koraku.
  • Model presodi, kaj je pomembno. Model pripravi povzetek /flush in izbere, kaj bo vključeno v zapisek. Vsak teden ali dva odprite /memory in preglejte zbrane zapiske; izbrišite vse, kar ni potrebno.
  • Ne naročajte mu, naj si zapomni skrivnosti. Ključi, žetoni in gesla ne sodijo v dolgoročne zapiske: datoteke v ~/.grok/memory/ so shranjene kot navadno besedilo. Če se zabeleži kaj občutljivega, to odstranite z urejanjem datoteke.
  • Projektni pomnilnik je v skupni rabi med kopijami repozitorija. Če si agent v enem klonu zapomni nekaj, kar je za drugega zastarelo, pri čiščenju upoštevajte, da je imenik v skupni rabi.

Če pomnilnik ne deluje:

  1. V izpisu ukaza grok inspect preverite, ali je pomnilnik omogočen.
  2. Preverite, ali ga onemogočata GROK_MEMORY=0 ali konfiguracija.
  3. Za diagnostiko zaženite RUST_LOG=debug GROK_LOG_FILE=/tmp/grok.log grok in v datoteki /tmp/grok.log preverite vrstice o pomnilniku.

Kratek povzetek

Pomnilnik Grok Build omogočite z GROK_MEMORY=1 ali z nastavitvijo [memory] enabled = true v ~/.grok/config.toml. Če želite, da se zapiski po omogočanju prvič dodajo, začnite novo sejo z /new. Agent zapisuje zapiske v ~/.grok/memory/: povzetke sej brez klica modela, podrobne povzetke z /flush, izrecne vnose z /remember po vaši potrditvi in urejene teme z /dream. Zapiske si lahko ogledate in jih počistite prek ukaza /memory ter z neposrednim urejanjem datotek. Funkcija je poskusna, zato pragove in ukaze preverite v uradnem vodniku, zapiske pa redno pregledujte.

Viri

Grok Build, uradni vodnik »Cross-Session Memory« (uporabniški vodnik, poglavje 13): https://github.com/xai-org/grok-build/blob/main/crates/codegen/xai-grok-pager/docs/user-guide/13-memory.md

Grok Build, repozitorij podjetja xAI na GitHubu: https://github.com/xai-org/grok-build

Odprite Ailoot.

Več podrobnosti

Vprašanja in odgovori: Pomnilnik Grok Build med sejami: nastavitve in omejitve

Zakaj se shranjeni zapiski po vklopu pomnilnika ne prikažejo?

Shranjeni zapiski se dodajo pri prvem obratu nove seje. Po vklopu pomnilnika začnite novo sejo in poročano stanje preverite z grok inspect; proces, zagnan z GROK_MEMORY=0, ga ne more vklopiti s stikalom v seji.

Ali izklop pomnilnika izbriše njegove datoteke?

Ne. Izklop odstrani dostop do njegovih orodij, zapiske Markdown pa pusti na disku. Če morate odstraniti vnos, shranjene zapiske preglejte ali uredite posebej.

Vsi članki