---
title: "Контекст жиынтықтары мен бекітулер"
description: "start_session кезінде агент нені алатынын құрастыру: always-load бекітулері, қайта қолданылатын контекст жиынтықтары және жадты үнсіздендіру."
---

# Контекст жиынтықтары мен бекітулер

Агент `start_session` шақырғанда бүкіл білім қорын алмайды — өзіңіз құрастырған бастапқы контекстті алады. **Agents → Context** бөлімі — сол бастапқы контексттің құрастырушысы: агент старт кезінде нақты нені көретінін осында шешесіз — қай жазбалар әрқашан жүктеледі (бекітулер), ауқымға қандай қайта қолданылатын топтамалар жалғанған (контекст жиынтықтары), жадтың қай санаттары үнсіздендірілген. Тег-бекітулер мен жадты үнсіздендіру — file-first: олар жазбаның frontmatter-інде жатады және репозиторийді қайта клондасаңыз да жоғалмайды. Контекст жиынтықтары мен кеңістікаралық бекітулер қызметтік дерекқорда сақталады (әдейі жасалған ескертпе: таза хостқа қайта клондау да, `none` режимі де оларды сақтап қалмайды).

## always-load бекітулері

Бекіту — «әрқашан жүкте» деген қолмен қойылатын белгі (кезек емес, `always-load` тегіне мүшелік). Бекіту екі ось бойынша жұмыс істейді:

- **Жеке** — жеке домендегі жазбалар `profile.alwaysLoad`-қа түсіп, **әр** сессияда жүктеледі.
- **Жобалық** — белгіленген жобаның ішкі тармағындағы жазбалар `project.alwaysLoad`-қа түсіп, агент **сол жобада** жұмыс істегенде жүктеледі (`project` хинті).

Бекіту жазбаның қай жерде жатқанына байланысты: жеке домендегі жазба профильге, жоба тармағындағы жазба жобаның бандліне бекітіледі. Құрастырушы агент шын мәнінде нені жүктейтінін дәл сол күйінде көрсетеді — іріктеуді серверде де, алдын ала қарауда да бір код есептейді.

## Контекст жиынтықтары — кеңістікаралық топтамалар

`always-load` тегі бекітуді бір кеңістікпен шектейді. Контекст жиынтықтары бұл шектеуді алып тастайды: жиынтық — басқа ауқымға жалғауға болатын **атауы бар, қайта қолданылатын жазба сілтемелерінің жинағы**.

Әдеттегі сценарий: ортақ `conventions` кеңістігіндегі жазбалардан «Фронт конвенциялары» жиынтығын жинап, оны басқа кеңістіктегі жобаларға жалғайсыз. Сол жобалардың әр сессиясы осы жазбаларды алады, ал жиынтықты бір жерде түзетесіз — бәрінде жаңарады.

Жеңілірек нұсқасы да бар — **кеңістікаралық loose-бекіту**: жиынтық қабықшасынсыз, басқа кеңістіктен тікелей ауқымға бекітілген жалғыз жазба. `always-load` тегі same-space бекіту үшін қалады; жиынтықтар мен loose-бекітулер — кеңістікаралық үшін. Бәрі қатар жұмыс істейді, дедуп note-id бойынша жүреді.

> [!note] Иелік ету ≥ жалғау
> Жиынтық өзі жасалған кеңістікте тұрады, көру мен түзету құқығын да сол кеңістіктегі мүшелік береді. Жеке жиынтық тек өзіңіздің жеке доменіңізге жалғанады; ортақ жиынтық (ортақ кеңістіктен) — жеке доменге де, кез келген жобаға да. Жеке жиынтықты жобаға жалғауға болмайды — ол контексті тек сізге ғана жүктер еді.

## Реттілік = жүктеу басымдығы

Тізімдегі бекітулер мен жиынтықтардың реті — сіздікі (drag-and-drop), туынды емес. Ол басымдықты белгілейді: жоғарыдағысы бірінші жүктеледі және токен-бюджет таусылғанда ең соңында қиылады. Бекітулер мен жиынтықтар бір ортақ тізімде реттеледі (жиынтықты бекітуден жоғары көтеруге болады). Жалпы жүктеу реті: **бекітулер → жиынтықтар → жад** (нақтысы жалпысынан басым), содан соң артығы ауқым бюджетіне қарай қиылады.

## Жадты үнсіздендіру (mute)

Агент жады контекстке әдепкіде жүктеледі. Бір санат тым шулы болса — соны ғана үнсіздендіріңіз (`mute`). Үнсіздендіру жадты агентке айқын сұраныссыз өздігінен баратын жерлердің бәрінен алып тастайды:

- `start_session` кезінде бірден жүктелетін жеке профиль;
- `recall` бандлін жинау;
- `start_session(project).knownValues` ішіндегі санаттар сөздігі.

> [!important] Search үнсіздендірілгенді әдейі көреді
> `search` mute-ты **сүзбейді**: ол жадты дәл «жазар алдында іздеу» дедупы үшін индекстейді. Әйтпесе агент үнсіздендірілген санатты таппай, оның дублін қайта жасар еді. Mute — авто-контексті үнсіздендіру, жою емес: айқын іздеу де, аудит те бәрін бұрынғыдай көреді. Кері әрекеті — сол ось бойынша `Unmute`.

## Біртұтас токен-бюджет

Құрастырушы бөлімдерінің үстінде — жалғыз жүктеу шкаласы, ол ағымдағы ауқым бюджетіне дәлме-дәл тең. Жеке жауаптың бір бюджеті бар (әуелі бекітулер, содан соң жад); жобалық жауаптың өз бюджеті бар: алдымен жобалық бекітулер тұрады, ал жеке фон қалған орынға сыяды. Жүктелген көлем әрқашан бюджеттен аспайды (≤), ал нақ қай элемент қиылғаны көрініп тұрады. Жобалық жад бірден жүктелмейді, сұраныс бойынша тартылады; жобаның нақты бір фактісі әрқашан керек болса — жазбаны бекітіп қойыңыз.

## Ары қарай

- [Іздеп табу аудиті](/docs/agents/audit/) — жұмыс кезіндегі құрастырушының егізі: агент шын мәнінде нені алып жатыр.
- [Агент жады](/docs/agents/memory/) — сіз үнсіздендіретін жад қалай құрылған.
- [Агент ережелері](/docs/agents/agent-files/) — міндеттің екінші жартысы: `start_session` мүлдем шақырылуы үшін не істеу керек.
- [Ниет құралдары](/docs/agents/intent-tools/) — `start_session` және қалған құралдар.