Ką daro log_work?
Agentui nereikia ieškoti ID prieš registruojant laiką. Jis tiesiog kviečia log_work su aprašymu ir kita turima informacija. Half5 pats suranda klientą, projektą ir veiklą arba užduoda klausimą, jei nėra tikras.
Įrašas atsiranda kaip „Dar nepatvirtinta“ jūsų vardu. Tai leidžia jums ar jūsų tvirtintojui išlaikyti kontrolę, net jei įrašą užpildė agentas. Kaip prijungti agentą, rasite Darbo laiko registravimas su Claude, ChatGPT ar Cursor.
Kokius laukus siunčia agentas?
Privalomas tik aprašymas. Kiti laukai padeda Half5 tiksliau parinkti klientą ir trukmę. Jei nėra datos, Half5 registruoja šiandienai. Jei nėra trukmės, Half5 nieko neregistruoja, bet pasiūlo trukmę patvirtinimui. Jei nėra kliento, Half5 pats parenka tik tada, kai vienas klientas aiškiai tinka labiausiai.
| Laukas | Privalomas | Kas tai |
|---|---|---|
description | Taip | Viena eilutė (3–500 simbolių), kurią galėtų perskaityti klientas, jūsų kalba, be failų ar klasių pavadinimų. Gali būti rodoma sąskaitoje. |
date | Ne | today, yesterday arba data (YYYY-MM-DD). Jei nenurodyta, laikoma, kad šiandien. |
minutes | Ne | Trukmė minutėmis, nuo 1 iki 1 440. Paliekama tuščia, jei trukmė nežinoma. |
start_time, end_time | Ne | Pradžios ir pabaigos laikas (HH:MM). Jei pabaigos laikas ankstesnis už pradžios, darbas truko per vidurnaktį: 21:30–01:30 – tai vienas 4 val. įrašas tos dienos, kai pradėta. |
customer, project, activity | Ne | Pavadinimas, veiklos pavadinimas ar nuoroda. Projektas taip pat nurodo ir klientą. |
repository | Ne | Git nuotolinė saugykla, owner/repo arba aplanko pavadinimas. Niekada ne pilnas vietinis kelias. |
branch, commit_subjects | Ne | Šaka ir iki 10 commit aprašymų – papildomos užuominos klientui ir projektui. |
session_id | Ne | Agentas nurodo tik jei tikrai žino savo sesijos ID. |
Kokie galimi rezultatai?
Kiekvienas kvietimas baigiasi viena iš keturių būsenų. Kiekviena jų agentui reiškia skirtingą veiksmą.
| Rezultatas | Ką tai reiškia | Ką daro agentas |
|---|---|---|
created | Įrašas išsaugotas, dar nepatvirtintas. | Praneša jums vienu sakiniu, kas užregistruota ir kodėl pasirinktas tas klientas. |
preview | Bandomasis įrašas: parodoma, kas būtų registruota. Nieko neišsaugoma. | Parodo pasiūlymą. |
needs_confirmation | Half5 nėra tikras, pavyzdžiui, dėl kliento ar trūksta trukmės („Kiek laiko dirbote?“ su pasiūlyta trukme). | Užduoda jums klausimą ir registruoja tik po jūsų pasirinkimo, tiksliai su jūsų pasirinkta reikšme. |
duplicate | Toks pats darbas jau užregistruotas. | Iš naujo neregistruoja. |
Be trukmės Half5 nieko neišsaugo. Pasiūlymas, pavyzdžiui, gali būti nuo paskutinio jūsų šiandienos įrašo pabaigos iki dabar; jūs patvirtinate arba pakoreguojate.
Kaip Half5 parenka klientą ir projektą?
Pirmiausia klientas, tada projektas to kliento viduje. Half5 įvertina visas turimas užuominas ir registruoja iš karto tik tada, kai vienas klientas aiškiai tinka labiausiai. Priešingu atveju agentas paprašo jūsų pasirinkti iš paskutinių naudotų klientų ir projektų derinių.
- Ką nurodote jūs. Nurodytas klientas ar projektas visada svarbiausias. Jei du klientai turi tą patį pavadinimą (pvz., skiriasi tik didžiosiomis raidėmis), laimi tikslus atitikimas, tada klientas, kuriam jau registravote šią saugyklą, tada dažniausiai naudojamas klientas. Agentas klausia tik jei nė vienas iš šių kriterijų nelemia.
- Jūsų saugyklos atmintis. Half5 kiekvienam naudotojui įsimena, kuri saugykla priklauso kuriam klientui, remiantis jūsų patvirtintais ar perkeltais įrašais.
- Saugyklos pavadinimas. Lyginamas su jūsų klientų (įmonių) pavadinimais, žymomis, el. pašto domenais ir projektų pavadinimais.
- Jūsų istorija. Ankstesni aprašymai, kuriuose minimas saugykla, šaka ar bilieto numeris, ir klientai, kuriems dažnai registruojate laiką.
- Aprašymas, šaka ir commit'ai. Papildoma užuomina, bet ne lemiamas veiksnys.
Kaip veikia saugyklos atmintis?
Atmintis priklauso jums. Kai registruojate per agentą, perkeliat tokį įrašą kitam klientui ar registruojate agento darbą per darbalaukio programą, Half5 įsimena, kuri saugykla priklauso kuriam klientui. Kitą kartą agentui nebereikės klausti.
Jei aprašyme aiškiai nurodytas kitas klientas nei jūsų atmintyje, Half5 neregistruoja automatiškai: agentas paklausia, kuris iš dviejų yra teisingas. Jei organizacijoje įjungta „Mokytis iš kolegų“, Half5 gali pasiūlyti klientą, kuriam kolega jau registravo tą pačią saugyklą. Tai tik pasiūlymas – agentas visada klausia jūsų, o jūsų atmintis svarbiausia.
Kokie dar yra įrankiai be log_work?
Serveris siūlo šešis įrankius. Visi jie veikia tik su jūsų pačių darbo laiku ir tik su tais klientais, projektais bei veiklomis, kuriuos galite matyti savo organizacijoje.
| Įrankis | Ką daro | Ribojimai |
|---|---|---|
log_work | Registruoti darbą | Nauji įrašai atsiranda kaip nepatvirtinti |
log_work_batch | Iki 25 įrašų vienu kartu, pvz., už visą savaitę atgaline data | Kiekvienas įrašas tikrinamas kaip log_work; vienas atsakymas į bendrą kliento klausimą taikomas visiems įrašams, kuriems to reikia |
search_customers_projects | Ieškoti klientų, projektų ir veiklų pagal pavadinimą, įmonės pavadinimą, žymą ar el. pašto domeną | Tik skaitymui; nereikia prieš log_work |
list_entries | Rodyti savo įrašus su dienos suvestinėmis | Tik skaitymui; iki 31 dienos vienu metu |
update_entry | Keisti vieną savo įrašą | Tik nepatvirtintus įrašus ir tik jūsų prašymu |
delete_entry | Ištrinti vieną savo įrašą | Tik nepatvirtintus įrašus, po patvirtinimo |
Kai įrašas patvirtintas, agentas jo keisti nebegali. Tai atliekama tik Half5 sistemoje.
Kaip tai daro Half5
Nustatymuose → „Susieti agentai“ matysite kiekvieno ryšio kliento pavadinimą, ar jis patvirtintas, kada paskutinį kartą naudotas ir kokias teises turi (peržiūrėti laiką, registruoti laiką). „Atsieti“ atima prieigą.
Toje pačioje puslapyje rasite ir savo saugyklos atmintį. Vieną ryšį ištrinate su „Pamiršti …“, viską – su „Pamiršti viską“. Kaip tvarkomi šie duomenys, aprašyta Privatumas su AI agentais. R&D projektams pagal Nyderlandų WBSO schemą Half5 neturi specialaus WBSO eksporto; kaip tai nustatyti, rasite WBSO valandų registravimas su programine įranga.
Dažniausiai užduodami klausimai
Ar agentui reikia kviesti search_customers_projects prieš registruojant laiką?
Ne. log_work pats suranda klientą ir projektą. Paieškos įrankis skirtas klausimams, pvz., „kokius projektus turi šis klientas?“ arba kai pavadinimai dviprasmiški.
Kas nutiks, jei agentas atsiųs tą patį įrašą du kartus?
Half5 atpažįsta tą patį įrašą ir grąžina duplicate vietoj naujos registracijos. Agentas neturėtų registruoti dar kartą.
Ar agentas siunčia mano kodo ar failų pavadinimus?
Neturėtų. Serveris aiškiai nurodo agentams niekada nesiųsti failų kelių ar kodo; aprašymas – viena eilutė, kurią gali perskaityti klientas, o saugykla siunčiama tik kaip pavadinimas.
Ar kolegos atmintis gali nulemti, kuriam klientui priskiriamas mano laikas?
Ne. Kolegos atmintis gali tik pasiūlyti, ir tik jei įjungta „Mokytis iš kolegų“. Agentas visada pirmiausia klausia jūsų.
Ar agentas gali keisti jau patvirtintą laiką?
Ne. update_entry ir delete_entry veikia tik su jūsų nepatvirtintais įrašais. Patvirtintą laiką keičiate tik Half5 sistemoje.
