Co dělá log_work?
Agent nemusí před zápisem hledat žádná ID. Zavolá log_work přímo s popisem a tím, co ví. Half5 najde klienta, projekt i aktivitu, nebo se zeptá, pokud si není jistý.
Záznam přijde na vaše jméno jako ‘Zatím neschváleno’. Kontrola tak zůstává u vás nebo vašeho schvalovatele, i když práci vyplnil agent. Jak agenta propojit najdete v Zápis hodin pomocí Claude, ChatGPT nebo Cursor.
Jaká pole agent posílá?
Povinný je pouze popis. Ostatní pole pomáhají Half5 správně určit klienta a délku. Bez data Half5 zapíše dnešek. Bez délky nezapíše nic, ale navrhne čas ke schválení. Bez klienta Half5 vybere klienta jen tehdy, pokud je jeden jasně nejlepší.
| Pole | Povinné | Co znamená |
|---|---|---|
description | Ano | Jednořádkový popis o 3 až 500 znacích, který může číst klient, ve vašem jazyce, bez názvů souborů či tříd. Může se objevit na faktuře. |
date | Ne | today, yesterday nebo datum (YYYY-MM-DD). Pokud chybí, použije se dnešek. |
minutes | Ne | Délka v minutách, 1 až 1 440. Vynechá se, pokud není známa. |
start_time, end_time | Ne | Začátek a konec ve formátu HH:MM. Konec před začátkem znamená práci přes půlnoc: 21:30 až 01:30 je jeden čtyřhodinový záznam na den začátku. |
customer, project, activity | Ne | Název, obchodní jméno nebo reference. Projekt zároveň určuje klienta. |
repository | Ne | Git remote, owner/repo nebo název složky. Nikdy plná lokální cesta. |
branch, commit_subjects | Ne | Větev a až 10 předmětů commitů jako další vodítka pro klienta a projekt. |
session_id | Ne | ID relace agenta, pouze pokud ho skutečně zná. |
Jaké jsou možné výsledky?
Každé volání končí jedním ze čtyř stavů. Každý znamená pro agenta jiný úkol.
| Výsledek | Co znamená | Co udělá agent |
|---|---|---|
created | Záznam je uložen jako zatím neschválený. | Jednou větou vám sdělí, co a proč bylo zapsáno k danému klientovi. |
preview | Nanečisto: co by se zapsalo. Nic se neukládá. | Ukáže vám návrh. |
needs_confirmation | Half5 si není jistý, například klientem, nebo chybí délka (‘Jak dlouho jste na tom pracoval(a)?’ s navrženou délkou). | Položí vám otázku a zapíše až po vašem výběru, přesně podle zvolené možnosti. |
duplicate | Stejná práce už je zapsaná. | Znovu ji nezapíše. |
Bez délky Half5 nic neuloží. Návrh například pokryje čas od konce vašeho posledního dnešního záznamu do teď; potvrdíte nebo upravíte.
Jak Half5 vybírá klienta a projekt?
Nejprve klient, pak projekt u daného klienta. Half5 vyhodnotí dostupná vodítka a zapíše rovnou jen tehdy, když je jeden klient jasně nejlepší. Jinak agent nabídne výběr z vašich posledních kombinací klient-projekt.
- Co pojmenujete. Pojmenovaný klient nebo projekt má vždy přednost. Pokud mají dva klienti stejný název (například jen jiné velké/malé písmeno), rozhoduje přesný zápis, pak klient, ke kterému jste už tento repozitář zapisovali, pak ten, ke kterému zapisujete nejčastěji. Agent se ptá jen, když nic z toho nerozhodne.
- Paměť repozitáře. Half5 si pamatuje pro každého uživatele, který repozitář patří ke kterému klientovi, podle záznamů, které jste potvrdili nebo přesunuli.
- Název repozitáře. Porovnává se s (obchodními) názvy klientů, štítky a e-mailovými doménami, i s názvy projektů.
- Vaše historie. Předchozí popisy, kde je zmíněn repozitář, větev nebo číslo tiketu, a klienti, ke kterým často a nedávno zapisujete.
- Popis, větev a commity. Jako doplňující vodítko, ne jako rozhodující faktor.
Jak funguje paměť repozitáře?
Paměť je vaše. Když zapisujete přes agenta, přesunete záznam ke klientovi, nebo registrujete práci agenta v desktopové aplikaci, Half5 si zapamatuje, který repozitář patří ke kterému klientovi. Příště se agent už nemusí ptát.
Pokud popis jasně uvádí jiného klienta než vaše paměť, Half5 nezapíše bez dotazu: agent se zeptá, který z těch dvou to je. S nastavením organizace ‘Učit se od kolegů’ může Half5 navrhnout klienta, ke kterému stejný repozitář zapsal kolega. Je to ale jen návrh; agent se vždy nejdřív zeptá a vaše paměť má přednost.
Jaké další nástroje kromě log_work existují?
Server nabízí šest nástrojů. Všechny fungují pouze na vašich vlastních hodinách, u klientů, projektů a aktivit, ke kterým máte v organizaci přístup.
| Nástroj | Co dělá | Omezení |
|---|---|---|
log_work | Zápis práce | Nové záznamy jsou vždy nejprve neschválené |
log_work_batch | Až 25 záznamů najednou, například celý týden zpětně | Každý záznam prochází stejnými kontrolami a dotazy jako log_work; jedna odpověď na společný dotaz ke klientovi platí pro všechny záznamy, kterých se týká |
search_customers_projects | Vyhledání klientů, projektů a aktivit podle názvu, obchodního jména, štítku nebo e-mailové domény | Pouze pro čtení; před log_work není potřeba |
list_entries | Výpis vlastních záznamů s denními součty | Pouze pro čtení; maximálně 31 dní najednou |
update_entry | Změna jednoho vlastního záznamu | Pouze záznamy, které ještě nejsou schválené, a jen na vaši žádost |
delete_entry | Smazání jednoho vlastního záznamu | Pouze neschválené záznamy, po potvrzení |
Jakmile je záznam schválen, agent ho už nemůže změnit. To provedete přímo v Half5.
Jak to Half5 řeší
V Nastavení → ‘Propojení agenti’ vidíte název klienta každého propojení, ověření, poslední použití a oprávnění (zobrazit hodiny, zapisovat hodiny). ‘Odpojit’ odebere přístup.
Na stejné stránce najdete i svou paměť repozitářů. Jednotlivé propojení smažete přes ‘Zapomenout …’, nebo vše najednou přes ‘Zapomenout vše’. Co se s těmito daty děje, najdete v Ochrana soukromí u AI agentů. Pro projekty výzkumu a vývoje v rámci nizozemského WBSO Half5 nemá speciální export pro WBSO; jak jej nastavit, najdete v WBSO hodiny v softwaru.
Často kladené dotazy
Musí agent před zápisem volat search_customers_projects?
Ne. log_work najde klienta i projekt sám. Vyhledávání slouží pro dotazy typu ‘jaké projekty má tento klient?’ nebo při nejednoznačných názvech.
Co když agent pošle stejný záznam dvakrát?
Half5 rozpozná stejný záznam a vrátí duplicate místo vytvoření druhé registrace. Agent by jej neměl zapisovat znovu.
Posílá agent můj kód nebo názvy souborů?
Neměl by. Server agentům výslovně říká, aby neposílali cesty k souborům ani kód; popis je jedním řádkem, který může číst klient, a repozitář se posílá pouze jako název.
Může paměť kolegy rozhodnout, ke kterému klientovi jdou moje hodiny?
Ne. Paměť kolegy je maximálně návrh, a to jen pokud je zapnuté ‘Učit se od kolegů’. Agent se pak nejprve zeptá vás.
Může agent měnit už schválené hodiny?
Ne. update_entry a delete_entry fungují jen na vaše vlastní záznamy, které ještě nejsou schválené. Schválené hodiny se mění přímo v Half5.
