Vad gör log_work?
En agent behöver inte leta upp ID:n innan den loggar. Den anropar log_work direkt med en beskrivning och det den vet. Half5 hittar kund, projekt och aktivitet, eller ställer en fråga om det är oklart.
Registreringen hamnar som ‘Inte godkänd än’ i ditt namn. Det ger dig eller din attestant kontrollen, även när agenten fyllt i arbetet. Hur du kopplar en agent finns i Registrera timmar med Claude, ChatGPT eller Cursor.
Vilka fält skickar agenten?
Endast beskrivningen är obligatorisk. Resten hjälper Half5 att välja rätt kund och tid. Utan datum bokar Half5 på idag. Utan tid bokas inget, men ett förslag ges för dig att bekräfta. Utan kund väljer Half5 bara själv när en kund är tydligt bäst.
| Fält | Obligatoriskt | Vad det är |
|---|---|---|
description | Ja | En rad på 3 till 500 tecken som en kund kan läsa, på ditt språk, utan fil- eller klassnamn. Kan hamna på en faktura. |
date | Nej | today, yesterday eller ett datum (ÅÅÅÅ-MM-DD). Utelämnas betyder idag. |
minutes | Nej | Tidsåtgång i minuter, 1 till 1 440. Lämnas tomt om tiden är okänd. |
start_time, end_time | Nej | Start- och sluttid som HH:MM. En sluttid före starttid betyder att arbetet gick över midnatt: 21:30 till 01:30 blir en 4-timmars post på startdagen. |
customer, project, activity | Nej | Namn, företagsnamn eller referens. Ett projekt innebär också dess kund. |
repository | Nej | Git-remote, owner/repo eller mappnamn. Aldrig en full lokal sökväg. |
branch, commit_subjects | Nej | Branch och upp till 10 commit-meddelanden, som extra ledtrådar för kund och projekt. |
session_id | Nej | Agentens session-ID, endast om den faktiskt vet det. |
Vilka utfall kan man få?
Varje anrop slutar i ett av fyra statusar. Varje utfall kräver olika svar från agenten.
| Utfall | Vad det betyder | Vad agenten gör |
|---|---|---|
created | Registreringen sparas, som inte godkänd än. | Berättar i en mening vad som loggats och varför på den kunden. |
preview | En förhandsvisning: detta skulle loggas. Inget sparas. | Visar dig förslaget. |
needs_confirmation | Half5 är osäker, t.ex. om kund eller om tid saknas (‘Hur länge arbetade du med detta?’ med ett förslag). | Ställer frågan till dig och loggar först efter ditt val, exakt enligt det du valt. |
duplicate | Samma arbete är redan loggat. | Loggar det inte igen. |
Utan tid sparar Half5 inget. Förslaget gäller t.ex. från slutet av din senaste post idag till nu; du bekräftar eller justerar.
Hur väljer Half5 kund och projekt?
Först kund, sedan projekt inom den kunden. Half5 väger de ledtrådar som finns och loggar bara direkt när en kund är tydligt bäst. Annars ber agenten dig välja bland dina senaste kund- och projektkombinationer.
- Det du anger. En namngiven kund eller projekt går före allt annat. Om två kunder har samma namn, t.ex. bara skiljer på versaler, vinner exakt stavning, sedan den kund du loggat detta repository på tidigare, sedan den du loggar mest på. Agenten frågar bara när inget av detta avgör.
- Ditt repository-minne. Half5 minns per användare vilket repository som hör till vilken kund, baserat på poster du bekräftat eller flyttat.
- Repository-namnet. Jämförs med dina kunders (företags)namn, etiketter och e-postdomäner, samt projektnamn.
- Din egen historik. Tidigare beskrivningar som nämner repository, branch eller ärendenummer, och kunder du loggar på nyligen och ofta.
- Beskrivningen, branch och commits. Som extra ledtråd, inte avgörande.
Hur fungerar repository-minnet?
Minnet är ditt. När du loggar via en agent, flyttar en sådan post till en annan kund eller registrerar agentarbete i desktop-appen, minns Half5 vilket repository som hör till vilken kund. Nästa gång behöver agenten inte fråga.
Om beskrivningen tydligt nämner en annan kund än ditt minne, loggar Half5 inte blint: agenten frågar vilken av de två det gäller. Med organisationsinställningen ‘Lär av kollegor’ kan Half5 även föreslå en kund en kollega loggat samma repository på. Det är bara ett förslag; agenten frågar alltid först och ditt eget minne går före.
Vilka verktyg finns utöver log_work?
Servern erbjuder sex verktyg. Alla fungerar bara på dina egna timmar, med de kunder, projekt och aktiviteter du har tillgång till i organisationen.
| Verktyg | Vad det gör | Begränsningar |
|---|---|---|
log_work | Logga arbete | Nya poster hamnar som inte godkända än |
log_work_batch | Upp till 25 poster i ett anrop, t.ex. en hel vecka i efterhand | Varje post får samma kontroller och frågor som log_work; ett svar på en gemensam kundfråga gäller för alla poster som frågar |
search_customers_projects | Sök kunder, projekt och aktiviteter på namn, företagsnamn, etikett eller e-postdomän | Endast läsning; behövs inte före log_work |
list_entries | Lista dina egna poster med dagssummor | Endast läsning; max 31 dagar åt gången |
update_entry | Ändra en av dina poster | Endast poster som inte är godkända än, och bara på din begäran |
delete_entry | Ta bort en av dina poster | Endast poster som inte är godkända än, efter bekräftelse |
När en post är godkänd kan agenten inte längre ändra den. Det gör du själv i Half5.
Så gör Half5
Under Inställningar → ‘Länkade agenter’ ser du varje kopplings kundnamn, om den är verifierad, när den senast användes och vad den får göra (visa timmar, logga timmar). ‘Koppla från’ tar bort åtkomsten.
På samma sida ser du även ditt repository-minne. Du tar bort en enskild koppling med ‘Glöm …’, eller börjar om med ‘Glöm alla’. Vad som händer med dessa data finns i Integritet med AI-agenter. För FoU-projekt enligt nederländska WBSO finns ingen särskild WBSO-export i Half5; hur du ställer in det finns i WBSO-timmar med mjukvara.
Vanliga frågor
Behöver agenten anropa search_customers_projects innan den loggar?
Nej. log_work hittar själv kund och projekt. Sökverktyget är till för frågor som ‘vilka projekt har denna kund?’ eller för namn som är otydliga.
Vad händer om agenten skickar samma post två gånger?
Half5 känner igen samma post och returnerar duplicate istället för att skapa en ny registrering. Agenten ska inte logga den igen.
Skickar agenten min kod eller filnamn?
Det ska den inte. Servern instruerar uttryckligen agenter att aldrig skicka filsökvägar eller kod; beskrivningen är en rad en kund kan läsa, och repository skickas bara som namn.
Kan en kollegas minne avgöra vilken kund mina timmar loggas på?
Nej. En kollegas minne ger högst ett förslag, och bara om ‘Lär av kollegor’ är aktiverat. Agenten frågar då dig först.
Kan agenten ändra godkända timmar?
Nej. update_entry och delete_entry fungerar bara på dina egna poster som inte är godkända än. Godkända timmar ändras i Half5.
