Mit csinál a log_work?
Az ügynöknek nem kell ID-kat keresgélnie a rögzítés előtt. Egyszerűen meghívja a log_work-ot egy leírással és azzal, amit még tud. A Half5 megtalálja az ügyfelet, projektet és tevékenységet, vagy kérdez, ha nem biztos benne.
A bejegyzés ‘Még nincs jóváhagyva’ státusszal, a te neveden érkezik. Így nálad vagy a jóváhagyódnál marad a kontroll, még akkor is, ha az ügynök töltötte ki a munkát. Az ügynök csatlakoztatásáról itt olvashatsz: Órák rögzítése Claude, ChatGPT vagy Cursor segítségével.
Milyen mezőket küld az ügynök?
Csak a leírás kötelező. A többi segít a Half5-nak a megfelelő ügyfél és időtartam kiválasztásában. Ha nincs dátum, a Half5 a mai napra könyvel. Ha nincs időtartam, nem rögzít semmit, de javasol egyet, amit jóváhagyhatsz. Ha nincs ügyfél, a Half5 csak akkor választ magától, ha egyértelműen egy ügyfél a legjobb találat.
| Mező | Kötelező | Mit jelent |
|---|---|---|
description | Igen | Egy 3–500 karakteres egysoros, amit az ügyfél is olvashat, saját nyelveden, fájl- vagy osztálynevek nélkül. Számlára is rákerülhet. |
date | Nem | today, yesterday vagy egy dátum (ÉÉÉÉ-HH-NN). Ha nincs megadva, a mai napra kerül. |
minutes | Nem | Időtartam percben, 1-től 1 440-ig. Ha nincs megadva, az időtartam ismeretlen. |
start_time, end_time | Nem | Kezdési és befejezési idő HH:MM formátumban. Ha a befejezés korábban van, mint a kezdés, az éjfél utáni átnyúlást jelent: 21:30-tól 01:30-ig egy 4 órás bejegyzés lesz a kezdőnapon. |
customer, project, activity | Nem | Név, cégnév vagy hivatkozás. Egy projekt megadása automatikusan az ügyfelet is jelenti. |
repository | Nem | Git remote, owner/repo vagy mappa neve. Soha nem teljes helyi elérési út. |
branch, commit_subjects | Nem | A branch és legfeljebb 10 commit tárgya, extra támpontként az ügyfélhez és projekthez. |
session_id | Nem | Az ügynök session ID-ja, csak ha tényleg tudja. |
Milyen eredmények lehetnek?
Minden hívás négyféle státusz egyikével zárul. Mindegyik mást kér az ügynöktől.
| Eredmény | Mit jelent | Mit tesz az ügynök |
|---|---|---|
created | A bejegyzés elmentve, még nincs jóváhagyva. | Egy mondatban elmondja, mit és miért rögzített ennél az ügyfélnél. |
preview | Próba: ezt rögzítené, de még nincs elmentve. | Megmutatja a javaslatot. |
needs_confirmation | A Half5 nem biztos valamiben, például az ügyfélben, vagy hiányzik az időtartam (‘Meddig dolgoztál ezen?’ javasolt időtartammal). | Felkér, hogy válaszolj, és csak a választásod után rögzít, pontosan azzal az opcióval. |
duplicate | Ugyanaz a munka már rögzítve van. | Nem rögzíti újra. |
Időtartam nélkül a Half5 nem ment semmit. A javaslat például a mai utolsó bejegyzésed végétől mostanáig tart; ezt jóváhagyod vagy módosítod.
Hogyan választ ügyfelet és projektet a Half5?
Először ügyfelet, utána azon belül projektet. A Half5 mérlegeli a rendelkezésre álló támpontokat, és csak akkor rögzít azonnal, ha egyértelműen egy ügyfél a legjobb találat. Más esetben az ügynök megkér, hogy válassz a legutóbbi ügyfél–projekt párosításaid közül.
- Amit megnevezel. Egy megadott ügyfél vagy projekt mindent visz. Ha két ügyfél neve csak kis- és nagybetűben tér el, az pontos egyezés nyer, utána az, amelyikhez ezt a repository-t már rögzítetted, végül az, amelyikhez a legtöbbet rögzítesz. Az ügynök csak akkor kérdez, ha ezek egyike sem dönt.
- A repository memóriád. A Half5 felhasználónként megjegyzi, melyik repository melyik ügyfélhez tartozik, a jóváhagyott vagy áthelyezett bejegyzéseid alapján.
- A repository neve. Összeveti az ügyfeleid (cég)neveivel, címkéivel, e-mail domainekkel és a projektek neveivel.
- A saját előzményeid. Korábbi leírások, amelyek említik a repository-t, branchet vagy ticket számot, illetve az ügyfelek, akikre mostanában és gyakran rögzítesz.
- A leírás, branch és commitok. Extra támpontként, de nem döntő szempont.
Hogyan működik a repository memória?
A memória a tiéd. Ha ügynökkel rögzítesz, áthelyezel egy ilyen bejegyzést másik ügyfélhez, vagy az asztali alkalmazásban regisztrálsz ügynök által rögzített munkát, a Half5 megjegyzi, melyik repository melyik ügyfélhez tartozik. Legközelebb az ügynök már nem kérdez.
Ha a leírás egyértelműen más ügyfelet nevez meg, mint amit a memóriád tartalmaz, a Half5 nem rögzít automatikusan: az ügynök megkérdezi, melyik a kettő közül. Ha a szervezeti beállításban engedélyezed a ‘Tanulás kollégáktól’ opciót, a Half5 javasolhat egy ügyfelet, akire egy kolléga már rögzítette ezt a repository-t. Ez csak javaslat; az ügynök mindig először tőled kérdez, és a saját memóriád az elsődleges.
Milyen eszközök vannak még a log_work-on kívül?
A szerver összesen hat eszközt kínál. Mindegyik csak a saját óráidon működik, azokkal az ügyfelekkel, projektekkel és tevékenységekkel, amelyekhez a szervezeteden belül jogosultságod van.
| Eszköz | Mit csinál | Korlátok |
|---|---|---|
log_work | Munka rögzítése | Az új bejegyzések jóváhagyásra várnak |
log_work_batch | Legfeljebb 25 bejegyzés egy hívásban, például egy teljes hét utólagos rögzítéséhez | Minden bejegyzésre ugyanazok az ellenőrzések és kérdések vonatkoznak, mint a log_work-nél; egy közös ügyfélkérdésre adott válasz minden érintett bejegyzésre érvényes |
search_customers_projects | Ügyfelek, projektek és tevékenységek keresése név, cégnév, címke vagy e-mail domain alapján | Csak olvasható; log_work előtt nem szükséges |
list_entries | Saját bejegyzéseid listázása napi összesítéssel | Csak olvasható; egyszerre legfeljebb 31 nap |
update_entry | Egy saját bejegyzés módosítása | Csak a még nem jóváhagyott bejegyzések, és csak a te kérésedre |
delete_entry | Egy saját bejegyzés törlése | Csak a még nem jóváhagyott bejegyzések, megerősítés után |
Ha egy bejegyzés jóvá van hagyva, az ügynök már nem módosíthatja. Ezt a Half5-ban tudod megtenni.
Így csinálja a Half5
A Beállítások → ‘Kapcsolt ügynökök’ alatt látod minden kapcsolat ügyfélnevét, hogy ellenőrzött-e, mikor használtad utoljára, és mire jogosult (órák megtekintése, órák rögzítése). A ‘Leválasztás’ visszavonja a hozzáférést.
Ugyanezen az oldalon találod a repository memóriádat is. Egy kapcsolatot a ‘Felejtés …’ gombbal törölhetsz, vagy a ‘Mindet felejt’ opcióval mindent nullázhatsz. Az adatok kezeléséről itt olvashatsz: Adatvédelem AI ügynökökkel. Hollandiai WBSO-s K+F projektekhez a Half5 nem kínál külön WBSO exportot; a beállítás lépéseit itt találod: WBSO órák szoftverrel.
Gyakori kérdések
Kell az ügynöknek előbb meghívnia a search_customers_projects-et rögzítés előtt?
Nem. A log_work maga választja ki az ügyfelet és a projektet. A kereső eszköz olyan kérdésekhez való, mint például ‘milyen projektjei vannak ennek az ügyfélnek?’ vagy ha a név nem egyértelmű.
Mi történik, ha az ügynök kétszer küldi el ugyanazt a bejegyzést?
A Half5 felismeri az ismétlődő bejegyzést, és duplicate-ot ad vissza új regisztráció helyett. Az ügynöknek nem szabad újra rögzítenie.
Az ügynök elküldi a kódomat vagy a fájlneveket?
Nem szabad. A szerver kifejezetten jelzi az ügynököknek, hogy ne küldjenek fájlútvonalat vagy kódot; a leírás egy egysoros, amit az ügyfél is olvashat, a repository pedig csak névként megy át.
Dönthet egy kolléga memóriája arról, melyik ügyfélhez kerülnek az óráim?
Nem. Egy kolléga memóriája legfeljebb javaslatot ad, és csak ha a ‘Tanulás kollégáktól’ be van kapcsolva. Az ügynök ilyenkor először téged kérdez.
Az ügynök módosíthatja a már jóváhagyott órákat?
Nem. Az update_entry és delete_entry csak a saját, még nem jóváhagyott bejegyzéseiden működik. A jóváhagyott órákat a Half5-ban tudod módosítani.
