Documentație tehnică

Documentație

Ghiduri tehnice pentru crawling, indexare, setări de domeniu, API, contorizare și integrarea ZENIA Assistant.

Metering

ZENIA urmărește utilizarea mesajelor de chat la două niveluri: la nivel de spațiu de lucru, pentru totalul tuturor domeniilor tale, și per domeniu, pentru a vedea cât consumă fiecare website individual. Astfel poți înțelege mai ușor unde se folosește cota lunară a planului.

Counting

Cum se contorizează mesajele

1. Fiecare întrebare trimisă de un vizitator prin widgetul de chat contează ca 1 mesaj.
2. Răspunsul asistentului nu contează ca mesaj separat.
3. În mod normal, sunt contorizate doar mesajele procesate cu succes. Dacă mesajul nu poate fi procesat, contorul poate rămâne neschimbat.
4. Contoarele lunare se resetează la începutul fiecărei luni calendaristice, conform regulilor de contorizare ale sistemului.
Usage

Unde vezi utilizarea

PaginăCe afișează
Prezentare generalăMesajele folosite în luna curentă și numărul de website-uri active, afișate cu bare de progres.
DomeniiUn sumar compact al utilizării, cu mesaje, website-uri și planul activ.
Detalii domeniu → Prezentare generalăUtilizarea lunară pentru domeniul respectiv, împreună cu totalul spațiului de lucru pentru context.
Cont → Planul meuLimitele planului, utilizarea curentă și funcționalitățile disponibile pentru cont.
Cont → UtilizareIstoricul lunar al mesajelor, atunci când datele istorice sunt disponibile.
Detalii domeniu → Istoric de utilizareIstoricul lunar al mesajelor pentru un domeniu individual, afișat într-un panou dedicat.
Realtime

Actualizări în interfață

Unele contoare se pot actualiza automat în paginile deschise ale panoului, atunci când sistemul primește informații noi despre utilizare. Alte valori pot apărea după reîncărcarea paginii sau după următoarea verificare automată. Pentru integrările API sau pentru fluxurile care nu trimit actualizări live, poate exista o mică întârziere până când totalurile sunt afișate în interfață.
Limits

Ce se întâmplă la limită?

Când spațiul tău de lucru atinge limita lunară de mesaje, mesajele noi pot fi blocate până la resetarea lunară sau până la trecerea la un plan cu limită mai mare.

Pentru vizitatori - widgetul poate afișa un mesaj că limita lunară a fost atinsă.

Pentru tine - panoul poate afișa un avertisment și poate marca limita ca atinsă în barele de utilizare.

Pentru rezolvare - poți reduce utilizarea, poți aștepta resetarea lunară sau poți trece la un plan compatibil, dacă opțiunea este disponibilă pentru contul tău.
Breakdown

Defalcare per domeniu

Utilizarea este urmărită și per domeniu, astfel încât să poți vedea ce website consumă cele mai multe mesaje.

Mesaje domeniu - câte mesaje a procesat domeniul respectiv în luna curentă.

Total spațiu de lucru - totalul mesajelor folosite de toate domeniile din cont. Acesta este totalul comparat cu limita lunară a planului.
History

Istoric de utilizare

Pe lângă contoarele lunii curente, ZENIA poate afișa date istorice de utilizare. Acestea te ajută să observi tendințe, să identifici domeniile cu trafic mai mare și să alegi un plan potrivit pentru volumul real de mesaje.
LocațieCe afișează
Cont → UtilizareUn grafic și un sumar lunar pentru mesajele folosite la nivelul spațiului de lucru, atunci când istoricul este disponibil.
Detalii domeniu → Istoric de utilizareUn panou dedicat cu istoricul lunar al mesajelor pentru domeniul selectat.
Relay flow

Cum se aplică limitele

Limitele sunt aplicate înainte ca mesajele noi să fie procesate de asistent. Dacă limita lunară este atinsă, ZENIA poate opri mesajele suplimentare și poate afișa un avertisment în widget sau în panou. Această verificare protejează contul de utilizare peste limita planului și ajută la menținerea unui consum predictibil.
Message relay flow
Visitor → Indexer (quota check) → chat.buildbot.ro (AI/LLM)
                                  ↑
                         Blocked if over limit
Storage

Niveluri de contorizare

Datele de utilizare sunt organizate pe niveluri diferite, ca să poți vedea atât totalul contului, cât și consumul fiecărui domeniu.
NivelPerioadăScop
Spațiu de lucruLunarTotalul mesajelor folosite de toate domeniile, comparat cu limita planului.
DomeniuLunarUtilizarea individuală a fiecărui website, utilă pentru analiză și optimizare.
Events

Actualizări și verificări

Interfața poate actualiza sau verifica datele de utilizare în mai multe situații:
SituațieUnde apareScop
Verificarea utilizării domeniilorPanoul de domeniiAfișează câte mesaje au fost folosite de fiecare domeniu în luna curentă.
Actualizarea totalului contuluiPanoul contuluiActualizează totalul mesajelor folosite la nivelul spațiului de lucru.
Actualizarea unui domeniuPagina de detalii a domeniuluiActualizează contorul domeniului atunci când există date noi de utilizare.
Atingerea unei limiteWidget și panouAfișează un avertisment când limita de mesaje sau website-uri este atinsă.
Citirea istoricului contuluiCont → UtilizareAfișează istoricul lunar al mesajelor la nivelul spațiului de lucru.
Citirea istoricului pe domeniuDetalii domeniu → Istoric de utilizareAfișează istoricul lunar al mesajelor pentru domeniul selectat.
FAQ

FAQ

Q: Răspunsul asistentului contează ca mesaj?
A: Nu. În mod normal, contează întrebarea trimisă de vizitator, nu răspunsul generat de asistent.

Q: Ce se întâmplă dacă mesajul nu poate fi procesat?
A: Dacă mesajul eșuează înainte să fie procesat corect, acesta poate să nu fie contorizat. Verifică istoricul de utilizare dacă observi diferențe între trafic și mesajele afișate în panou.

Q: Când se resetează contorul?
A: Contorul se resetează lunar, conform regulilor de contorizare ale sistemului.

Q: Pot vedea utilizarea din lunile anterioare?
A: Da, atunci când istoricul este disponibil. Mergi la Cont → Utilizare pentru totalul spațiului de lucru sau la Detalii domeniu → Istoric de utilizare pentru un domeniu individual.

Q: Utilizarea prin API apare imediat în panou?
A: Nu întotdeauna. Unele fluxuri se pot actualiza automat, iar altele apar după următoarea verificare sau după reîncărcarea paginii.