Mida log_work teeb?
Agent ei pea enne logimist ID-sid otsima. Ta kutsub otse log_work funktsiooni, lisades kirjelduse ja muu teadaoleva info. Half5 leiab ise kliendi, projekti ja tegevuse või küsib täpsustust, kui pole kindel.
Kanne jõuab teie nimel seisuga ‘Pole veel kinnitatud’. See jätab kontrolli teie või kinnitaja kätte, ka siis, kui töö täitis agent. Kuidas agenti ühendada, leiate juhendist Tundide logimine Claude’i, ChatGPT või Cursoriga.
Milliseid välju agent saadab?
Ainult kirjeldus on kohustuslik. Ülejäänud info aitab Half5-l valida õige kliendi ja kestuse. Kui kuupäev puudub, logitakse tänasele päevale. Kui kestus puudub, ei salvestata midagi, vaid pakutakse kinnitamiseks kestust. Kui klient puudub, valib Half5 selle ise ainult siis, kui üks klient on selgelt parim vaste.
| Väli | Kohustuslik | Sisu |
|---|---|---|
description | Jah | Üherealine, 3–500 tähemärki, kliendile loetav, teie keeles, ilma faili- või klassinimedeta. Võib jõuda arvele. |
date | Ei | today, yesterday või kuupäev (YYYY-MM-DD). Kui puudub, logitakse tänasele päevale. |
minutes | Ei | Kestus minutites, 1 kuni 1 440. Jätke tühjaks, kui kestus pole teada. |
start_time, end_time | Ei | Algus- ja lõpuaeg kujul HH:MM. Kui lõpuaeg on enne algust, kestis töö üle südaöö: 21:30 kuni 01:30 on üks 4-tunnine kanne alguspäeval. |
customer, project, activity | Ei | Nimi, ärinimi või viide. Projekt eeldab ka klienti. |
repository | Ei | Git remote, owner/repo või kaustanimi. Mitte kunagi täistee lokaalses arvutis. |
branch, commit_subjects | Ei | Haru ja kuni 10 commit’i pealkirja, lisavihjetena kliendi ja projekti leidmiseks. |
session_id | Ei | Agendi sessiooni ID, ainult kui see on teada. |
Millised on võimalikud tulemused?
Iga päring lõpeb ühe nelja staatusega. Igaüks neist nõuab agendilt erinevat tegevust.
| Tulemus | Tähendus | Agendi tegevus |
|---|---|---|
created | Kanne salvestatakse, kuid pole veel kinnitatud. | Teavitab teid ühe lausega, mis logiti ja miks just sellele kliendile. |
preview | Eelvaade: näitab, mida logitaks. Midagi ei salvestata. | Näitab teile ettepanekut. |
needs_confirmation | Half5 pole kindel, näiteks kliendi osas või kui kestus puudub (‘Kui kaua selle tööga tegelesite?’ koos ettepanekuga). | Küsib teilt küsimuse ja logib alles pärast teie valikut, täpselt valitud väärtusega. |
duplicate | Sama töö on juba logitud. | Ei logi uuesti. |
Kui kestus puudub, ei salvestata midagi. Ettepanek tehakse näiteks teie viimase tänase kande lõpust kuni praeguseni; saate selle kinnitada või muuta.
Kuidas Half5 valib kliendi ja projekti?
Kõigepealt klient, siis projekt selle kliendi sees. Half5 kaalub kõiki vihjeid ja logib kohe ainult siis, kui üks klient on selgelt parim vaste. Muidu küsib agent teilt valiku hiljutiste kliendi-projekti kombinatsioonide seast.
- Teie nimetatud. Nimetatud klient või projekt on alati eelistatud. Kui kaks klienti jagavad nime (nt erinevad ainult suurtähtede poolest), eelistatakse täpset kirjapilti, siis klienti, kellele olete varem sama repositooriumi loginud, ja seejärel enim logitud klienti. Agent küsib ainult siis, kui ükski neist ei otsusta.
- Teie repositooriumi mälu. Half5 jätab iga kasutaja kohta meelde, milline repositoorium kuulub millisele kliendile, õppides kinnitatud või ümber tõstetud kannetest.
- Repositooriumi nimi. Võrreldakse teie klientide (äri)nimede, siltide ja e-posti domeenidega ning projektinimedega.
- Teie enda ajalugu. Varasemad kirjeldused, kus mainitakse repositooriumi, haru või piletinumbrit, ning kliendid, kellele olete hiljuti ja sageli loginud.
- Kirjeldus, haru ja commit’id. Lisavihjena, mitte otsustava tegurina.
Kuidas töötab repositooriumi mälu?
Mälu kuulub teile. Kui logite agendi kaudu, liigutate sellise kande teisele kliendile või registreerite agendi töö töölaua rakenduses, jätab Half5 meelde, milline repositoorium kuulub millisele kliendile. Järgmisel korral agent enam ei küsi.
Kui kirjeldus nimetab selgelt teist klienti kui teie mälu, ei logi Half5 pimesi: agent küsib, kumba valida. Kui organisatsiooni seadetes on ‘Õpi kolleegidelt’ lubatud, võib Half5 pakkuda ka kolleegi logitud klienti sama repositooriumi puhul. See jääb soovituseks; agent küsib alati teilt ja teie enda mälu on esikohal.
Millised tööriistad on veel peale log_work?
Serveris on kuus tööriista. Kõik töötavad ainult teie enda tundidega ning nende klientide, projektide ja tegevustega, millele teie organisatsioonis ligipääs on.
| Tööriist | Funktsioon | Piirangud |
|---|---|---|
log_work | Tööaja logimine | Uued kanded jõuavad kinnitamata kujul |
log_work_batch | Kuni 25 kannet korraga, näiteks terve nädala tagantjärele logimiseks | Iga kanne saab samad kontrollid ja küsimused nagu log_work; ühine vastus kliendiküsimusele kehtib kõigile vastavat küsivatele kannetele |
search_customers_projects | Otsib kliente, projekte ja tegevusi nime, ärinime, sildi või e-posti domeeni järgi | Ainult lugemiseks; log_work eelnevalt pole vaja kasutada |
list_entries | Loetleb teie enda kanded koos päevade summadega | Ainult lugemiseks; kuni 31 päeva korraga |
update_entry | Muudab ühte teie kannet | Ainult kinnitamata kanded ja ainult teie soovil |
delete_entry | Kustutab ühe teie kande | Ainult kinnitamata kanded, pärast kinnitust |
Kui kanne on kinnitatud, agent seda enam muuta ei saa. Seda saab teha ainult Half5-s.
Nii teeb Half5 seda
Seadetes → ‘Ühendatud agendid’ näete iga ühenduse kliendi nime, kinnituse staatust, viimast kasutusaega ja õigusi (vaata tunde, logi tunde). ‘Katkesta ühendus’ tühistab ligipääsu.
Sama leht näitab teie repositooriumi mälu. Üksiku seose kustutamiseks valige ‘Unusta …’, kõigi kustutamiseks ‘Unusta kõik’. Andmete kasutamise kohta loe lähemalt Privaatsus AI-agentidega. Hollandi WBSO arendusprojektide puhul puudub Half5-s eraldi WBSO ekspordi võimalus; seadistamise juhis on WBSO tundide logimine tarkvaraga.
Korduma kippuvad küsimused
Kas agent peab enne logimist kasutama search_customers_projects?
Ei. log_work leiab ise kliendi ja projekti. Otsingutööriist on mõeldud küsimustele nagu ‘millised projektid sellel kliendil on?’ või kui nimed on segased.
Mis juhtub, kui agent saadab sama kande kaks korda?
Half5 tunneb sama kande ära ja tagastab duplicate uue registreeringu asemel. Agent ei tohiks seda uuesti logida.
Kas agent saadab minu koodi või failinimesid?
Ei tohiks. Server ütleb agentidele selgelt, et failiteid ega koodi ei saadetaks; kirjeldus peab olema üherealine, kliendile loetav, repositoorium saadetakse ainult nimena.
Kas kolleegi mälu võib otsustada, millisele kliendile minu tunnid lähevad?
Ei. Kolleegi mälu on vaid soovitus ja ainult siis, kui ‘Õpi kolleegidelt’ on sisse lülitatud. Agent küsib seejärel kõigepealt teilt.
Kas agent saab muuta kinnitatud tunde?
Ei. update_entry ja delete_entry töötavad ainult teie kinnitamata kannetega. Kinnitatud tunde saab muuta ainult Half5-s.
