Do czego służy log_work?
Agent nie musi szukać ID przed rejestracją. Wywołuje log_work z opisem i tym, co wie. Half5 sam znajduje klienta, projekt i aktywność lub zadaje pytanie, jeśli nie jest pewien.
Wpis trafia na Twoje konto jako „Jeszcze niezatwierdzone”. Dzięki temu kontrola zostaje po Twojej stronie lub u osoby zatwierdzającej, nawet jeśli agent wypełnił dane. Jak podłączyć agenta opisujemy w Rejestracja godzin przez Claude, ChatGPT lub Cursor.
Jakie pola wysyła agent?
Wymagany jest tylko opis. Pozostałe dane pomagają Half5 dobrać właściwego klienta i czas trwania. Bez daty Half5 rejestruje na dziś. Bez czasu trwania nie zapisuje nic, ale proponuje czas do zatwierdzenia. Bez klienta Half5 sam wybiera tylko wtedy, gdy jeden klient pasuje najlepiej.
| Pole | Wymagane | Opis |
|---|---|---|
description | Tak | Jedna linia od 3 do 500 znaków, którą może przeczytać klient, w Twoim języku, bez nazw plików czy klas. Może trafić na fakturę. |
date | Nie | today, yesterday lub data (YYYY-MM-DD). Brak oznacza dziś. |
minutes | Nie | Czas trwania w minutach, od 1 do 1 440. Pomijane, jeśli czas nie jest znany. |
start_time, end_time | Nie | Godzina rozpoczęcia i zakończenia w formacie HH:MM. Jeśli koniec jest przed początkiem, praca trwała przez północ: 21:30–01:30 to jeden wpis 4-godzinny na dzień rozpoczęcia. |
customer, project, activity | Nie | Nazwa, nazwa handlowa lub referencja. Projekt oznacza też klienta. |
repository | Nie | Git remote, owner/repo lub nazwa folderu. Nigdy pełna ścieżka lokalna. |
branch, commit_subjects | Nie | Gałąź i do 10 tematów commitów jako dodatkowe wskazówki dla klienta i projektu. |
session_id | Nie | ID sesji agenta, tylko jeśli faktycznie jest znane. |
Jakie są możliwe wyniki?
Każde wywołanie kończy się jednym z czterech statusów. Każdy wymaga od agenta innej akcji.
| Wynik | Znaczenie | Co robi agent |
|---|---|---|
created | Wpis został zapisany jako niezatwierdzony. | Informuje Cię jednym zdaniem, co i dlaczego zostało zarejestrowane dla tego klienta. |
preview | Symulacja: to byłoby zarejestrowane. Nic nie jest zapisane. | Pokazuje Ci propozycję. |
needs_confirmation | Half5 nie jest pewien, np. co do klienta, lub brakuje czasu (‘Jak długo nad tym pracowałeś?’ z propozycją czasu). | Zadaje Ci pytanie i rejestruje wpis dopiero po Twoim wyborze, dokładnie z wybraną opcją. |
duplicate | Taka sama praca już jest zarejestrowana. | Nie rejestruje ponownie. |
Bez czasu trwania Half5 nic nie zapisuje. Propozycja obejmuje np. czas od końca ostatniego wpisu dziś do teraz; możesz ją zatwierdzić lub zmienić.
Jak Half5 wybiera klienta i projekt?
Najpierw klient, potem projekt u tego klienta. Half5 analizuje dostępne wskazówki i rejestruje od razu tylko wtedy, gdy jeden klient pasuje zdecydowanie najlepiej. W innym przypadku agent poprosi Cię o wybór spośród ostatnich kombinacji klient–projekt.
- To, co podasz. Nazwany klient lub projekt ma pierwszeństwo. Jeśli dwóch klientów ma tę samą nazwę (np. różni się tylko wielkością liter), decyduje dokładna pisownia, potem klient, na którego już rejestrowałeś to repozytorium, a potem ten, którego używasz najczęściej. Agent pyta tylko, gdy nic z tego nie rozstrzyga.
- Twoja pamięć repozytoriów. Half5 zapamiętuje dla każdego użytkownika, które repozytorium należy do którego klienta – na podstawie wpisów, które zatwierdziłeś lub przeniosłeś.
- Nazwa repozytorium. Porównywana z nazwami (handlowymi), etykietami i domenami e-mail klientów oraz z nazwami projektów.
- Twoja historia. Wcześniejsze opisy, w których pojawia się repozytorium, gałąź lub numer zgłoszenia, oraz klienci, na których ostatnio i często rejestrujesz.
- Opis, gałąź i commity. Dodatkowa wskazówka, nie decydująca.
Jak działa pamięć repozytoriów?
To Twoja pamięć. Gdy rejestrujesz przez agenta, przenosisz taki wpis do innego klienta lub rejestrujesz pracę agenta w aplikacji desktopowej, Half5 zapamiętuje, które repozytorium należy do którego klienta. Następnym razem agent nie musi pytać.
Jeśli opis wyraźnie wskazuje innego klienta niż Twoja pamięć, Half5 nie rejestruje automatycznie: agent pyta, o którego z dwóch chodzi. Przy ustawieniu organizacji „Ucz się od współpracowników” Half5 może też zaproponować klienta, na którego ten sam repozytorium zarejestrował kolega. To tylko sugestia – agent zawsze pyta Ciebie, a Twoja pamięć ma pierwszeństwo.
Jakie są inne narzędzia poza log_work?
Serwer udostępnia sześć narzędzi. Wszystkie działają tylko na Twoich godzinach, z klientami, projektami i aktywnościami, do których masz dostęp w swojej organizacji.
| Narzędzie | Co robi | Ograniczenia |
|---|---|---|
log_work | Rejestracja pracy | Nowe wpisy trafiają jako niezatwierdzone |
log_work_batch | Do 25 wpisów na raz, np. cały tydzień po fakcie | Każdy wpis przechodzi te same sprawdzenia i pytania co log_work; jedna odpowiedź na wspólne pytanie o klienta dotyczy wszystkich wpisów, których to dotyczy |
search_customers_projects | Wyszukiwanie klientów, projektów i aktywności po nazwie, nazwie handlowej, etykiecie lub domenie e-mail | Tylko do odczytu; niepotrzebne przed log_work |
list_entries | Lista Twoich wpisów z dziennymi sumami | Tylko do odczytu; maksymalnie 31 dni na raz |
update_entry | Zmień jeden ze swoich wpisów | Tylko wpisy niezatwierdzone i tylko na Twoje żądanie |
delete_entry | Usuń jeden ze swoich wpisów | Tylko wpisy niezatwierdzone, po potwierdzeniu |
Po zatwierdzeniu wpisu agent nie może go już zmienić. Zrobisz to w samym Half5.
Jak to robi Half5
W Ustawieniach → „Połączeni agenci” zobaczysz nazwę klienta każdego połączenia, czy jest zweryfikowane, kiedy ostatnio używane i jakie ma uprawnienia (podgląd godzin, rejestracja godzin). „Odłącz” odbiera dostęp.
Na tej samej stronie znajdziesz swoją pamięć repozytoriów. Możesz usunąć pojedyncze powiązanie przez „Zapomnij …” lub wyczyścić wszystko przez „Zapomnij wszystko”. Co dzieje się z tymi danymi opisujemy w Prywatność przy agentach AI. Dla projektów B+R w ramach holenderskiego WBSO Half5 nie ma dedykowanego eksportu WBSO; jak to skonfigurować opisujemy w Godziny WBSO w oprogramowaniu.
Najczęstsze pytania
Czy agent musi wywołać search_customers_projects przed rejestracją?
Nie. log_work sam znajduje klienta i projekt. Narzędzie wyszukiwania służy do pytań typu „jakie projekty ma ten klient?” lub przy niejednoznacznych nazwach.
Co się stanie, jeśli agent wyśle ten sam wpis dwa razy?
Half5 rozpoznaje taki sam wpis i zwraca duplicate zamiast tworzyć drugi wpis. Agent nie powinien rejestrować go ponownie.
Czy agent wysyła mój kod lub nazwy plików?
Nie powinien. Serwer wyraźnie informuje agentów, by nie przesyłali ścieżek plików ani kodu; opis to jedna linia, którą może przeczytać klient, a repozytorium przesyłane jest tylko jako nazwa.
Czy pamięć kolegi może zdecydować, do którego klienta trafią moje godziny?
Nie. Pamięć kolegi to co najwyżej sugestia i tylko, gdy włączone jest „Ucz się od współpracowników”. Wtedy agent najpierw pyta Ciebie.
Czy agent może zmienić zatwierdzone godziny?
Nie. update_entry i delete_entry działają tylko na Twoich niezatwierdzonych wpisach. Zatwierdzone godziny zmieniasz w Half5.
