Hvad gør log_work?
En agent behøver ikke slå ID’er op først. Den kalder bare log_work med en beskrivelse og det, den ellers ved. Half5 finder selv kunde, projekt og aktivitet – eller spørger, hvis noget er uklart.
Registreringen lander som ‘Ikke godkendt endnu’ i dit navn. Så har du eller din godkender stadig kontrollen, også selvom agenten har udfyldt arbejdet. Hvordan du kobler en agent til, står i Registrer timer med Claude, ChatGPT eller Cursor.
Hvilke felter sender agenten?
Kun beskrivelsen er påkrævet. Resten hjælper Half5 med at vælge den rigtige kunde og varighed. Uden dato bliver det bogført på i dag. Uden varighed bliver intet bogført, men Half5 foreslår en varighed, du kan bekræfte. Uden kunde vælger Half5 kun selv, hvis én kunde tydeligt matcher bedst.
| Felt | Påkrævet | Hvad det er |
|---|---|---|
description | Ja | En linje på 3 til 500 tegn, som en kunde kan læse, på dit sprog, uden fil- eller klassenavne. Kan ende på en faktura. |
date | Nej | today, yesterday eller en dato (YYYY-MM-DD). Udeladt betyder i dag. |
minutes | Nej | Varighed i minutter, 1 til 1.440. Udelades, hvis varigheden ikke kendes. |
start_time, end_time | Nej | Start- og sluttid som HH:MM. En sluttid før starttid betyder, at arbejdet gik over midnat: 21:30 til 01:30 er én registrering på 4 timer på startdatoen. |
customer, project, activity | Nej | Navn, handelsnavn eller reference. Et projekt indebærer også kunden. |
repository | Nej | Git-remote, owner/repo eller mappenavn. Aldrig en fuld lokal sti. |
branch, commit_subjects | Nej | Branchnavn og op til 10 commit-beskeder, som ekstra hints til kunde og projekt. |
session_id | Nej | Agentens session-ID, kun hvis den faktisk kender det. |
Hvilke resultater kan komme?
Hver kald ender med én af fire statusser. Hver beder agenten om noget forskelligt.
| Resultat | Hvad det betyder | Hvad agenten gør |
|---|---|---|
created | Registreringen er gemt, men ikke godkendt endnu. | Fortæller dig med én sætning, hvad der blev registreret, og hvorfor på den kunde. |
preview | En prøve: dette ville blive registreret. Intet er gemt. | Viser dig forslaget. |
needs_confirmation | Half5 er ikke sikker, fx om kunden, eller hvis varigheden mangler (‘Hvor længe arbejdede du på dette?’ med et forslag). | Stiller dig spørgsmålet og registrerer kun, når du har valgt – præcis det valgte. |
duplicate | Det samme arbejde er allerede registreret. | Registrerer det ikke igen. |
Uden varighed gemmer Half5 intet. Forslaget går fx fra slutningen af din sidste registrering i dag til nu; du bekræfter eller retter det.
Hvordan vælger Half5 kunde og projekt?
Først kunden, så projektet under den kunde. Half5 vejer de hints, den har, og registrerer kun direkte, hvis én kunde tydeligt matcher bedst. Ellers beder agenten dig vælge mellem dine seneste kunde/projekt-kombinationer.
- Det du selv angiver. En navngiven kunde eller projekt slår alt andet. Hvis to kunder har samme navn, fx kun forskel i store/små bogstaver, vinder den præcise stavemåde, derefter den kunde du tidligere har registreret dette repository på, derefter den du oftest bruger. Agenten spørger kun, hvis intet af det afgør det.
- Din repository-hukommelse. Half5 husker for hver bruger, hvilket repository hører til hvilken kunde, lært fra registreringer du har bekræftet eller flyttet.
- Repository-navnet. Sammenlignes med dine kunders (handels)navne, labels og e-maildomæner, samt projektnavne.
- Din egen historik. Tidligere beskrivelser, der nævner repository, branch eller et ticketnummer, og kunder du logger på for nylig og ofte.
- Beskrivelse, branch og commits. Som ekstra hint, ikke som afgørelse.
Hvordan fungerer repository-hukommelsen?
Hukommelsen er din. Når du registrerer via en agent, flytter sådan en registrering til en anden kunde, eller registrerer agentarbejde i desktop-appen, husker Half5 hvilket repository der hører til hvilken kunde. Næste gang behøver agenten ikke spørge.
Hvis beskrivelsen tydeligt nævner en anden kunde end din hukommelse, registrerer Half5 ikke blindt: agenten spørger, hvilken af de to det er. Med organisationsindstillingen ‘Lær af kolleger’ kan Half5 også foreslå en kunde, en kollega har registreret samme repository på. Det er kun et forslag; agenten spørger altid først, og din egen hukommelse kommer først.
Hvilke værktøjer findes der udover log_work?
Serveren tilbyder seks værktøjer. Alle virker kun på dine egne timer, med de kunder, projekter og aktiviteter du har adgang til i din organisation.
| Værktøj | Hvad det gør | Begrænsninger |
|---|---|---|
log_work | Registrer arbejde | Nye registreringer er ikke godkendt endnu |
log_work_batch | Op til 25 registreringer i ét kald, fx en hel uge efterfølgende | Hver registrering får samme tjek og spørgsmål som log_work; ét svar på et fælles kundespørgsmål gælder for alle relevante registreringer |
search_customers_projects | Søg kunder, projekter og aktiviteter på navn, handelsnavn, label eller e-maildomæne | Kun læseadgang; ikke nødvendigt før log_work |
list_entries | Vis dine egne registreringer med dagstotaler | Kun læseadgang; op til 31 dage ad gangen |
update_entry | Ret én af dine registreringer | Kun registreringer der ikke er godkendt endnu, og kun på din anmodning |
delete_entry | Slet én af dine registreringer | Kun registreringer der ikke er godkendt endnu, efter bekræftelse |
Når en registrering er godkendt, kan agenten ikke længere ændre den. Det gør du selv i Half5.
Sådan gør Half5
Under Indstillinger → ‘Tilknyttede agenter’ ser du hver forbindelses kundenavn, om den er verificeret, hvornår den sidst blev brugt, og hvad den må (se timer, registrere timer). ‘Afbryd’ fjerner adgangen.
Samme side viser din repository-hukommelse. Du kan fjerne et enkelt link med ‘Glem …’ eller starte forfra med ‘Glem alle’. Hvad der sker med disse data, står i Privatliv med AI-agenter. For R&D-projekter under den hollandske WBSO-ordning har Half5 ikke en dedikeret WBSO-eksport; hvordan du sætter det op, står i WBSO-timer med software.
Ofte stillede spørgsmål
Skal agenten kalde search_customers_projects før registrering?
Nej. log_work finder selv kunde og projekt. Søgeværktøjet er til spørgsmål som ‘hvilke projekter har denne kunde?’ eller hvis navne er tvetydige.
Hvad sker der, hvis agenten sender samme registrering to gange?
Half5 genkender samme registrering og returnerer duplicate i stedet for at oprette en ekstra. Agenten bør ikke registrere den igen.
Sender agenten min kode eller filnavne?
Det må den ikke. Serveren instruerer eksplicit agenter om aldrig at sende filstier eller kode; beskrivelsen er én linje, en kunde kan læse, og repository sendes kun som navn.
Kan en kollegas hukommelse afgøre, hvilken kunde mine timer går til?
Nej. En kollegas hukommelse er kun et forslag, og kun hvis ‘Lær af kolleger’ er slået til. Agenten spørger dig altid først.
Kan agenten stadig ændre godkendte timer?
Nej. update_entry og delete_entry virker kun på dine egne registreringer, der ikke er godkendt endnu. Godkendte timer ændres i Half5.
