NotariumҚұжаттама
Құжаттама нұсқасы: latest
KZ

Іздеп табу аудиті

Контекст құрастырушы агентке алдын ала, старт кезінде не жүктелетінін анықтайды. Аудит — оның жұмыс үстіндегі егізі: ол агент шын мәнінде нені іздейтінін (search / recall) және ашатынын (get_note), әрі тапқан-таппағанын көрсетеді. Бұл маңызды, өйткені жадының басым сәтсіздік режимі — «факт жоқ» емес, іздеп табудың бұзылуы: керек жазба бар, бірақ сұрау оған жетпейді. Бақылау болмаса, жадыны баптау болжамға айналады.

Бөлім Agents → Audit ішінде орналасқан.

Логқа не түседі

Оқитын құралдың әрбір шақыруы (search, recall, get_note) логқа жол қосады: не ізделгені (query, scope, class) және не табылғаны (noteId, title, score, class бар топ-хиттер + нәтижелер саны). Түсіру фонда жүреді — ол агентке қайтарылатын жауаптың кідірісіне де, дұрыстығына да әсер етпейді.

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

Әр жол сонымен қатар агент атауын есте сақтайды — токеннің немесе қосымшаның ыңғайлы атауын (мысалы, CLI немесе Claude), токен тірі кезінде түсірілген. Осылайша жол қай агент сұрау жасағанын мәңгі есте сақтайды.

Соқыр аймақтар

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

Интерфейс мұны екі панельге жинайды:

  • Blind spots — қайталанатын бос сұраулар (шегі: нәтижесіз екеу және одан көп), сарғыш/кәріптас түсті ерекшеленген.
  • Frequent — ең жиі сұраулар.

Оған қоса тарих таспасы (жаңалары жоғарыда), құрал бойынша сүзгісімен (All / Search / Recall / Open): құрал белгішесі, сұраудың өзі, агент атауы, класс/категория белгісі, жоба (тек ауқым тарылтылғанда), нәтижелер саны және уақыт. Жолды жайғанда табылған хиттер көрінеді — олар басуға келеді әрі тікелей жазбаларға апарады.

Бос нәтиже

Аудит дәл бос нәтижені сенімді ұстайды. «Релевантты нәрсе бар, бірақ топқа кірмеді» жағдайы сұрауды жадыға қарсы жүргізуді қажет етеді — бұл аудит көрсетпейтін бөлек, нәзігірек сигнал.

Құпиялылық және қамту

Лог тек иесіне көрінеді: сіз өз агенттеріңіздің іздеп табуын өз пайдаланушы атыңызбен байланысқан күйде көресіз. Көруші — иесі болғандықтан, өз агентіңіздің атауы редакцияланбай көрсетіледі. Аудит сіздің барлық кеңістіктеріңізді бірден қамтиды — жолдың бір ғана үй кеңістігі болмайды.

Іздеп табу қашан тіркелмейді

Аудит қызметтік дерекқорда сақталады. Қызметтік дерекқоры жоқ хост (мысалы, дерекқорсыз none режимі) іздеп табуды тіркемейді — бөлім жай ғана бос қалады, қатесіз.

Әрі қарай