Какво прави log_work?
Агентът не трябва да търси ID-та предварително. Извиква log_work директно с описание и каквато друга информация има. Half5 намира клиента, проекта и дейността, или задава въпрос, ако не е сигурен.
Записът пристига като „Все още не е одобрен“ на Ваше име. Така контролът остава при Вас или Вашия одобряващ, дори когато агентът е попълнил работата. Как да свържете агент ще намерите в Регистриране на часове с Claude, ChatGPT или Cursor.
Кои полета изпраща агентът?
Задължително е само описанието. Останалите помагат на Half5 да избере правилния клиент и продължителност. Без дата Half5 записва за днес. Без продължителност не се записва нищо, но се предлага стойност за потвърждение. Без клиент Half5 избира сам само ако един клиент е очевидно най-подходящ.
| Поле | Задължително | Какво е това |
|---|---|---|
description | Да | Един ред от 3 до 500 знака, който клиент може да прочете, на Вашия език, без имена на файлове или класове. Може да се появи във фактура. |
date | Не | today, yesterday или дата (YYYY-MM-DD). Ако липсва, се приема днес. |
minutes | Не | Продължителност в минути, от 1 до 1 440. Пропуска се, ако не е известна. |
start_time, end_time | Не | Начален и краен час във формат HH:MM. Краен час преди начален означава, че работата е минала през полунощ: 21:30 до 01:30 е един 4-часов запис за деня на започване. |
customer, project, activity | Не | Име, търговско име или референция. Проектът автоматично определя и клиента. |
repository | Не | Git remote, owner/repo или име на папка. Никога пълен локален път. |
branch, commit_subjects | Не | Клонът и до 10 commit subjects, като допълнителни подсказки за клиент и проект. |
session_id | Не | Session ID на агента, само ако го знае. |
Какви са възможните резултати?
Всяко извикване завършва с един от четири статуса. Всеки изисква различно действие от агента.
| Резултат | Какво означава | Какво прави агентът |
|---|---|---|
created | Записът е съхранен, но все още не е одобрен. | Уведомява Ви с едно изречение какво е регистрирано и защо при този клиент. |
preview | Тестово изпълнение: това би се регистрирало. Нищо не се записва. | Показва Ви предложението. |
needs_confirmation | Half5 не е сигурен, например за клиента, или липсва продължителност („Колко време работихте по това?“ с предложена стойност). | Задава Ви въпрос и регистрира само след Ваш избор, точно с избраната опция. |
duplicate | Същата работа вече е регистрирана. | Не я регистрира повторно. |
Без продължителност Half5 не записва нищо. Предложението е например от края на последния Ви запис днес до момента; Вие потвърждавате или коригирате.
Как Half5 избира клиент и проект?
Първо клиент, после проект в рамките на този клиент. Half5 претегля всички подсказки и регистрира директно само ако един клиент е очевидно най-подходящ. В противен случай агентът Ви пита да изберете от последните си комбинации клиент/проект.
- Какво посочите Вие. Посочен клиент или проект има най-голяма тежест. Ако двама клиенти имат едно и също име (например с различни главни букви), печели точното изписване, после клиентът, на когото сте регистрирали този repository преди, после този, на когото най-често регистрирате. Агентът пита само ако нищо от това не реши.
- Вашата repository памет. Half5 помни за всеки потребител кой repository към кой клиент принадлежи, научено от потвърдени или преместени от Вас записи.
- Името на repository. Сравнява се с (търговските) имена, етикети и имейл домейни на клиентите, както и с имената на проектите.
- Вашата история. Предишни описания, в които се споменават repository, клон или номер на тикет, и клиенти, на които често и наскоро регистрирате.
- Описанието, клонът и commit-ите. Като допълнителна подсказка, не като решаващ фактор.
Как работи паметта на repository?
Паметта е Ваша. Когато регистрирате чрез агент, преместите такъв запис към друг клиент или регистрирате агентска работа през десктоп приложението, Half5 запомня кой repository към кой клиент принадлежи. Следващия път агентът няма да пита.
Ако в описанието ясно е посочен друг клиент, различен от запомнения, Half5 не регистрира автоматично: агентът пита кой от двата е верен. С настройката „Учи от колеги“ Half5 може да предложи клиент, на когото колега е регистрирал същия repository. Това е само предложение; агентът винаги пита първо, а Вашата памет е с приоритет.
Кои инструменти има освен log_work?
Сървърът предлага шест инструмента. Всички работят само с Вашите собствени часове и с клиентите, проектите и дейностите, до които имате достъп във Вашата организация.
| Инструмент | Какво прави | Ограничения |
|---|---|---|
log_work | Регистриране на работа | Новите записи са неoдобрени |
log_work_batch | До 25 записа наведнъж, например цяла седмица със задна дата | Всеки запис минава през същите проверки и въпроси като log_work; един отговор на общ въпрос за клиент важи за всички записи, които го изискват |
search_customers_projects | Търсене на клиенти, проекти и дейности по име, търговско име, етикет или имейл домейн | Само за четене; не е нужен преди log_work |
list_entries | Списък с Вашите записи с дневни сборове | Само за четене; до 31 дни наведнъж |
update_entry | Промяна на Ваш запис | Само неoдобрени записи и само по Ваше искане |
delete_entry | Изтриване на Ваш запис | Само неoдобрени записи, след потвърждение |
След като записът бъде одобрен, агентът вече не може да го променя. Това става само в Half5.
Как Half5 го прави
В Настройки → „Свързани агенти“ виждате името на клиента за всяка връзка, дали е потвърдена, кога е използвана последно и какви права има (преглед на часове, регистриране на часове). „Прекъсване“ отнема достъпа.
На същата страница е и списъкът с Вашата repository памет. Може да изтриете отделна връзка с „Забрави …“ или да започнете начисто с „Забрави всички“. Какво се случва с тези данни е описано в Поверителност при AI агенти. За R&D проекти по холандската WBSO, Half5 няма специален WBSO експорт; настройката е описана в WBSO часове със софтуер.
Често задавани въпроси
Трябва ли агентът да извика search_customers_projects преди регистриране?
Не. log_work сам намира клиента и проекта. Инструментът за търсене е за въпроси като „кои проекти има този клиент?“ или при неясни имена.
Какво става, ако агентът изпрати един и същ запис два пъти?
Half5 разпознава дублиращ се запис и връща duplicate вместо да създаде втори. Агентът не трябва да го регистрира отново.
Изпраща ли агентът мой код или имена на файлове?
Не трябва. Сървърът изрично указва на агентите никога да не изпращат файлови пътища или код; описанието е един ред, който клиент може да прочете, а repository се изпраща само като име.
Може ли паметта на колега да определи при кой клиент отиват моите часове?
Не. Паметта на колега е само предложение и само ако „Учи от колеги“ е включено. Агентът първо пита Вас.
Може ли агентът да променя вече одобрени часове?
Не. update_entry и delete_entry работят само с Ваши неoдобрени записи. Одобрените се променят в Half5.
