Kaj počne log_work?
Agentu ni treba iskati ID-jev pred vnosom. Pokliče log_work neposredno z opisom in vsemi podatki, ki jih ima. Half5 poišče stranko, projekt in aktivnost ali pa zastavi vprašanje, če ni prepričan.
Vnos se pojavi kot »Še ni odobreno« na vaše ime. Tako imate nadzor vi ali vaš odobritelj, tudi če je agent izpolnil delo. Kako povezati agenta, je opisano v Evidenca ur z Claude, ChatGPT ali Cursor.
Katera polja pošlje agent?
Obvezen je le opis. Ostali podatki pomagajo Half5 izbrati pravo stranko in trajanje. Brez datuma Half5 beleži za danes. Brez trajanja ne zabeleži ničesar, ampak predlaga trajanje za potrditev. Brez stranke Half5 sam izbere le, če je ena stranka očitno najbolj ustrezna.
| Polje | Obvezno | Kaj pomeni |
|---|---|---|
description | Da | Enovrstični opis, od 3 do 500 znakov, primeren za stranko, v vašem jeziku, brez imen datotek ali razredov. Lahko se pojavi na računu. |
date | Ne | today, yesterday ali datum (YYYY-MM-DD). Če je izpuščen, velja danes. |
minutes | Ne | Trajanje v minutah, od 1 do 1.440. Izpustite, če trajanje ni znano. |
start_time, end_time | Ne | Začetek in konec v obliki HH:MM. Če je konec pred začetkom, pomeni, da je delo trajalo čez polnoč: 21:30 do 01:30 je en 4-urni vnos na dan začetka. |
customer, project, activity | Ne | Ime, poslovno ime ali referenca. Projekt vedno določa tudi stranko. |
repository | Ne | Git remote, owner/repo ali ime mape. Nikoli celotna lokalna pot. |
branch, commit_subjects | Ne | Branch in do 10 naslovov commitov kot dodatni namigi za stranko in projekt. |
session_id | Ne | ID seje agenta, če ga ta pozna. |
Kakšni so možni izidi?
Vsak klic se zaključi z enim od štirih statusov. Vsak od njih od agenta zahteva nekaj drugega.
| Izid | Kaj pomeni | Kaj naredi agent |
|---|---|---|
created | Vnos je shranjen, še ni odobren. | V eni povedi sporoči, kaj je bilo zabeleženo in zakaj pri tej stranki. |
preview | Predogled: to bi bilo zabeleženo, nič še ni shranjeno. | Prikaže predlog. |
needs_confirmation | Half5 ni prepričan, na primer glede stranke, ali pa manjka trajanje (»Koliko časa ste delali na tem?« s predlaganim trajanjem). | Zastavi vprašanje in zabeleži šele po vaši izbiri, natančno z izbrano možnostjo. |
duplicate | Enako delo je že zabeleženo. | Ponovno ga ne zabeleži. |
Brez trajanja Half5 ne shrani ničesar. Predlog običajno zajema čas od konca vašega zadnjega današnjega vnosa do zdaj; potrdite ali popravite ga.
Kako Half5 izbere stranko in projekt?
Najprej stranka, nato projekt znotraj te stranke. Half5 upošteva vse namige in zabeleži neposredno le, če je ena stranka očitno najbolj ustrezna. Sicer agent ponudi izbiro med vašimi zadnjimi kombinacijami strank in projektov.
- Kar navedete vi. Poimenovana stranka ali projekt imata prednost. Če imata dve stranki enako ime (npr. razlika le v velikih črkah), šteje popolno ujemanje, nato stranka, pri kateri ste ta repozitorij že beležili, nato tista, kjer največkrat beležite. Agent vpraša le, če nič od tega ne odloči.
- Vaš repozitorijski spomin. Half5 si za vsakega uporabnika zapomni, kateri repozitorij pripada kateri stranki, na podlagi vnosov, ki ste jih potrdili ali premaknili.
- Ime repozitorija. Primerja ga z (poslovnimi) imeni, oznakami in e-poštnimi domenami strank ter z imeni projektov.
- Vaša zgodovina. Prejšnji opisi, ki omenjajo repozitorij, branch ali številko tiketa, ter stranke, pri katerih pogosto in nedavno beležite.
- Opis, branch in commiti. Kot dodatni namig, ne kot odločilni dejavnik.
Kako deluje repozitorijski spomin?
Spomin je vaš. Ko beležite prek agenta, premaknete tak vnos k drugi stranki ali registrirate delo agenta v namizni aplikaciji, si Half5 zapomni, kateri repozitorij pripada kateri stranki. Naslednjič agent ne rabi več spraševati.
Če opis jasno navede drugo stranko kot vaš spomin, Half5 ne beleži samodejno: agent vpraša, katera od obeh je prava. Če je v organizaciji vključena možnost »Uči se od sodelavcev«, lahko Half5 predlaga tudi stranko, na katero je isti repozitorij beležil sodelavec. To je le predlog; agent vedno najprej vpraša vas, vaš spomin ima prednost.
Katera orodja so poleg log_work še na voljo?
Strežnik ponuja šest orodij. Vsa delujejo le na vaših urah, s strankami, projekti in aktivnostmi, do katerih imate v organizaciji dostop.
| Orodje | Kaj počne | Omejitve |
|---|---|---|
log_work | Beleženje dela | Novi vnosi so najprej neodobreni |
log_work_batch | Do 25 vnosov naenkrat, npr. cel teden za nazaj | Vsak vnos ima enake preverbe in vprašanja kot log_work; en odgovor na skupno vprašanje o stranki velja za vse vnose, ki ga potrebujejo |
search_customers_projects | Iskanje strank, projektov in aktivnosti po imenu, poslovnem imenu, oznaki ali e-poštni domeni | Samo za branje; pred log_work ni potreben |
list_entries | Seznam vaših vnosov s seštevki po dnevih | Samo za branje; največ 31 dni naenkrat |
update_entry | Spremeni enega od vaših vnosov | Le vnosi, ki še niso odobreni, in le na vašo zahtevo |
delete_entry | Izbriše enega od vaših vnosov | Le vnosi, ki še niso odobreni, po potrditvi |
Ko je vnos odobren, ga agent ne more več spreminjati. To urejate neposredno v Half5.
Tako to reši Half5
Pod Nastavitve → »Povezani agenti« vidite ime stranke za vsako povezavo, ali je preverjena, kdaj je bila nazadnje uporabljena in kaj lahko počne (ogled ur, beleženje ur). »Prekini povezavo« prekliče dostop.
Na isti strani je prikazan tudi vaš repozitorijski spomin. Posamezno povezavo izbrišete z »Pozabi …«, vse skupaj pa z »Pozabi vse«. Kaj se zgodi s temi podatki, je opisano v Zasebnost pri AI agentih. Za R&D projekte v okviru nizozemskega WBSO Half5 nima posebnega WBSO izvoza; navodila za nastavitev so v WBSO ure s programsko opremo.
Pogosta vprašanja
Ali mora agent pred beleženjem uporabiti search_customers_projects?
Ne. log_work sam najde stranko in projekt. Iskalno orodje je namenjeno vprašanjem, kot je »katere projekte ima ta stranka?« ali kadar so imena nejasna.
Kaj se zgodi, če agent pošlje isti vnos dvakrat?
Half5 prepozna isti vnos in vrne duplicate namesto ustvarjanja dvojnega vnosa. Agent ga ne bi smel ponovno beležiti.
Ali agent pošilja mojo kodo ali imena datotek?
Ne bi smel. Strežnik agentom izrecno prepove pošiljanje poti do datotek ali kode; opis je enovrstični, primeren za stranko, repozitorij pa se pošlje le kot ime.
Ali lahko spomin sodelavca določi, kateri stranki se pripišejo moje ure?
Ne. Spomin sodelavca je lahko le predlog, in to le, če je vključena možnost »Uči se od sodelavcev«. Agent vas nato najprej vpraša.
Ali lahko agent še spreminja odobrene ure?
Ne. update_entry in delete_entry delujeta le na vaših vnosih, ki še niso odobreni. Odobrene ure spreminjate v Half5.
