Na čo slúži log_work?
Agent nemusí pred zápisom vyhľadávať ID. Zavolá log_work priamo s popisom a ďalšími údajmi, ktoré pozná. Half5 nájde klienta, projekt a aktivitu, alebo sa opýta, ak si nie je istý.
Záznam sa zobrazí pod vaším menom ako „Zatiaľ neschválené“. Kontrola tak zostáva na vás alebo vašom schvaľovateľovi, aj keď prácu zadal agent. Ako agenta pripojiť, nájdete v Evidencia hodín s Claude, ChatGPT alebo Cursor.
Ktoré polia agent posiela?
Povinný je len popis. Ostatné polia pomáhajú Half5 správne priradiť klienta a trvanie. Ak chýba dátum, Half5 zaeviduje dnešný deň. Ak chýba trvanie, Half5 nič nezapíše, ale navrhne trvanie na potvrdenie. Ak chýba klient, Half5 ho vyberie len vtedy, ak je jednoznačne najvhodnejší.
| Pole | Povinné | Popis |
|---|---|---|
description | Áno | Jednoriadkový popis od 3 do 500 znakov, ktorý môže čítať klient, vo vašom jazyku, bez názvov súborov či tried. Môže sa objaviť na faktúre. |
date | Nie | today, yesterday alebo dátum (YYYY-MM-DD). Ak pole chýba, použije sa dnešný deň. |
minutes | Nie | Trvanie v minútach, 1 až 1 440. Ak nie je známe, pole sa vynechá. |
start_time, end_time | Nie | Začiatok a koniec vo formáte HH:MM. Ak je koniec pred začiatkom, práca pokračovala cez polnoc: 21:30 až 01:30 je jeden 4-hodinový záznam na deň začiatku. |
customer, project, activity | Nie | Názov, obchodné meno alebo referencia. Projekt zároveň určuje klienta. |
repository | Nie | Git remote, owner/repo alebo názov priečinka. Nikdy nie úplná lokálna cesta. |
branch, commit_subjects | Nie | Veta s názvom vetvy a až 10 predmetov commitov ako ďalšie indície pre klienta a projekt. |
session_id | Nie | ID relácie agenta, len ak ho naozaj pozná. |
Aké sú možné výsledky?
Každé volanie končí jedným zo štyroch stavov. Každý znamená inú požiadavku na agenta.
| Výsledok | Čo znamená | Čo robí agent |
|---|---|---|
created | Záznam je uložený, zatiaľ neschválený. | V jednej vete vám oznámi, čo a prečo bolo zaevidované k danému klientovi. |
preview | Náhľad: toto by sa zaevidovalo, nič sa neuloží. | Zobrazí vám návrh. |
needs_confirmation | Half5 si nie je istý, napríklad klientom, alebo chýba trvanie („Ako dlho ste na tom pracovali?“ s navrhnutým časom). | Opýta sa vás a zaeviduje až po vašom výbere, presne podľa zvolenej možnosti. |
duplicate | Rovnaká práca už bola zaevidovaná. | Nezapisuje znova. |
Ak nie je zadané trvanie, Half5 nič neuloží. Návrh trvania je napríklad od konca vášho posledného záznamu dnes až po aktuálny čas; vy ho potvrdíte alebo upravíte.
Ako Half5 vyberá klienta a projekt?
Najprv klient, potom projekt v rámci klienta. Half5 zhodnotí všetky dostupné indície a zapíše priamo len vtedy, ak je jeden klient jasne najvhodnejší. Inak sa agent opýta na výber z vašich posledných kombinácií klient-projekt.
- Čo zadáte vy. Zadaný klient alebo projekt má najvyššiu prioritu. Ak majú dvaja klienti rovnaký názov (napríklad len iné veľké písmená), rozhoduje presný zápis, potom klient, ku ktorému ste už tento repozitár evidovali, potom najčastejšie používaný klient. Agent sa pýta len v prípade, že nič z toho nerozhodne.
- Vaša pamäť repozitára. Half5 si pamätá pre každého používateľa, ktorý repozitár patrí ktorému klientovi, podľa záznamov, ktoré ste potvrdili alebo presunuli.
- Názov repozitára. Porovnáva sa s (obchodnými) názvami, štítkami a e-mailovými doménami vašich klientov, aj s názvami projektov.
- Vaša vlastná história. Predchádzajúce popisy, ktoré spomínajú repozitár, vetvu alebo číslo tiketu, a klienti, ktorých evidujete často a nedávno.
- Popis, vetva a commity. Ako doplnková indícia, nie ako rozhodujúci faktor.
Ako funguje pamäť repozitára?
Pamäť je vaša. Ak evidujete cez agenta, presuniete záznam k inému klientovi alebo registrujete agentovu prácu v desktopovej aplikácii, Half5 si zapamätá, ktorý repozitár patrí ku ktorému klientovi. Nabudúce sa agent už nemusí pýtať.
Ak popis jasne uvádza iného klienta ako vaša pamäť, Half5 nezapíše automaticky: agent sa opýta, ktorého z dvoch zvoliť. Pri nastavení organizácie „Učiť sa od kolegov“ môže Half5 navrhnúť klienta, ktorého na ten istý repozitár evidoval kolega. Je to však len návrh; agent sa vždy najprv opýta vás a vaša vlastná pamäť má prednosť.
Aké ďalšie nástroje sú okrem log_work?
Server ponúka šesť nástrojov. Všetky fungujú len na vašich vlastných hodinách, s klientmi, projektmi a aktivitami, ku ktorým máte v organizácii prístup.
| Nástroj | Čo robí | Obmedzenia |
|---|---|---|
log_work | Evidencia práce | Nové záznamy sú najprv neschválené |
log_work_batch | Až 25 záznamov naraz, napríklad celý týždeň spätne | Každý záznam prechádza rovnakými kontrolami a otázkami ako log_work; jedna odpoveď na otázku ku klientovi platí pre všetky záznamy, ktorých sa týka |
search_customers_projects | Vyhľadávanie klientov, projektov a aktivít podľa názvu, obchodného mena, štítku alebo e-mailovej domény | Len na čítanie; pred log_work nie je potrebné |
list_entries | Zoznam vašich záznamov s dennými súčtami | Len na čítanie; maximálne 31 dní naraz |
update_entry | Úprava jedného z vašich záznamov | Len neschválené záznamy a len na vašu žiadosť |
delete_entry | Vymazanie jedného z vašich záznamov | Len neschválené záznamy, po potvrdení |
Po schválení záznamu ho agent už nemôže meniť. Úpravy vykonáte priamo v Half5.
Ako to Half5 rieši
V Nastaveniach → „Prepojení agenti“ vidíte názov klienta každého prepojenia, či je overené, kedy bolo naposledy použité a aké má oprávnenia (zobraziť hodiny, evidovať hodiny). „Odpojiť“ zruší jeho prístup.
Na tej istej stránke nájdete aj svoju pamäť repozitárov. Jedno prepojenie vymažete cez „Zabudnúť …“, alebo všetko naraz cez „Zabudnúť všetko“. Ako sa s týmito údajmi nakladá, nájdete v Ochrana súkromia pri AI agentoch. Pri projektoch výskumu a vývoja podľa holandského WBSO nemá Half5 špeciálny export pre WBSO; nastavenie je popísané v WBSO hodiny so softvérom.
Často kladené otázky
Musí agent pred evidenciou volať search_customers_projects?
Nie. log_work nájde klienta a projekt sám. Vyhľadávanie slúži na otázky typu „aké projekty má tento klient?“ alebo pri nejednoznačných názvoch.
Čo sa stane, ak agent pošle rovnaký záznam dvakrát?
Half5 rozpozná rovnaký záznam a vráti duplicate namiesto vytvorenia druhej evidencie. Agent by ho nemal zapisovať znova.
Posiela agent môj kód alebo názvy súborov?
Nemal by. Server agentom výslovne prikazuje neposielať cesty k súborom ani kód; popis je jedna veta vhodná pre klienta a repozitár sa posiela len ako názov.
Môže pamäť kolegu rozhodnúť, ku ktorému klientovi idú moje hodiny?
Nie. Pamäť kolegu je maximálne návrh a len ak je zapnuté „Učiť sa od kolegov“. Agent sa potom najprv opýta vás.
Môže agent meniť už schválené hodiny?
Nie. update_entry a delete_entry fungujú len na vašich vlastných neschválených záznamoch. Schválené hodiny sa menia priamo v Half5.
