Grok Build: сеанстар арасындағы жад — параметрлер мен шектеулер

Grok Build, xAI-дің терминал агенті, сеанстар арасында жұмыс істейтін жадқа ие: ол жобаға қатысты келісімдерді, шешімдерді және сәтті жөндеу қадамдарын есте сақтап, кейін еске салмай-ақ оларды жаңа сеанстың контекстіне қоса алады. Бұл мүмкіндік әдепкіде өшірулі және эксперименттік — оны бір параметрмен қосуға болады.

Бұл сипаттама 2026 жылғы 20 қыркүйектегі xai-org/grok-build репозиторийіндегі ресми нұсқаулыққа негізделген. Түпнұсқа мақаланың авторы өнімді өзі пайдаланбаған: жұмыс істеу тәртібі жеке сынаққа емес, құжаттамаға сүйеніп сипатталған.

Ailoot-пен жұмыс істеуге қатысты практикалық ақпарат құжаттамада берілген.

Grok Build жадында не бар?#

Мысалы, бір сеанста агентке жобада екі бос орынмен шегініс қолданылатынын, дерекқор миграциялары бөлек пәрменмен орындалатынын және төлемдерге белгілі бір модуль жауап беретінін түсіндірдіңіз. Жаңа сеанста бұл ақпаратты қайтадан беруіңіз керек.

Жад қосулы болса, Grok Build:

• бұрын түсіндірген жоба келісімдерін еске түсіре алады;
• бұрын нәтиже берген жөндеу қадамдарын қолдана алады;
• архитектуралық шешімдерді келесі сеанстарға жеткізе алады;
• жауабы бұрын берілген нәрселер туралы қайта сұрамауға көмектеседі.

Бұл мүмкіндік эксперименттік және әдепкіде өшірулі. Оны қоспайынша, агенттің әрекеті өзгермейді.

Жадты қалай қосуға болады?#

Бір рет, бір іске қосу үшін:

GROK_MEMORY=1 grok

Айнымалы тек осы іске қосуға қолданылады. export GROK_MEMORY=1 пәрмені оны ағымдағы қабықшада сақтап, терминал сеансы аяқталғанша немесе export GROK_MEMORY=0 пәрменін орындағанша, сол қабықшадан кейінгі барлық grok іске қосуларында жадты қосады.

Конфигурация арқылы тұрақты қосу. ~/.grok/config.toml файлына мынаны қосыңыз:

[memory]
enabled = true

Сеансты қайта іске қоспай-ақ ішінде қосу: /memory ашып, t пернесін басыңыз.

Бұл тетік тек ағымдағы сеансқа қолданылады және конфигурацияға жазылмайды. Оны жадты қосу немесе өшіру үшін пайдалануға болады. Өшіргенде жад құралдарына қолжетімділік жойылады, бірақ файлдар дискіден өшірілмейді; қайта қосқанда қоймаға қолжетімділік қалпына келеді. GROK_MEMORY=0 арқылы бүкіл процесс үшін мәжбүрлеп өшірілген жадты бұл тетік қоса алмайды: /memory бүкіл сеанс бойы қолжетімсіз болады.

Параметрлер бірнеше жерде көрсетілсе, олардың басымдығы мынадай:

• GROK_MEMORY=0 жадты бүкіл процесс үшін мәжбүрлеп өшіреді және ең жоғары басымдыққа ие.
• Конфигурациядағы нақты enabled = false басқарылатын қашықтан орнатылған параметр жадты қосса да, оны өшіреді.
• Жадты GROK_MEMORY=1, конфигурациядағы enabled = true немесе басқарылатын қашықтан орнатылған параметр арқылы қосуға болады.
• Ештеңе көрсетілмесе, жад өшірулі болады.

Жазбалар сеанстың алғашқы жүрісінде қосылады. Жұмыс үстінде жадты қосып, агенттің сақталған жоба ақпаратын пайдалана бастағанын қаласаңыз, /new пәрменін орындаңыз. Жадтың қосылған-қосылмағанын grok inspect нәтижесінен тексеруге болады.

Grok Build нені тіркейді және қайда сақтайды?#

~/.grok/memory/ каталогының құрылымы:

Жоба каталогының атауына репозиторий идентификаторының қысқа хэші қосылады. Сәйкестендіру үшін “organization/repository” пішіміндегі origin қашықтағы репозиторийі қолданылады, ал Git репозиторийі болмаса, каталог жолы алынады. Сондықтан бір репозиторийдің клон көшірмелері мен жұмыс ағаштары (Git тармақтарының бөлек жұмыс көшірмелері) бір жоба жадын бөліседі: агенттің бір көшірмеде есте сақтағаны екіншісінде де қолжетімді.

Жазбалар төрт жолмен жасалады:

1. Сеанс соңындағы автоматты түйін. Сеанс аяқталғанда, Grok Build күнделікті журналға қысқаша қызметтік түйін сақтайды: хабарламалар саны, мазмұнды алғашқы бес алмасуға дейінгісі және күні мен уақыты. Түйін метадеректерден модель шақырмай және кідіріссіз құрастырылады. Өте қысқа сеанстар өткізіліп жіберіледі: мазмұнды алмасу үшеуден аз болса немесе мәтініңіз 50 байттан аз болса, жазба жасалмайды. Түйін қолданылған құралдарды, файл жолдарын немесе пәрмендерді қамтымайды. Автоматты түйіндерді session.save_on_end = false параметрімен өшіруге болады.
2. /flush—сұрау бойынша жасалатын егжей-тегжейлі жазба. Бұл пәрменмен модель ағымдағы сеанстың ең маңызды тұстарын түйіндейді: шешімдерді, үлгілерді, жөндеу қадамдарын және API туралы анықтауларды. Түйін күні көрсетілген журналға жазылып, болашақ сеанстарға арнап индекстеледі. Құжаттамада контекст ықшамдалмай тұрып, сәтті жөндеу сеансы аяқталғанда және маңызды үлгілер анықталғаннан кейін /flush орындау ұсынылады.
3. /remember—бір нәрсені есте сақтау туралы тікелей сұрау. /remember always open PR links after sending деп теріңіз немесе агентке “remember that...” деп айтыңыз. Жазба енгізілмес бұрын қарап шығу панелі ашылады: жазба тек сіз растағаннан кейін сақталып, таспада Memory saved to ~/.grok/memory/MEMORY.md деген хабар пайда болады. Жоба туралы ақпарат жобаның MEMORY.md файлына, ал барлық жобаларға ортақ ақпарат жалпы файлға жазылады.
4. /dream—жинақтау. Бұл пәрмен шашыраңқы журналдар мен жазбаларды тақырыптар бойынша топтап, іздеу дәлдігін арттыру үшін қайталанатындарын жояды. /flush сияқты, жинақтауды модель орындайды: жиналған жазбаларды оқып, тақырыптарға бөліп қайта жазады, сондықтан нәтижені /memory арқылы мезгіл-мезгіл қарап отырған жөн. Автоматты режим де бар: әдепкіде Grok Build іске қосылғанда және сағатына бір рет шарттарды тексеріп, кемінде 24 сағат өткен әрі кемінде 5 сеанс жиналған кезде жинақтауды бастайды. Шектерді конфигурацияның [memory.dream] бөлімінде өзгертуге болады.

Жазбалар SQLite индексі арқылы ізделеді: әдепкіде толық мәтінтін FTS5 іздеу қолданылады, ал ендіру моделі конфигурацияланған болса, оған семантикалық векторлық іздеу қосылады.

Жад жаңа сеансқа қалай қосылады?#

Бастапқы енгізуде min_score = 0.9 іріктеу шегі қолданылады; оны [memory.initial_injection] бөлімінде өзгертуге болады. Автоматты контекст ықшамдалғаннан кейін агент жадты қайта іздеп, бұрынғы алмасулармен бірге контексттен алынып қалуы мүмкін ақпаратты қалпына келтіреді.

Агенттен тікелей “What do you remember?” деп те сұрай аласыз. Ол жауабын дереккөздер бойынша топтайды: жалпы қалаулар, жоба туралы білім және сеанс тарихы.

Сеанс жазбаларында өзектілік белгілері болады. Сеанс журналының жазбасы неғұрлым ескі болса, оған “Осыған сүйенбес бұрын, оның әлі де өзекті екенін тексеріңіз” деген белгі соғұрлым анық қойылады. Жалпы және жобалық MEMORY.md файлдарына мұндай белгілер қойылмайды: олардың мазмұны ұзақ мерзімге арналған, сондықтан дәлдігін өзіңіз қадағалауыңыз керек.

Жазбаларды қалай көруге, өңдеуге және жоюға болады?#

Сеанстағы /memory пәрмені барлық жад файлдары қамту аясы бойынша топталған терезені ашады: жалпы, жоба және сеанстар (кері хронологиялық ретпен). Сол жақта файлдар тізімі, ал оң жақта таңдалған файлдың тек оқуға арналған алдын ала көрінісі беріледі.

Шолудағы пайдалы пернелер:

Терезеде жеке жазбалар мен сеанс файлдарын жоюға болады; бірақ жасалған MEMORY.md индекстерін (жалпы және жоба) жою мүмкін емес.

Екінші әдіс — файлдарды тікелей өңдеу. Олар ~/.grok/memory/ ішінде сақталады және кез келген редакторда ашылады. Каталогтағы өзгерістер бақыланады: жасалған және өзгертілген файлдар қайта индекстеледі, ал жойылған файлдар келесі іздеу кезінде индекстен өшіріледі.

“forget about snake_case” деген сұрауға кепілдік жоқ: модель сәйкес жазбаларды іздеп, жояды, бірақ кейбірін өткізіп алуы мүмкін. Жойылғанына көз жеткізу үшін файлды ашып (оның жолын /memory ішіндегі y пернесімен оңай көшіруге болады), жазбаны қолмен алып тастаңыз. Жадты пәрмен жолынан толығымен тазалауға болады: жоба жадын тазарту үшін grok memory clear, жалпы жадты тазарту үшін grok memory clear --global, ал екеуін де тазарту үшін grok memory clear --all.

Жадтың репозиторийдегі нұсқаулар файлынан айырмасы қандай?#

Репозиторийдегі нұсқаулар жобада жұмыс істейтіндердің бәрімен бөлісіледі және код пен өзгерістер тарихынан көрінеді. Жад сеанстар барысында толығып, компьютеріңізде сақталады және өздігінен жарияланбайды.

Жад нұсқаулар файлын алмастырмайды. Бүкіл топқа және кез келген агентке қажетті жалпы жоба ережелерін репозиторийде сақтау орынды. Claude Code, Codex және Cursor үшін бір нұсқаулар файлын пайдалану туралы бөлек нұсқаулығымыз бар: AGENTS.md және CLAUDE.md бірге. Жад жеке контексті сақтайды: қалауларыңызды, бұған дейін не тексерілгенін және қандай шешімге келгеніңізді.

Claude-та да осыған ұқсас айырмашылық бар: Claude жады және CLAUDE.md мақаласында жадтың CLAUDE.md файлынан айырмасын түсіндіреміз. Құралдардың өзара салыстыруын Grok Build немесе Claude Code мақаласынан қараңыз.

Шектеулер және жадтың жұмысын тексеру#

Мына шектеулерді ескеріңіз:

• Эксперименттік мәртебе. Пәрмендер, шектер және жұмыс тәртібі болашақ нұсқаларда өзгеруі мүмкін; бірдеңе күткендей істемесе, репозиторийдегі жад нұсқаулығын тексеріңіз.
• Жаңа сеансқа бастапқы енгізу. Жадты қосқаннан кейін сақталған жазбалар алғашқы жүріске қосылуы үшін жұмысты /new пәрменімен бастаңыз.
• Ненің маңызды екенін модель шешеді. /flush түйінін модель жасайды және жазбаға не кіретінін өзі таңдайды. Бір-екі апта сайын /memory ашып, жиналғандарды қарап шығыңыз; қажетсізін жойыңыз.
• Құпияларды есте сақтауды сұрамаңыз. Кілттер, токендер және құпиясөздер ұзақ мерзімді жазбаларда болмауы керек: ~/.grok/memory/ ішіндегі файлдар кәдімгі мәтін түрінде сақталады. Құпия ақпарат жазылып кетсе, файлды өңдеу арқылы алып тастаңыз.
• Жоба жады репозиторий көшірмелері арасында ортақ. Агент бір клонда басқа көшірме үшін ескірген нәрсені есте сақтаса, тазалау кезінде ортақ каталогты ескеріңіз.

Жад жұмыс істемесе:

1. Жадтың қосулы екенін растау үшін grok inspect нәтижесін тексеріңіз.
2. GROK_MEMORY=0 айнымалысы немесе конфигурация оны өшіріп тұрмағанын тексеріңіз.
3. Диагностика үшін RUST_LOG=debug GROK_LOG_FILE=/tmp/grok.log grok пәрменін орындап, /tmp/grok.log файлын жадқа қатысты жолдарды қарап шығыңыз.

Қысқаша түйін#

Grok Build жадын GROK_MEMORY=1 немесе ~/.grok/config.toml ішіндегі [memory] enabled = true арқылы қосуға болады. Қосқаннан кейін жазбалар алғаш рет енгізілуі үшін /new пәрменімен жаңа сеанс бастаңыз. Агент жазбаларды ~/.grok/memory/ ішіне жазады: сеанс түйіндері модель шақырмай жасалады, егжей-тегжейлі түйіндер /flush арқылы, тікелей енгізілімдер /remember арқылы сіздің растауыңыздан кейін, ал жинақталған тақырыптар /dream арқылы жасалады. Жазбаларды /memory пәрменімен және файлдарды тікелей өңдеу арқылы қарап, тазалаңыз. Бұл мүмкіндік эксперименттік болғандықтан, шектер мен пәрмендерді ресми нұсқаулықпен салыстырып, жазбаларды мезгіл-мезгіл тексеріп отырыңыз.

Ailoot сайтына өтіңіз.