AgentsView može da objedini dnevnike sesija agenata za programiranje iz više alata u jednu pretraživu lokalnu arhivu. Ovaj vodič je za rukovodioca inženjerskog tima koji treba da pronađe jedan poznati zadatak, pregleda polja potrošnje koja je agent zaista zabeležio i utvrdi izvor svakog iznosa troška.

Ovaj postupak zasniva se na dokumentaciji izdanja AgentsView v0.45.0 od 9. oktobra 2026. i aktuelnim vodičima za početak rada i potrošnju tokena, proverenim 17. oktobra. BIG CHANGE nije instalirao AgentsView, uvezao transkript niti testirao ove korake. Proverite verziju koju instalirate jer se dokumentacija i spiskovi izdanja mogu menjati.

Pre nego što počnete

Potrebna vam je završena sesija agenta za programiranje koju smete da čitate, prepoznatljiva fraza ili ID sesije iz tog zadatka i dozvola za čitanje njenog lokalnog direktorijuma dnevnika. Quick Start navodi desktop preuzimanja za macOS, Windows i Linux, uz CLI wheel pakete za Linux x86_64 i aarch64, macOS x86_64 i arm64, kao i Windows x86_64 i arm64. Desktop aplikacija dolazi kao paket; izgradnja iz izvornog koda ima zasebne zahteve za Go, Node i CGO. Prema početnom vodiču, osnovno lokalno arhiviranje ne zahteva nalog na hostovanoj usluzi niti API ključ.

Dnevnici sesija mogu sadržati upite, izvorni kod, ulaze alata i tajne. Birajte samo direktorijume koje vaš tim dozvoljava da pregledate. Odlučite koje provajdere i korenske direktorijume arhiva sme da uveze pre njenog prvog pokretanja: sama komanda agentsview serve odmah otkriva i sinhronizuje podrazumevane podržane izvore. Za ovu proveru zadržite veb interfejs na dokumentovanoj lokalnoj loopback adresi. Nemojte uključivati hostovanu sinhronizaciju sirovih podataka, slanje u PostgreSQL ili ClickHouse, objavljivanje na Gist-u, generisane uvide ili hostovani servis za embeding samo da biste odgovorili na ovo pitanje. Semantička pretraga je opciona; obična pretraga punog teksta radi sa lokalnim indeksom.

1. Instalirajte i identifikujte izvršnu datoteku

Izaberite jedan metod iz vodiča za instalaciju. Za samostalni CLI, dokumentovana trajna instalacija za Python glasi:

Terminal
pip install agentsview
agentsview --version

Vodič nudi i uvx agentsview za pokretanje bez trajne instalacije, instalacione programe za pojedine platforme i desktop pakete. Na macOS-u, Homebrew cask povezuje CLI iz paketa aplikacije; aplikacija instalirana iz DMG-a može zahtevati dodavanje svog CLI direktorijuma u PATH. Pre nego što verujete prijavljenoj verziji, proverite koju izvršnu datoteku vaša komandna ljuska pronalazi. GitHub označava v0.45.0 kao izdanje od 9. oktobra, ali pri tumačenju ekrana i šeme izveštaja koristite sopstveni rezultat komande --version.

2. Ograničite izvore pre prve sinhronizacije

Za instalaciju CLI-ja ili desktop aplikacije na domaćinu, pripremite nov direktorijum podataka i njegov config.toml pre pokretanja AgentsView-a. Vodič za konfiguraciju dokumentuje disabled_agents za isključivanje lokalnih provajdera sistema datoteka i [agents.<id>].dirs za zamenu podrazumevanih korenskih direktorijuma jednog provajdera. Navedite ID-eve svih ostalih provajdera iz tabele Session Discovery u tom vodiču u disabled_agents, a dirs jedinog odobrenog provajdera podesite na odobreni korenski direktorijum. Na primer, [agents.codex] sa dirs = ["/approved/codex/sessions"] zamenjuje podrazumevane direktorijume za Codex; prilagodite putanju svom sistemu. Ako nemate potpun spisak isključenja, još nemojte pokretati demon na domaćinu. Jedno podešavanje CODEX_SESSIONS_DIR ili CLAUDE_PROJECTS_DIR menja koren tog provajdera, ali ostalima ostavlja mogućnost sopstvenog podrazumevanog otkrivanja.

Koristite nov AGENTSVIEW_DATA_DIR za ovu proveru ako postojeća arhiva možda već sadrži nepovezane sesije. Vodič za konfiguraciju kaže da ranije arhivirane sesije isključenih provajdera ostaju dostupne, pa promena podešavanja ne prazni staru arhivu. Takođe navodi da disabled_agents obuhvata lokalno otkrivanje i praćenje, a ne udaljene uvoze ili izvoze; za ovaj lokalni zadatak ostavite udaljene domaćine i odredišta za izvoz nepodešenim.

Izolovani kontejner je alternativa kada nije praktično održavati spisak isključenja svih drugih provajdera. Docker primer u Quick Start-u izlaže interfejs samo na 127.0.0.1, montira izvor jednog agenta samo za čitanje i koristi zaseban volumen podataka. Montirajte samo odobreni korenski direktorijum izvora i podesite odgovarajuću promenljivu direktorijuma unutar novog kontejnera; izostavite druga montiranja iz Compose primera projekta. Kontejner vidi samo eksplicitno montirane direktorijume sesija sa domaćina. Objavljene Docker slike pokrivaju Linux amd64 i arm64; ova mogućnost zahteva funkcionalnu Docker instalaciju.

3. Napravite lokalnu arhivu

Za CLI na domaćinu sa ograničenim izvorima pokrenite dokumentovani server u prvom planu:

Terminal
agentsview serve

Nakon što primenite i proverite opseg izvora u koraku 2, time se inicijalizuje ~/.agentsview/sessions.db (ili izabrani direktorijum podataka), otkrivaju se dnevnici omogućenih agenata, sinhronizuju, prate promene i otvara http://127.0.0.1:8080. Ostavite taj terminal otvoren. Ako želite pozadinski proces, koristite agentsview daemon start i agentsview daemon status; desktop aplikacija upravlja sopstvenim pozadinskim servisom. Kompatibilan server koji već radi može samo prijaviti svoj URL, pa proverite da li je demon pokrenut pre nego što pretpostavite da je nova konfiguracija određivala uvoz.

Ako ste izabrali izolovani kontejner, pokrenite ga dokumentovanom Docker komandom nakon provere jednog montiranog izvora samo za čitanje i novog volumena podataka. Koristite njegov lokalni loopback interfejs i kasnije CLI izveštaje alata agentsview pokrećite unutar tog kontejnera, da bi čitali istu arhivu. Nemojte istovremeno pokretati serve na domaćinu bez ograničenih izvora.

Proverite da li se izvor poznatog zadatka pojavljuje, a neželjeni provajderi ne. Ako sesija nedostaje, pregledajte odobrenu putanju, podešavanje provajdera i stanje sinhronizacije pre nego što zaključite da sesija ne postoji. Pokrenite agentsview sync kada je potrebno da novopromenjene datoteke budu upisane pre izveštaja; server takođe prati promene. Ponovo proverite podešeni opseg pre svake potpune resinhronizacije.

4. Pronađite zadatak i proverite transkript

U veb interfejsu koristite Ctrl/Cmd+K da tražite prepoznatljivu doslovnu frazu iz poznatog zadatka. Suzite spisak prema projektu, agentu ili datumu, otvorite kandidata i proverite njegove poruke i pozive alata. Ako već imate ceo ID sesije ili UUID, Ctrl/Cmd+G je otvara direktno. Ove kontrole opisane su u Quick Start-u. Zabeležite agenta, ID sesije i datum kako biste povezali rezultat potrošnje sa pravim razgovorom.

Ako doslovna pretraga ne pronađe zadatak, pokušajte kraću frazu i proverite da li je osnovni agent zapisao lokalni transkript u direktorijum koji AgentsView može da čita. Zadatak koji postoji samo u udaljenoj usluzi, nepodržanom formatu ili direktorijumu van podešenih korena ne može se pronaći upornijom pretragom. Nemojte uključivati semantičko indeksiranje ili slanje transkripta kao rutinsku popravku za nedostajući lokalni izvor.

5. Pregledajte polja potrošnje sesije

Otvorite prikaz potrošnje pronađene sesije i prepoznajte prisutna zabeležena polja modela, ulaza, izlaza, kreiranja keša i čitanja keša. Vodič za potrošnju tokena označava izveštavanje o troškovima kao eksperimentalno i još u razvoju. AgentsView uvozi metapodatke modela i tokena iz izvornih dnevnika i zadržava sirove podatke o potrošnji tokena u redovima poruka. Kada postoje, koristi eksplicitne troškove koje prijavljuje izvor; inače obračunava trošak iz upotrebljivih tokena i cena modela. Njegov JSON zapis o poreklu naziva ih reported, computed ili mixed.

Ako želite sačuvan mašinski čitljiv zapis za tu jednu sesiju, CLI primer projekta koristi agentsview session usage SESSION_ID --format json. Zamenite SESSION_ID ID-em koji ste proverili u transkriptu, pa sačuvajte JSON uz belešku o zadatku. Pre navođenja ukupnog iznosa proverite prijavljeni model, kategorije tokena i izvor troška u tom izlazu.

Prazno polje ili nedostajući model tretirajte kao nepoznato. AgentsView ne može rekonstruisati potrošnju koju agent nikada nije zapisao. Beleške izdanja kažu da uvoz za Junie CLI isključuje razgovore i pozive alata koji postoje samo u IDE-u, dok rezervni uvoz Antigravity običnog teksta sadrži transkript bez potrošnje tokena ili troška. To su konkretni primeri zašto pretraživa sesija ne mora imati potpun iznos potrošnje. Iznos koji prijavi izvor takođe može opisivati celu sesiju, dok raspodele po modelima ostaju procene.

6. Ograničite dnevni izveštaj

Pomoću filtera datuma, projekta i agenta na stranici Usage pregledajte dan u kom je sesija vođena. Stranica nudi i tabelu Top Sessions by Cost sa vezama ka pojedinačnim transkriptima. Za proverljiv izveštaj u terminalu zamenite lokalni datum sesije i ime agenta u sledećoj komandi:

Terminal
agentsview usage daily --since YYYY-MM-DD --until YYYY-MM-DD --agent codex --breakdown

Dnevna tabela razdvaja nekeširani ulaz, izlaz, kreiranje keša i čitanja keša, uz redove po modelima kada je postavljeno --breakdown. Datumi se grupišu prema sistemskoj vremenskoj zoni osim ako se ne zada --timezone. Dnevni zbir može obuhvatiti druge sesije tog agenta; on služi proveri opsega i reda veličine, nije trošak jednog zadatka. Zadržite ID sesije uz dnevni izveštaj i proverite koji redovi zaista pripadaju njoj.

Za izveštaj bez preuzimanja kataloga cena dodajte --offline. AgentsView kaže da se tako čita postojeća arhiva bez sinhronizacije izvora ili pokretanja demona, uz korišćenje ugrađenih rezervnih cena. Prvo osvežite arhivu ako su važne nedavne promene sesije; izveštaj van mreže ne može otkriti nove dnevnike. Uobičajene komande za potrošnju mogu preuzimati cene sa LiteLLM-a i OpenRouter-a, dok ugrađeni katalog stari sa instaliranim izdanjem.

7. Protumačite iznos i zaustavite servis

Svaki iznos označite prema njegovom poreklu. Computed znači da je AgentsView pomnožio zabeležene tokene izabranim cenama. Reported znači da je izvor prijavio eksplicitan trošak. Mixed znači da izveštaj kombinuje vrste. Čak ni iznos koji prijavljuje izvor nije dokaz da je račun provajdera za ceo nalog usaglašen. Nezavisno uporedite evidenciju obračuna ili plana odgovarajućeg provajdera, naročito kada su važni servisni nivoi, popusti ili uključene kvote pretplate. Dokumentacija AgentsView-a kaže da ne može zaključiti cene za Batch, Flex, Priority, region ili jednosatni keš ako sačuvana potrošnja ne navodi taj nivo. Neki tokeni na strani alata ne postoje u lokalnim transkriptima.

Provera uspeha je pronađen transkript čiji agent, ID i datum odgovaraju izabranom prikazu potrošnje, uz zabeležena dostupna polja modela i tokena, a nedostupna označena kao nepoznata. Rezultat je pretraživa lokalna arhiva i ograničena beleška o potrošnji zadatka ili dana, a ne račun. Zaustavite agentsview serve u prvom planu pomoću Ctrl+C, ili pozadinski server pomoću agentsview daemon stop. Quick Start kaže da zaustavljanje demona zaustavlja i veb interfejs i praćenje sesija.

Velika promena

Lokalni transkript daje proverljivu početnu tačku za razgovor o troškovima. Rukovodilac inženjerskog tima može pratiti iznos do određenog zabeleženog zadatka i videti da li potiče od agenta ili kataloga cena. Kada je dnevnik nepotpun, izveštaj treba da sačuva tu prazninu.

Izvori i dodatna literatura