◆ Sparround

Sessiyalar, kontekst faylları və geri qayıtma

Agentin "nə bildiyi" dörd fərqli mənbədən gəlir və onları qarışdırmamaq vacibdir:

  • Sessiya — cari söhbət; bitəndə diskə yazılır, sonra axtarıla bilir
  • Kontekst faylları — layihədə avtomatik tapılan qaydalar (AGENTS.md, .hermes.md, SOUL.md və s.)
  • Kontekst referansları — mesajın içinə @ ilə əl ilə çəkdiyin fayl, qovluq, diff və ya URL
  • Yaddaş — sessiyalar arası qalan qısa fakt siyahısı (növbəti mövzu)

İlk üçü bu mövzunundur.

MənbəNə vaxt yüklənirToken xərciTipik istifadə
Sessiya tarixçəsiHər növbədə tamYüksək və artanCari işin gedişi
Kontekst fayllarıSessiya başlayanda avtomatikSabit, hər sorğudaLayihə qaydaları, üslub, komanda razılaşmaları
`@` referanslarYalnız sən yazandaBir dəfəlik"Bu fayla bax", "bu diff-i oxu"
Sessiya axtarışıAlət çağırışı iləÇox aşağı (baza sorğusu)"Keçən həftə bunu necə həll etmişdik?"

Checkpoint və geri qayıtma. Agent fayl dəyişməzdən əvvəl iş qovluğunun anlıq şəklini çıxarır. Yəni səhv bir patch və ya kütləvi refaktor işi dağıtsa, geri qaytarmaq mümkündür. Bu, agenti repo-da işlətməyin ən vacib təhlükəsizlik toru olsa da, git-i əvəz etmir — commit vərdişini saxla.

Kontekst faylları isə güclü, amma iki tərəfli alətdir: layihə qaydalarını agentə avtomatik çatdırır, eyni zamanda kənar məzmunun sistem promptuna girməsi deməkdir. Buna görə bu fayllar prompt injection üçün yoxlanır — bu barədə Təhlükəsizlik mərhələsində danışacağıq.

Praktik qayda: təkrarlanan qayda → kontekst faylı; bir dəfəlik material → `@` referansı; keçmiş qərar → sessiya axtarışı. Ən çox rast gəlinən səhv hər şeyi kontekst faylına yığmaqdır — o fayl hər sorğuda ödənilir və böyüdükcə keşi də sındırır.

Praktika. Bir layihədə AGENTS.md yarat və içinə üç qayda yaz (məsələn: "testləri npm test ilə işlət", "commit mesajları imperativ olsun", "dist/ qovluğuna toxunma"). Sonra sessiya aç və agentin bu qaydalara riayət etdiyini yoxla. Hazır sayılır: hermes prompt-size çıxışında faylın promptda göründüyünü təsdiqləyirsən.

📚 Mənbələr və sənədlər