Grok Build-memória munkamenetek között: beállítások és korlátozások

A Grok Build, az xAI terminálügynöke, rendelkezik munkamenetek közötti memóriával: képes megjegyezni a projektkonvenciókat, döntéseket és a sikeres hibakeresési lépéseket, majd emlékeztetés nélkül hozzáadni ezeket egy új munkamenet kontextusához. A funkció alapértelmezés szerint ki van kapcsolva, és kísérleti jellegű — egyetlen beállítással engedélyezhető.

Ez a leírás az xai-org/grok-build adattár hivatalos útmutatóján alapul, 2026. szeptember 20-i állapot szerint. Az eredeti cikk szerzője nem futtatta a terméket: a működést a dokumentáció alapján ismertette, nem saját tesztelésből.

Az Ailoot használatával kapcsolatos gyakorlati információk a dokumentációban találhatók.

Mire jó a memória a Grok Buildben?#

Például az egyik munkamenetben elmagyarázta az ügynöknek, hogy a projekt két szóközös behúzást használ, az adatbázis-migrációk külön paranccsal futnak, és egy adott modul kezeli a fizetéseket. Egy új munkamenetben ezt az információt ismét meg kell adnia.

Engedélyezett memóriával a Grok Build képes:

• felidézni a korábban elmagyarázott projektkonvenciókat;
• felhasználni a már bevált hibakeresési lépéseket;
• továbbvinni az építészeti döntéseket a későbbi munkamenetekbe;
• elkerülni, hogy újra rákérdezzen a már megválaszolt dolgokra.

A funkció kísérleti jellegű, és alapértelmezés szerint ki van kapcsolva. Amíg nem engedélyezi, az ügynök viselkedése nem változik.

Hogyan engedélyezhető a memória?#

Egyszer, egyetlen futtatáshoz:

GROK_MEMORY=1 grok

A változó csak erre a futtatásra érvényes. Az export GROK_MEMORY=1 parancs beállítja a változót az aktuális shellben, és bekapcsolja a memóriát az abból a shellből indított összes későbbi grok futtatásnál — amíg a terminál munkamenete véget nem ér, vagy le nem futtatja az export GROK_MEMORY=0 parancsot.

Tartósan, a konfiguráción keresztül. Adja hozzá ezt a ~/.grok/config.toml fájlhoz:

[memory]
enabled = true

Munkameneten belül, újraindítás nélkül: nyissa meg a /memory parancsot, és nyomja meg a t billentyűt.

Ez a kapcsoló csak az aktuális munkamenetre vonatkozik, és nem kerül be a konfigurációba. A memória be- vagy kikapcsolására használható. Kikapcsolásakor megszűnik a memóriaeszközökhöz való hozzáférés, de a fájlok nem törlődnek a lemezről; újbóli bekapcsolásakor a tárhely ismét elérhetővé válik. A kapcsoló nem írhatja felül a teljes folyamatra vonatkozó, GROK_MEMORY=0 által kényszerített memóriakikapcsolást: a /memory a teljes munkamenet során nem lesz elérhető.

Ha a beállítások több helyen is meg vannak adva, a következő prioritási sorrend érvényes:

• A GROK_MEMORY=0 kényszerítetten letiltja a memóriát a teljes folyamatra, és ez élvez elsőbbséget.
• A konfigurációban kifejezetten megadott enabled = false letiltja a memóriát akkor is, ha egy felügyelt távoli beállítás engedélyezi.
• A memória a GROK_MEMORY=1, a konfigurációban megadott enabled = true vagy egy felügyelt távoli beállítás segítségével engedélyezhető.
• Ha nincs megadva semmi, a memória ki van kapcsolva.

A jegyzetek a munkamenet első fordulójában kerülnek hozzáadásra. Ha munka közben engedélyezte a memóriát, és azt szeretné, hogy az ügynök elkezdje használni a mentett projektinformációkat, futtassa a /new parancsot. A grok inspect kimenetében ellenőrizheti, hogy engedélyezve van-e a memória.

Mit rögzít a Grok Build, és hol?#

A ~/.grok/memory/ könyvtár felépítése:

A projektkönyvtár nevéhez hozzáfűződik az adattárazonosító rövid hash-e. Az azonosításhoz az origin távoli adattár „szervezet/adattár” formátumát használja, vagy — ha nincs Git-adattár — a könyvtár elérési útját. Így ugyanannak az adattárnak a klónjai és munkafái (a Git-ágak különálló munkapéldányai) közös projektmemóriát használnak: amit az ügynök az egyik példányban megjegyez, az a másikban is elérhető.

A bejegyzések négyféleképpen jönnek létre:

1. Automatikus, munkamenet végi összefoglaló. A munkamenet végén a Grok Build egy rövid szolgáltatási összefoglalót ment a napi naplóba: az üzenetek számát, legfeljebb az első öt érdemi váltást, valamint a dátumot és az időt. Az összefoglaló metaadatokból, modellhívás és késleltetés nélkül készül. A nagyon rövid munkamenetek kimaradnak: ha háromnál kevesebb érdemi váltás történt, vagy az Ön szövege kevesebb mint 50 bájt, nem jön létre bejegyzés. Az összefoglaló nem tartalmazza a használt eszközöket, fájlelérési utakat vagy parancsokat. Az automatikus összefoglalók a session.save_on_end = false beállítással tilthatók le.
2. /flush—részletes jegyzet kérésre. Ezzel a paranccsal a modell összefoglalja az aktuális munkamenet legfontosabb pontjait: a döntéseket, mintákat, hibakeresési lépéseket és API-val kapcsolatos megállapításokat. Az összefoglaló dátummal ellátott naplóba kerül, és a rendszer indexeli a későbbi munkamenetekhez. A dokumentáció a /flush futtatását javasolja a kontextustömörítés előtt, egy sikeres hibakeresési munkamenet végén, valamint fontos minták felfedezése után.
3. /remember—kifejezett kérés valaminek a megjegyzésére. Írja be, hogy /remember always open PR links after sending, vagy mondja az ügynöknek: „jegyezd meg, hogy...”. A bejegyzés írása előtt megjelenik egy ellenőrző panel: a jegyzet csak az Ön megerősítése után kerül mentésre, a feedben pedig megjelenik a Memory saved to ~/.grok/memory/MEMORY.md szöveg. A projektre vonatkozó információ a projekt MEMORY.md fájljába, az összes projektre érvényes információ pedig a globális fájlba kerül.
4. /dream—konszolidáció. A parancs témák szerint csoportosítja a szétszórt naplókat és jegyzeteket, és eltávolítja a duplikátumokat, hogy pontosabb legyen a keresés. A /flush parancshoz hasonlóan a konszolidációt a modell végzi: elolvassa az összegyűlt bejegyzéseket, majd témák szerint átdolgozza őket, ezért az eredményt érdemes rendszeresen ellenőrizni a /memory paranccsal. Automatikus mód is rendelkezésre áll: alapértelmezés szerint a Grok Build induláskor és óránként egyszer ellenőrzi a feltételeket, és akkor kezdi meg a konszolidációt, ha legalább 24 óra eltelt, és legalább 5 munkamenet összegyűlt. A küszöbértékek a konfiguráció [memory.dream] szakaszában állíthatók be.

A jegyzetek keresése SQLite-indexen keresztül történik: alapértelmezés szerint teljes szöveges FTS5-keresést használ, és ha be van állítva embeddingmodell, szemantikus vektorkereséssel egészül ki.

Hogyan kerül be a memória egy új munkamenetbe?#

A kezdeti beillesztés min_score = 0.9 kiválasztási küszöböt használ, amely a [memory.initial_injection] szakaszban módosítható. Az automatikus kontextustömörítés után az ügynök ismét keres a memóriában, hogy visszaállítsa azokat az információkat, amelyek a régebbi váltásokkal együtt kikerülhettek a kontextusból.

Közvetlenül is megkérdezheti az ügynököt: „Mire emlékszel?” A válaszát forrás szerint csoportosítja: globális beállítások, projekttudás és munkamenet-előzmények.

A munkamenet-bejegyzések elavultsági jelöléseket kapnak. Minél régebbi egy munkamenetnapló bejegyzése, annál hangsúlyosabb jelölést kap: „Mielőtt erre hagyatkozna, ellenőrizze, hogy még érvényes-e.” A globális és a projekt MEMORY.md fájljai nem kapnak ilyen jelölést: tartalmuk hosszú távú használatra készült, ezért Önnek kell figyelnie a pontosságukra.

Hogyan tekintheti meg, szerkesztheti és törölheti a jegyzeteket?#

A munkamenetben kiadott /memory parancs egy ablakot nyit meg az összes memóriával, hatókör szerint csoportosítva: globális, projekt- és munkamenetjegyzetekkel, fordított időrendi sorrendben. A fájllista balra, a kijelölt fájl csak olvasható előnézete jobbra látható.

Hasznos billentyűk az áttekintőben:

Az ablak egyenként törölheti a jegyzeteket és a munkamenetfájlokat; a létrehozott MEMORY.md indexeket (globális és projekt) nem tudja törölni.

A másik módszer a fájlok közvetlen szerkesztése. Ezek a ~/.grok/memory/ könyvtárban találhatók, és bármilyen szerkesztővel megnyithatók. A könyvtár módosításait követi a rendszer: az új és módosított fájlokat újraindexeli, a törölt fájlokat pedig a következő keresés során eltávolítja az indexből.

A „felejtsd el a snake_case-t” kérés nem garantálja az eredményt: a modell megkeresi és eltávolítja az egyező bejegyzéseket, de néhányat elvéthet. A biztos törléshez nyissa meg a fájlt (az elérési útját kényelmesen kimásolhatja a /memory ablakban az y billentyűvel), és távolítsa el kézzel a bejegyzést. A memóriát teljesen törölheti a parancssorból: grok memory clear a projektmemóriához, grok memory clear --global a globális memóriához, valamint grok memory clear --all mindkettőhöz.

Miben különbözik a memória az adattár utasításfájljától?#

Az adattárbeli utasítást mindenki megosztja, aki a projekten dolgozik; az utasítás látható a kódban és a módosítási előzményekben. A memória a munkamenetek során bővül, az Ön gépén tárolódik, és önmagától nem kerül közzétételre.

A memória nem helyettesíti az utasításfájlt. A teljes csapat és bármelyik ügynök számára szükséges általános projektirányelveknek továbbra is az adattárban van a helyük. Külön útmutatónk van arról, hogyan használható egyetlen utasításfájl a Claude Code-dal, a Codexszel és a Cursorral: AGENTS.md és CLAUDE.md együtt. A memória személyes kontextust őriz meg: az Ön beállításait, az eddig kipróbált dolgokat és a meghozott döntéseket.

A Claude hasonló különbségtételt alkalmaz: a Claude-memória és a CLAUDE.md című cikkben bemutatjuk, miben különbözik a memória a CLAUDE.md fájltól. Maguknak az eszközöknek az összehasonlításához lásd: Grok Build vagy Claude Code.

Korlátok és annak ellenőrzése, hogy működik-e a memória#

Vegye figyelembe a következő korlátokat:

• Kísérleti állapot. A parancsok, küszöbértékek és a működés a későbbi verziókban változhat; ha valami nem a várt módon működik, ellenőrizze az adattár memóriáról szóló útmutatóját.
• Kezdeti beillesztés új munkamenetben. A memória engedélyezése után a /new paranccsal kezdje a munkát, hogy a mentett jegyzetek az első fordulóban bekerüljenek.
• A modell dönti el, mi fontos. A /flush összefoglalóját a modell készíti, és a jegyzet tartalmáról is ő dönt. Hetente vagy kéthetente nyissa meg a /memory ablakot, és tekintse át az összegyűlt tartalmat; töröljön mindent, amire nincs szükség.
• Ne kérje titkok megjegyzését. A kulcsoknak, tokeneknek és jelszavaknak nincs helyük hosszú távú jegyzetekben: a ~/.grok/memory/ fájljait egyszerű szövegként tárolja a rendszer. Ha valami érzékeny adat bekerül, szerkessze a fájlt, és távolítsa el.
• A projektmemória közös az adattár példányai között. Ha az ügynök egy klónban olyasmit jegyez meg, ami egy másik klón számára már elavult, a takarításkor vegye figyelembe a közös könyvtárat.

Ha nem működik a memória:

1. Ellenőrizze a grok inspect kimenetét, hogy megerősítse, a memória engedélyezve van-e.
2. Ellenőrizze, hogy a GROK_MEMORY=0 vagy a konfiguráció nem tiltja-e le.
3. Diagnosztikához futtassa a RUST_LOG=debug GROK_LOG_FILE=/tmp/grok.log grok parancsot, majd ellenőrizze a memóriáról szóló sorokat a /tmp/grok.log fájlban.

Rövid összefoglaló#

A Grok Build memóriája a GROK_MEMORY=1 beállítással vagy a ~/.grok/config.toml fájlban megadott [memory] enabled = true értékkel engedélyezhető. Ahhoz, hogy engedélyezés után először bekerüljenek a jegyzetek, indítson új munkamenetet a /new paranccsal. Az ügynök a ~/.grok/memory/ könyvtárba írja a jegyzeteket: a munkamenet-összefoglalók modellhívás nélkül készülnek, részletes összefoglalók a /flush paranccsal, kifejezett bejegyzések a /remember paranccsal, az Ön megerősítése után, a rendszerezett témák pedig a /dream paranccsal. A jegyzeteket a /memory paranccsal és a fájlok közvetlen szerkesztésével tekintheti meg és takaríthatja. A funkció kísérleti jellegű, ezért ellenőrizze a küszöbértékeket és parancsokat a hivatalos útmutatóban, és rendszeresen tekintse át a jegyzeteket.

Ailoot megnyitása.