Hva gjør log_work?
En agent trenger ikke slå opp ID-er før registrering. Den kaller log_work direkte med en beskrivelse og det den ellers vet. Half5 finner riktig kunde, prosjekt og aktivitet, eller spør deg hvis den er usikker.
Registreringen kommer inn som «Ikke godkjent ennå» i ditt navn. Du eller godkjenneren din har alltid siste ord, selv om agenten har fylt ut arbeidet. Hvordan du kobler til en agent finner du i Registrere timer med Claude, ChatGPT eller Cursor.
Hvilke felter sender agenten?
Bare beskrivelse er påkrevd. Resten hjelper Half5 å velge riktig kunde og varighet. Uten dato føres timen på i dag. Uten varighet registreres ingenting, men du får et forslag du kan bekrefte. Uten kunde velger Half5 bare selv hvis én kunde er klart best match.
| Felt | Påkrevd | Forklaring |
|---|---|---|
description | Ja | Én linje på 3 til 500 tegn som en kunde kan lese, på ditt språk, uten fil- eller klassenavn. Kan havne på faktura. |
date | Nei | today, yesterday eller en dato (YYYY-MM-DD). Uten dato brukes i dag. |
minutes | Nei | Varighet i minutter, 1 til 1 440. Utelates hvis varighet ikke er kjent. |
start_time, end_time | Nei | Start- og sluttid som HH:MM. Sluttid før starttid betyr at arbeidet gikk over midnatt: 21:30 til 01:30 blir én 4-timers registrering på startdagen. |
customer, project, activity | Nei | Navn, foretaksnavn eller referanse. Prosjekt innebærer også kunde. |
repository | Nei | Git-remote, owner/repo eller mappenavn. Aldri full lokal sti. |
branch, commit_subjects | Nei | Bransj og opptil 10 commit-meldinger, som ekstra hint til kunde og prosjekt. |
session_id | Nei | Agentens session-ID, kun hvis den faktisk vet det. |
Hvilke utfall kan du få?
Hver kall ender med én av fire statuser. Hver status ber agenten gjøre noe forskjellig.
| Utfall | Betydning | Hva agenten gjør |
|---|---|---|
created | Registreringen er lagret, men ikke godkjent ennå. | Gir deg én setning om hva som ble ført og hvorfor på den kunden. |
preview | En prøve: dette ville blitt registrert. Ingenting lagres. | Viser deg forslaget. |
needs_confirmation | Half5 er usikker, for eksempel på kunde, eller varighet mangler («Hvor lenge jobbet du med dette?» med forslag til varighet). | Stiller deg spørsmålet og registrerer først etter ditt valg, nøyaktig slik du velger. |
duplicate | Samme arbeid er allerede registrert. | Fører det ikke på nytt. |
Uten varighet lagres ingenting. Forslaget går for eksempel fra slutten av siste registrering i dag til nå; du bekrefter eller justerer.
Hvordan velger Half5 kunde og prosjekt?
Først kunde, så prosjekt innenfor den kunden. Half5 vurderer alle hint og fører bare direkte hvis én kunde er klart best match. Ellers spør agenten deg om å velge blant dine siste kunde- og prosjektkombinasjoner.
- Det du oppgir. En navngitt kunde eller prosjekt overstyrer alt. Hvis to kunder har samme navn, for eksempel bare ulik bruk av store bokstaver, vinner nøyaktig skrivemåte, deretter kunden du har ført dette repository på før, deretter den du fører mest på. Agenten spør bare hvis ingen av disse avgjør.
- Repository-minnet ditt. Half5 husker for hver bruker hvilket repository som hører til hvilken kunde, lært fra registreringer du har bekreftet eller flyttet.
- Navnet på repository. Sammenlignes med kundenes (foretaks)navn, etiketter og e-postdomener, og med prosjektnavn.
- Din egen historikk. Tidligere beskrivelser som nevner repository, branch eller et ticketnummer, og kunder du fører på nylig og ofte.
- Beskrivelse, branch og commits. Som ekstra hint, ikke som avgjørende faktor.
Hvordan fungerer repository-minnet?
Minne er personlig. Når du fører via agent, flytter en slik registrering til en annen kunde, eller registrerer agentarbeid i skrivebordsappen, husker Half5 hvilket repository som hører til hvilken kunde. Neste gang slipper agenten å spørre.
Hvis beskrivelsen tydelig nevner en annen kunde enn minnet ditt, fører ikke Half5 blindt: agenten spør hvilken av de to det gjelder. Med organisasjonsinnstillingen «Lær av kolleger» kan Half5 også foreslå en kunde en kollega har ført samme repository på. Det er kun et forslag; agenten spør alltid først, og ditt eget minne går foran.
Hvilke verktøy finnes i tillegg til log_work?
Serveren tilbyr seks verktøy. Alle gjelder kun dine egne timer, med de kundene, prosjektene og aktivitetene du har tilgang til i organisasjonen.
| Verktøy | Funksjon | Begrensninger |
|---|---|---|
log_work | Registrer arbeid | Nye registreringer kommer inn som ikke godkjent ennå |
log_work_batch | Opptil 25 registreringer i én kall, for eksempel en hel uke i etterkant | Hver registrering får samme sjekk og spørsmål som log_work; ett svar på felles kundespørsmål gjelder alle aktuelle registreringer |
search_customers_projects | Søk etter kunder, prosjekter og aktiviteter på navn, foretaksnavn, etikett eller e-postdomene | Kun lesing; ikke nødvendig før log_work |
list_entries | Vis dine egne registreringer med dagssummer | Kun lesing; opptil 31 dager om gangen |
update_entry | Endre én av dine registreringer | Kun registreringer som ikke er godkjent ennå, og bare på din forespørsel |
delete_entry | Slett én av dine registreringer | Kun registreringer som ikke er godkjent ennå, etter bekreftelse |
Når en registrering er godkjent, kan ikke agenten endre den lenger. Det gjør du i Half5.
Slik gjør Half5 det
Under Innstillinger → «Koblede agenter» ser du kundenavn for hver tilkobling, om den er verifisert, når den sist ble brukt og hva den har tilgang til (se timer, føre timer). «Koble fra» fjerner tilgangen.
Samme side viser repository-minnet ditt. Du kan fjerne én kobling med «Glem …», eller starte på nytt med «Glem alt». Hva som skjer med disse dataene finner du i Personvern med AI-agenter. For FoU-prosjekter under nederlandske WBSO har Half5 ingen egen WBSO-eksport; hvordan du setter det opp finner du i WBSO-timer med programvare.
Ofte stilte spørsmål
Må agenten bruke search_customers_projects før registrering?
Nei. log_work finner kunde og prosjekt selv. Søk-verktøyet er ment for spørsmål som «hvilke prosjekter har denne kunden?» eller ved uklare navn.
Hva skjer hvis agenten sender samme registrering to ganger?
Half5 kjenner igjen samme registrering og svarer med duplicate i stedet for å opprette en ny. Agenten skal ikke føre den på nytt.
Sender agenten kode eller filnavnene mine?
Det skal den ikke. Serveren sier tydelig fra til agenter at de aldri skal sende filstier eller kode; beskrivelsen skal være én linje en kunde kan lese, og repository sendes kun som navn.
Kan minnet til en kollega avgjøre hvilken kunde timene mine føres på?
Nei. En kollegas minne gir kun et forslag, og bare hvis «Lær av kolleger» er slått på. Agenten spør deg alltid først.
Kan agenten endre godkjente timer?
Nei. update_entry og delete_entry virker bare på egne registreringer som ikke er godkjent ennå. Godkjente timer endres i Half5.
