---
title: "Агент жады"
description: "Пайдаланушы мен жоба туралы агенттің тұрақты жады: remember оқылатын жазбалар жазады, recall бюджетті сақтайды, search жазар алдында дедупликациялайды."
---

# Агент жады

Notarium-дегі агент жады — жасырын сиқыр да, бөлек дерекқор да емес: бұл агент өз бақылауларынан жазатын және сіз оқи, түзете әрі жоя алатын `agent-memory` класындағы кәдімгі жазбалар. Агент деректерді `remember_about_user` және `remember_about_project` арқылы есте сақтайды, ал контексті `recall` арқылы алады. Басты тәртіп — **жазар алдында іздеу**, сонда қосарланулар пайда болмайды.

## Екі ось: пайдаланушы туралы және жоба туралы

Жады екі өзара тәуелсіз ось бойынша тіршілік етеді:

- **Пайдаланушы туралы** — `remember_about_user` сіз туралы ұзақ өмір сүретін деректерді (қалаулар, контекст, ағымдағы жұмыс) жеке доменіңіздің құпия жадына жазады. Қай кеңістікте жұмыс істесеңіз де, ол сол бір жады — әр кеңістікке араласпайды.
- **Жоба туралы** — `remember_about_project` нақты бір жоба туралы жадты оның ішкі каталогына жазады. Пайдаланушы туралы жазуға симметриялы, бірақ жобаға байланысты.

Екі ось те `agent-memory` класы. Агент класты да, қалтаны да, кеңістікті де **таңдамайды**: мұның бәрін құралдың өзі міндеттейді. Жоба ағашында `user-doc` ретінде тіршілік етуге тиіс ортақ білім «remember» арқылы емес, бөлек құрал [`create_note`](/docs/agents/intent-tools/) арқылы жазылады.

## Бақылауға емес, категорияға бір файл

`remember_about_user(observation, category)` бақылауды әр дерекке жеке микрофайл жасаудың орнына категория файлына **үстеп жазады**. `category` — бұл жол емес, белгі («preferences»). Жаңа категория — жаңа файл. Міндетті емес `summary` — профильдің туынды индексін қоректендіретін категорияның бір жолдық дайджесті.

Жазылған бір деректі түзету немесе жою — бұл кәдімгі жазбаны өңдеу: `edit_note` арқылы жады жазбасының id-і бойынша (оны `remember_*` қайтарады), `findReplace` режимінде (бос `content` сниппетті алып тастайды) немесе бүкіл категория үшін `replace` режимінде. Бөлек «бақылау бойынша адрестеу» деген жоқ — жады кез келген жазба сияқты сол бір сөздік режимдермен өңделеді.

## recall ≠ search

Екеуі де оқиды, бірақ әртүрлі мәселені шешеді:

| | `search` | `recall` |
|---|---|---|
| Не қайтарады | `score` және `path` бар реттелген сниппеттер | токен-бюджет шегіндегі байланысқан контекст-бандл |
| Қамту | релевантты жазбалар | релевантты жазбалар **және** олардың граф-көршілері (граф бойынша `depth` қадам) |
| Жады | жадты көреді (дедуп үшін) | білімнен де, жеке жадтан да тартады |
| Қашан шақыру | нақтыны табу, жазар алдында тексеру | тақырыптың айналасынан жұмысқа контекст жинау |

`recall` бай: ол тапқанының айналасындағы графты аралап, нәтижені `budgetTokens` шегінде буады, ал `maxPerSource` бір ірі жазбаның бүкіл бандлды жеп қоюына жол бермейді. `search` — дәл нысаналы: ол дәл сол «жазар алдында іздеу» механизмі.

## Жазар алдында іздеу

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

> [!tip] Дедуп тәртібі
> `remember_*` алдында деректің тақырыбы бойынша `search` шақырыңыз. Егер категория бұрыннан бар болса — синоним жасаудың орнына сол `remember_*` арқылы оған үстеп жазыңыз (ол үстеп жазады) немесе `edit_note` арқылы түзетіңіз.

## Иесі нені көреді

Жады **қалыпты навигациядан жасырын** (ағаш, Ағын, әдеттегі іздеу), бірақ сізден жасырылмаған: ол шолғыш ағашта жеке **Memory** линзасы арқылы көрінеді (жазбалар `/m/<id>` мекенжайы бойынша кез келген басқа жазба сияқты ашылады), ал категорияны **Agents → Context** бөлімінде үнсіздендіруге болады. [Ревизиялар журналындағы](/docs/concepts/versioning/) жазба агенттің нақ нені жазғанын көрсетеді — инъекция жасырын енгізуі мүмкін нәрсені осылай ұстайсыз. Жадты қайта ұйымдастыра алмайсыз: секцияға агент иелік етеді (жалпақ жиынтық және туынды индекс), бірақ оны жылжыту техникалық тұрғыдан қауіпсіз — сәйкестік жазбаның id-іне сүйенеді.

## Әрі қарай

- [Контекст-жиынтықтар және бекітулер](/docs/agents/context-pins/) — жады категориясын қалай үнсіздендіру керек және іске қосу кезінде не жүктеледі.
- [Іздеп табу аудиті](/docs/agents/audit/) — агент `search`/`recall` арқылы нені іздеді және тапты ма.
- [Ниет құралдары](/docs/agents/intent-tools/) — құралдардың толық жиынтығы.