Ce face log_work?
Agentul nu trebuie să caute ID-uri înainte de a înregistra. Apelează direct log_work cu o descriere și orice alte detalii știe. Half5 găsește clientul, proiectul și activitatea sau te întreabă când nu e sigur.
Înregistrarea apare ca ‘Neaprobat încă’ pe numele tău. Astfel, tu sau aprobatorul tău aveți controlul, chiar dacă agentul a completat lucrarea. Cum conectezi un agent găsești în Înregistrarea orelor cu Claude, ChatGPT sau Cursor.
Ce câmpuri trimite agentul?
Doar descrierea e obligatorie. Restul ajută Half5 să aleagă clientul și durata corectă. Fără dată, Half5 înregistrează pe ziua de azi. Fără durată, nu salvează nimic, dar îți propune o durată pe care s-o confirmi. Fără client, Half5 alege singur doar dacă există o potrivire clară.
| Câmp | Obligatoriu | Ce înseamnă |
|---|---|---|
description | Da | O propoziție de 3–500 de caractere, pe care clientul o poate citi, în limba ta, fără nume de fișiere sau clase. Poate ajunge pe factură. |
date | Nu | today, yesterday sau o dată (YYYY-MM-DD). Dacă lipsește, se folosește ziua de azi. |
minutes | Nu | Durata în minute, între 1 și 1.440. Se lasă necompletat dacă durata nu e cunoscută. |
start_time, end_time | Nu | Ora de început și de sfârșit, format HH:MM. Dacă ora de sfârșit e înaintea celei de început, înseamnă că lucrarea a trecut de miezul nopții: 21:30–01:30 e o singură înregistrare de 4 ore pe ziua de start. |
customer, project, activity | Nu | Nume, denumire comercială sau referință. Un proiect implică automat și clientul său. |
repository | Nu | Git remote, owner/repo sau numele folderului. Niciodată calea locală completă. |
branch, commit_subjects | Nu | Branch-ul și până la 10 subiecte de commit, ca indicii suplimentare pentru client și proiect. |
session_id | Nu | ID-ul sesiunii agentului, doar dacă îl știe cu adevărat. |
Care sunt rezultatele posibile?
Fiecare apel se termină cu unul din patru statusuri. Fiecare cere altceva de la agent.
| Rezultat | Ce înseamnă | Ce face agentul |
|---|---|---|
created | Înregistrarea e salvată, dar neaprobată. | Îți spune într-o propoziție ce s-a înregistrat și de ce la acel client. |
preview | O simulare: așa ar arăta înregistrarea. Nu se salvează nimic. | Îți arată propunerea. |
needs_confirmation | Half5 nu e sigur, de exemplu despre client sau lipsește durata (‘Cât ai lucrat la asta?’ cu o durată propusă). | Îți pune întrebarea și înregistrează doar după ce alegi, exact cu opțiunea selectată. |
duplicate | Aceeași lucrare e deja înregistrată. | Nu o mai înregistrează încă o dată. |
Fără durată, Half5 nu salvează nimic. Propunerea acoperă, de exemplu, intervalul de la finalul ultimei tale înregistrări de azi până acum; tu confirmi sau ajustezi.
Cum alege Half5 clientul și proiectul?
Mai întâi clientul, apoi proiectul din cadrul acelui client. Half5 cântărește indiciile pe care le are și înregistrează direct doar dacă există o potrivire clară. Altfel, agentul te întreabă să alegi din combinațiile recente client–proiect.
- Ce numești tu. Un client sau proiect specificat de tine are prioritate. Dacă două firme au același nume (de exemplu, doar cu majuscule diferite), contează scrierea exactă, apoi clientul pe care ai mai înregistrat acest repository, apoi cel pe care îl folosești cel mai des. Agentul întreabă doar dacă niciuna dintre variante nu decide clar.
- Memoria repository-ului tău. Half5 ține minte pentru fiecare utilizator ce repository aparține cărui client, pe baza înregistrărilor confirmate sau mutate de tine.
- Numele repository-ului. Comparat cu denumirile (comerciale), etichetele și domeniile de e-mail ale clienților, dar și cu numele proiectelor.
- Istoricul tău. Descrieri anterioare care menționează repository-ul, branch-ul sau un număr de tichet, plus clienții pe care îi folosești recent și frecvent.
- Descrierea, branch-ul și commit-urile. Ca indiciu suplimentar, nu ca factor decisiv.
Cum funcționează memoria repository-ului?
Memoria e a ta. Când înregistrezi prin agent, muți o astfel de înregistrare la alt client sau salvezi ore agent în aplicația desktop, Half5 ține minte ce repository aparține cărui client. Data viitoare agentul nu te mai întreabă.
Dacă descrierea menționează clar un alt client decât cel din memorie, Half5 nu înregistrează automat: agentul te întreabă care dintre cei doi e corect. Cu opțiunea ‘Învață de la colegi’, Half5 poate sugera și un client pe care un coleg l-a asociat aceluiași repository. E doar o sugestie; agentul te întreabă mereu și memoria ta are prioritate.
Ce alte instrumente există pe lângă log_work?
Serverul oferă șase instrumente. Toate funcționează doar pe orele tale, cu clienții, proiectele și activitățile la care ai acces în organizație.
| Instrument | Ce face | Limitări |
|---|---|---|
log_work | Înregistrează ore | Noile înregistrări apar ca neaprobate |
log_work_batch | Până la 25 de înregistrări dintr-o dată, de exemplu pentru o săptămână întreagă după fapt | Fiecare înregistrare trece prin aceleași verificări și întrebări ca log_work; un singur răspuns la o întrebare comună despre client se aplică tuturor înregistrărilor implicate |
search_customers_projects | Caută clienți, proiecte și activități după nume, denumire comercială, etichetă sau domeniu de e-mail | Doar citire; nu e necesar înainte de log_work |
list_entries | Listează propriile tale înregistrări cu totaluri zilnice | Doar citire; maxim 31 de zile odată |
update_entry | Modifică una dintre înregistrările tale | Doar înregistrări neaprobate, și doar la cererea ta |
delete_entry | Șterge una dintre înregistrările tale | Doar înregistrări neaprobate, după confirmare |
După ce o înregistrare e aprobată, agentul nu o mai poate modifica. Poți face asta doar din Half5.
Cum face Half5
La Setări → ‘Agenți conectați’ vezi numele clientului pentru fiecare conexiune, dacă e verificată, când a fost folosită ultima dată și ce permisiuni are (vizualizare ore, înregistrare ore). ‘Deconectează’ îi retrage accesul.
Pe aceeași pagină vezi și memoria repository-ului tău. Poți șterge o singură asociere cu ‘Uită …’ sau totul cu ‘Uită tot’. Ce se întâmplă cu aceste date găsești în Confidențialitate cu agenți AI. Pentru proiecte R&D sub WBSO (Olanda), Half5 nu are export dedicat WBSO; cum setezi totul e explicat în Ore WBSO cu software.
Întrebări frecvente
Trebuie agentul să apeleze search_customers_projects înainte de înregistrare?
Nu. log_work găsește singur clientul și proiectul. Instrumentul de căutare e util pentru întrebări de tipul ‘ce proiecte are acest client?’ sau când numele sunt ambigue.
Ce se întâmplă dacă agentul trimite aceeași înregistrare de două ori?
Half5 recunoaște înregistrarea identică și returnează duplicate în loc să creeze o dublură. Agentul nu ar trebui să o mai înregistreze încă o dată.
Trimite agentul codul sau numele fișierelor mele?
Nu ar trebui. Serverul îi spune clar agentului să nu trimită căi de fișiere sau cod; descrierea e o propoziție pe care clientul o poate citi, iar repository-ul se trimite doar ca nume.
Poate memoria unui coleg să decidă la ce client se înregistrează orele mele?
Nu. Memoria unui coleg e doar o sugestie, și doar dacă ‘Învață de la colegi’ e activată. Agentul te întreabă mereu pe tine.
Poate agentul să modifice ore deja aprobate?
Nu. update_entry și delete_entry funcționează doar pe propriile tale înregistrări neaprobate. Orele aprobate se modifică direct în Half5.
