Агент жады

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

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

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

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

Екі ось те agent-memory класы. Агент класты да, қалтаны да, кеңістікті де таңдамайды: мұның бәрін құралдың өзі міндеттейді. Жоба ағашында user-doc ретінде тіршілік етуге тиіс ортақ білім «remember» арқылы емес, бөлек құрал create_note арқылы жазылады.

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

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 әдейі агент жадын да қамтиды. Әрқашан жазар алдында іздеңіз: бұл білімді де, жадты да дедуптейді.

Дедуп тәртібі

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

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

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

Әрі қарай

Контекст-жиынтықтар және бекітулер — жады категориясын қалай үнсіздендіру керек және іске қосу кезінде не жүктеледі.
Іздеп табу аудиті — агент search/recall арқылы нені іздеді және тапты ма.
Ниет құралдары — құралдардың толық жиынтығы.