A cosa serve log_work?
Un agente non deve cercare ID prima di registrare. Chiama direttamente log_work con una descrizione e tutto quello che sa. Half5 trova cliente, progetto e attività, oppure fa una domanda se non è sicuro.
La registrazione arriva come ‘Non ancora approvata’ a tuo nome. Così il controllo resta a te o al tuo approvatore, anche se l’agente ha compilato i dati. Come collegare un agente è spiegato in Registrare ore con Claude, ChatGPT o Cursor.
Quali campi invia l’agente?
Solo la descrizione è obbligatoria. Gli altri campi aiutano Half5 a scegliere cliente e durata giusti. Senza data, Half5 registra su oggi. Senza durata, non registra nulla ma ti propone una durata da confermare. Senza cliente, Half5 lo sceglie solo se uno è chiaramente il più adatto.
| Campo | Obbligatorio | Cosa significa |
|---|---|---|
description | Sì | Una riga da 3 a 500 caratteri, leggibile anche dal cliente, nella tua lingua, senza nomi di file o classi. Potrebbe finire in fattura. |
date | No | today, yesterday oppure una data (YYYY-MM-DD). Se omesso, vale oggi. |
minutes | No | Durata in minuti, da 1 a 1.440. Si lascia vuoto se la durata non è nota. |
start_time, end_time | No | Ora di inizio e fine in formato HH:MM. Se l’ora di fine è prima dell’inizio, il lavoro è passato oltre la mezzanotte: 21:30–01:30 è una registrazione di 4 ore sul giorno di partenza. |
customer, project, activity | No | Nome, ragione sociale o riferimento. Un progetto implica anche il suo cliente. |
repository | No | Git remote, owner/repo o nome della cartella. Mai un percorso locale completo. |
branch, commit_subjects | No | Il branch e fino a 10 oggetti commit, come indizi extra per cliente e progetto. |
session_id | No | L’ID di sessione dell’agente, solo se lo conosce davvero. |
Quali sono gli esiti possibili?
Ogni chiamata termina con uno di quattro stati. Ognuno richiede qualcosa di diverso all’agente.
| Esito | Cosa significa | Cosa fa l’agente |
|---|---|---|
created | La registrazione è salvata, ma non ancora approvata. | Ti dice in una frase cosa è stato registrato e perché su quel cliente. |
preview | Simulazione: ecco cosa verrebbe registrato. Nulla viene salvato. | Ti mostra la proposta. |
needs_confirmation | Half5 non è sicuro, ad esempio sul cliente, oppure manca la durata (‘Quante ore hai lavorato su questo?’ con una durata proposta). | Ti fa la domanda e registra solo dopo la tua scelta, esattamente come hai deciso. |
duplicate | Lo stesso lavoro è già stato registrato. | Non lo registra di nuovo. |
Senza durata, Half5 non salva nulla. La proposta va, ad esempio, dalla fine della tua ultima registrazione di oggi fino ad ora; puoi confermare o modificare.
Come sceglie Half5 cliente e progetto?
Prima il cliente, poi il progetto di quel cliente. Half5 valuta tutti gli indizi e registra subito solo se un cliente è chiaramente il più adatto. Altrimenti l’agente ti chiede di scegliere tra le combinazioni cliente/progetto usate di recente.
- Quello che indichi tu. Un cliente o progetto nominato batte tutto. Se due clienti hanno lo stesso nome (magari solo con maiuscole diverse), vince la scrittura esatta, poi il cliente su cui hai già registrato questo repository, poi quello che usi di più. L’agente chiede solo se nessuno di questi criteri decide.
- La memoria dei tuoi repository. Half5 ricorda per ogni utente quale repository appartiene a quale cliente, imparando dalle registrazioni che confermi o sposti.
- Il nome del repository. Confrontato con i nomi (commerciali), etichette e domini e-mail dei tuoi clienti, e con i nomi dei progetti.
- La tua cronologia. Descrizioni precedenti che citano repository, branch o numeri di ticket, e i clienti su cui registri spesso e di recente.
- Descrizione, branch e commit. Come indizio aggiuntivo, non come criterio decisivo.
Come funziona la memoria dei repository?
La memoria è personale. Quando registri tramite un agente, sposti una registrazione su un altro cliente o registri lavoro dell’agente dall’app desktop, Half5 ricorda a quale cliente appartiene quel repository. Così la prossima volta l’agente non deve chiedere.
Se la descrizione indica chiaramente un cliente diverso da quello in memoria, Half5 non registra alla cieca: l’agente ti chiede quale dei due è giusto. Con l’impostazione ‘Impara dai colleghi’, Half5 può suggerire anche un cliente su cui un collega ha registrato lo stesso repository. Resta solo un suggerimento: l’agente chiede sempre prima a te e la tua memoria ha la precedenza.
Quali strumenti ci sono oltre a log_work?
Il server offre sei strumenti. Tutti funzionano solo sulle tue ore, con i clienti, progetti e attività che puoi vedere nella tua organizzazione.
| Strumento | Cosa fa | Limiti |
|---|---|---|
log_work | Registra lavoro | Le nuove registrazioni arrivano come non ancora approvate |
log_work_batch | Fino a 25 registrazioni in una chiamata, ad esempio per una settimana intera dopo | Ogni registrazione riceve gli stessi controlli e domande di log_work; una risposta a una domanda condivisa sul cliente vale per tutte le registrazioni che la pongono |
search_customers_projects | Cerca clienti, progetti e attività per nome, ragione sociale, etichetta o dominio e-mail | Sola lettura; non serve prima di log_work |
list_entries | Elenca le tue registrazioni con totali giornalieri | Sola lettura; massimo 31 giorni per volta |
update_entry | Modifica una tua registrazione | Solo registrazioni non ancora approvate, e solo su tua richiesta |
delete_entry | Elimina una tua registrazione | Solo registrazioni non ancora approvate, dopo conferma |
Dopo l’approvazione, l’agente non può più modificare la registrazione. Puoi farlo solo da Half5.
Ecco come funziona Half5
In Impostazioni → ‘Agenti collegati’ vedi il nome cliente di ogni connessione, se è verificata, l’ultimo utilizzo e cosa può fare (vedere ore, registrare ore). ‘Disconnetti’ revoca l’accesso.
Nella stessa pagina trovi la memoria dei tuoi repository. Puoi eliminare un singolo collegamento con ‘Dimentica …’, oppure azzerare tutto con ‘Dimentica tutto’. Come vengono gestiti questi dati è spiegato in Privacy con agenti AI. Per progetti R&D sotto la WBSO olandese, Half5 non ha un’esportazione WBSO dedicata; come configurare è spiegato in Ore WBSO con software.
Domande frequenti
L’agente deve chiamare search_customers_projects prima di registrare?
No. log_work trova da solo cliente e progetto. Lo strumento di ricerca serve per domande tipo ‘quali progetti ha questo cliente?’ o per nomi ambigui.
Cosa succede se l’agente invia due volte la stessa registrazione?
Half5 riconosce la stessa registrazione e restituisce duplicate invece di crearne una seconda. L’agente non deve registrarla di nuovo.
L’agente invia il mio codice o nomi di file?
Non dovrebbe. Il server dice chiaramente agli agenti di non inviare mai percorsi di file o codice; la descrizione è una riga leggibile dal cliente e il repository viene inviato solo come nome.
La memoria di un collega può decidere a quale cliente vanno le mie ore?
No. La memoria di un collega può solo suggerire, e solo se ‘Impara dai colleghi’ è attivo. L’agente poi chiede sempre prima a te.
L’agente può ancora modificare ore già approvate?
No. update_entry e delete_entry funzionano solo sulle tue registrazioni non ancora approvate. Le ore approvate si modificano in Half5.
