Wat doet log_work?
Een agent hoeft geen ID’s op te zoeken voordat hij boekt. Hij roept log_work direct aan met een omschrijving en wat hij verder weet. Half5 zoekt de klant, het project en de activiteit erbij, of stelt een vraag als dat niet zeker is.
De boeking komt binnen als ‘Nog niet goedgekeurd’ op jouw naam. Zo blijft de controle bij jou of je goedkeurder, ook als de agent het werk heeft ingevuld. Hoe je een agent koppelt, staat in Uren registreren met Claude, ChatGPT of Cursor.
Welke velden stuurt de agent mee?
Alleen de omschrijving is verplicht. De rest helpt Half5 om de juiste klant en duur te kiezen. Ontbreekt een veld, dan vult Half5 het niet op de gok in.
| Veld | Verplicht | Wat het is |
|---|---|---|
description | Ja | Eén regel van 3 tot 500 tekens die een klant mag lezen, in jouw taal, zonder bestands- of klassennamen. Kan op een factuur komen. |
date | Nee | today, yesterday of een datum (JJJJ-MM-DD). Weglaten betekent vandaag. |
minutes | Nee | Duur in minuten, 1 tot 1440. Weglaten als de duur niet bekend is. |
start_time, end_time | Nee | Begin- en eindtijd als UU:MM. |
customer, project, activity | Nee | Naam, handelsnaam of verwijzing. Een project bepaalt ook de klant. |
repository | Nee | Git-remote, eigenaar/repo of de mapnaam. Nooit een volledig lokaal pad. |
branch, commit_subjects | Nee | De branch en maximaal 10 commit-onderwerpen, als extra aanwijzing voor klant en project. |
session_id | Nee | Het sessie-ID van de agent, alleen als hij dat echt weet. |
Welke uitkomsten zijn er?
Elke aanroep eindigt in een van vier statussen. De agent hoort daar telkens iets anders mee te doen.
| Uitkomst | Wat het betekent | Wat de agent doet |
|---|---|---|
created | De boeking is opgeslagen, als nog niet goedgekeurd. | Vertelt je in één zin wat er is geboekt en waarom op die klant. |
preview | Een proefrun: dit zou er geboekt worden. Er is niets opgeslagen. | Laat je het voorstel zien. |
needs_confirmation | Half5 twijfelt, bijvoorbeeld over de klant, of de duur ontbreekt (‘Hoe lang heb je hieraan gewerkt?’ met een voorgestelde duur). | Stelt je de vraag en boekt pas na jouw keuze, met precies de gekozen optie. |
duplicate | Hetzelfde werk staat al geboekt. | Boekt niet nog een keer. |
Zonder duur slaat Half5 niets op. Het voorstel loopt bijvoorbeeld van het einde van je laatste boeking van vandaag tot nu; jij bevestigt of past het aan.
Hoe kiest Half5 de klant en het project?
Eerst de klant, daarna het project binnen die klant. Half5 weegt de aanwijzingen die er zijn en boekt alleen direct als één klant duidelijk de beste is. Anders vraagt de agent je te kiezen uit je recente combinaties van klant en project.
- Wat je zelf noemt. Een genoemde klant of project gaat voor alles.
- Je repository-geheugen. Half5 onthoudt per gebruiker welke repository bij welke klant hoort, geleerd van boekingen die je bevestigde of verplaatste.
- De naam van de repository. Vergeleken met de (handels)naam, labels en het e-maildomein van je klanten, en met projectnamen.
- Je eigen geschiedenis. Eerdere omschrijvingen waarin de repository, branch of een ticketnummer voorkomt, en klanten waar je recent en vaak op boekt.
- De omschrijving, branch en commits. Als extra aanwijzing, niet als beslissing.
Hoe werkt het repository-geheugen?
Het geheugen is van jou. Boek je via een agent, verplaats je zo’n boeking naar een andere klant of registreer je agentwerk in de desktop-app, dan onthoudt Half5 welke repository bij welke klant hoort. De volgende keer hoeft de agent het niet te vragen.
Noemt de omschrijving duidelijk een andere klant dan je geheugen, dan boekt Half5 niet blind: de agent vraagt welke van de twee het is. Met de organisatie-instelling ‘Leren van collega’s’ kan Half5 ook een klant voorstellen die een collega op dezelfde repository boekte. Dat blijft een voorstel; de agent vraagt het altijd eerst na en je eigen geheugen gaat voor.
Welke tools zijn er naast log_work?
De server biedt vijf tools. Ze werken allemaal alleen op jouw eigen uren, met de klanten, projecten en activiteiten die jij in je organisatie mag zien.
| Tool | Wat het doet | Grenzen |
|---|---|---|
log_work | Werk boeken | Nieuwe boekingen komen binnen als nog niet goedgekeurd |
search_customers_projects | Klanten, projecten en activiteiten zoeken op naam, handelsnaam, label of e-maildomein | Alleen lezen; niet nodig vóór log_work |
list_entries | Je eigen boekingen met dagtotalen opvragen | Alleen lezen; maximaal 31 dagen per keer |
update_entry | Een eigen boeking aanpassen | Alleen boekingen die nog niet zijn goedgekeurd, en alleen op jouw verzoek |
delete_entry | Een eigen boeking verwijderen | Alleen niet-goedgekeurde boekingen, na bevestiging |
Is een boeking al goedgekeurd, dan kan de agent hem niet meer wijzigen. Dat doe je in Half5 zelf.
Zo doet Half5 het
Onder Instellingen → ‘Gekoppelde agents’ zie je per verbinding de naam van de client, of hij geverifieerd is, wanneer hij voor het laatst is gebruikt en wat hij mag (‘Uren bekijken’, ‘Uren registreren’). Met ‘Ontkoppelen’ trek je de toegang in.
Op dezelfde pagina staat je ‘Repository-geheugen’. Per repository wis je een koppeling met ‘Vergeet …’; met ‘Alles vergeten’ begin je opnieuw. Wat er met deze gegevens gebeurt, lees je in Privacy bij AI-agents. Voor WBSO-projecten geldt dat Half5 geen aparte WBSO-export heeft; hoe je dat inricht staat in WBSO-uren bijhouden met software.
Veelgestelde vragen
Moet de agent eerst search_customers_projects aanroepen voordat hij boekt?
Nee. log_work zoekt de klant en het project zelf. De zoektool is bedoeld voor vragen als ‘welke projecten heeft deze klant?’ of als een naam dubbelzinnig is.
Wat gebeurt er als de agent dezelfde boeking twee keer doorstuurt?
Half5 herkent dezelfde boeking en geeft duplicate terug in plaats van een tweede registratie. De agent hoort dan niet opnieuw te boeken.
Stuurt de agent mijn code of bestandsnamen mee?
Dat hoort hij niet te doen. De server vraagt agents expliciet nooit bestandspaden of code te sturen; de omschrijving is één regel die een klant mag lezen, en de repository alleen als naam.
Kan een collega via het geheugen bepalen op welke klant mijn uren komen?
Nee. Het geheugen van een collega levert hooguit een voorstel op, en alleen als de instelling ‘Leren van collega’s’ aan staat. De agent vraagt het dan eerst aan jou.
Kan de agent goedgekeurde uren nog wijzigen?
Nee. update_entry en delete_entry werken alleen op je eigen boekingen die nog niet zijn goedgekeurd. Goedgekeurde uren pas je aan in Half5.
