Ko dara log_work?
Aģentam nav jāmeklē ID pirms reģistrācijas. Tas izsauc log_work tieši ar aprakstu un jebkuru citu zināmo informāciju. Half5 atrod klientu, projektu un aktivitāti vai uzdod precizējošu jautājumu, ja nav pārliecināts.
Ieraksts tiek saglabāts ar statusu ‘Vēl nav apstiprināts’ jūsu vārdā. Tas nodrošina, ka kontrole paliek jums vai jūsu apstiprinātājam, arī tad, ja darbu aizpildījis aģents. Kā pieslēgt aģentu, lasiet sadaļā Darba stundu reģistrēšana ar Claude, ChatGPT vai Cursor.
Kādus laukus aģents nosūta?
Obligāts ir tikai apraksts. Pārējie lauki palīdz Half5 izvēlēties pareizo klientu un ilgumu. Ja nav norādīts datums, Half5 reģistrē šodienai. Ja nav ilguma, Half5 neko nereģistrē, bet piedāvā savu variantu apstiprināšanai. Ja nav klienta, Half5 pats izvēlas tikai tad, ja viens klients skaidri atbilst vislabāk.
| Lauks | Obligāts | Apraksts |
|---|---|---|
description | Jā | Viena rinda (3–500 rakstzīmes), ko varētu lasīt klients, jūsu valodā, bez failu vai klases nosaukumiem. Šis apraksts var nonākt rēķinā. |
date | Nē | today, yesterday vai datums (YYYY-MM-DD). Ja nav norādīts, tiek izmantots šodienas datums. |
minutes | Nē | Ilgums minūtēs, no 1 līdz 1 440. Ja nav zināms, atstāj tukšu. |
start_time, end_time | Nē | Sākuma un beigu laiks formātā HH:MM. Ja beigu laiks ir pirms sākuma, darbs ir pāri pusnaktij: 21:30 līdz 01:30 ir viens 4 stundu ieraksts sākuma dienā. |
customer, project, activity | Nē | Nosaukums, komercnosaukums vai atsauce. Projekts vienlaikus norāda arī klientu. |
repository | Nē | Git attālinātais repozitorijs, īpašnieks/rep, vai mapes nosaukums. Nekad pilns lokālais ceļš. |
branch, commit_subjects | Nē | Zars un līdz 10 commit tēmas – papildu norādes klientam un projektam. |
session_id | Nē | Aģenta sesijas ID, tikai ja tas ir zināms. |
Kādi ir iespējamie rezultāti?
Katrs izsaukums beidzas ar vienu no četriem statusiem. Katrs no tiem nozīmē atšķirīgu darbību aģentam.
| Rezultāts | Nozīme | Aģenta darbība |
|---|---|---|
created | Ieraksts saglabāts, vēl nav apstiprināts. | Paziņo jums vienā teikumā, kas un kāpēc tika reģistrēts šim klientam. |
preview | Priekšskatījums: kas tiktu reģistrēts. Nekas netiek saglabāts. | Parāda jums priekšlikumu. |
needs_confirmation | Half5 nav pārliecināts, piemēram, par klientu vai trūkst ilguma (‘Cik ilgi strādājāt pie šī?’ ar piedāvāto ilgumu). | Uzdod jums jautājumu un reģistrē tikai pēc jūsu izvēles, tieši ar izvēlēto variantu. |
duplicate | Šāds darbs jau ir reģistrēts. | Atkārtoti nereģistrē. |
Ja nav ilguma, Half5 neko nesaglabā. Priekšlikums, piemēram, var būt no jūsu pēdējā šodienas ieraksta beigām līdz šim brīdim; jūs apstiprināt vai koriģējat to.
Kā Half5 izvēlas klientu un projektu?
Vispirms klients, tad projekts pie šī klienta. Half5 izvērtē visas norādes un reģistrē uzreiz tikai tad, ja viens klients ir acīmredzami piemērotākais. Citādi aģents lūdz izvēlēties no nesenajiem klienta un projekta pāriem.
- Jūsu norādītais. Norādīts klients vai projekts vienmēr ir prioritāte. Ja diviem klientiem ir vienāds nosaukums (piemēram, atšķiras tikai ar lielajiem burtiem), priekšroka ir precīzai atbilstībai, tad klientam, kuram šis repozitorijs jau reģistrēts iepriekš, pēc tam – klientam, kuram visbiežāk reģistrējat. Jautājums tiek uzdots tikai tad, ja neviena no šīm pazīmēm nav izšķiroša.
- Jūsu repozitorija atmiņa. Half5 atceras katram lietotājam, kurš repozitorijs pieder kuram klientam, balstoties uz jūsu apstiprinātajiem vai pārvietotajiem ierakstiem.
- Repozitorija nosaukums. Salīdzina ar klientu (komerc)nosaukumiem, iezīmēm un e-pasta domēniem, kā arī ar projektu nosaukumiem.
- Jūsu vēsture. Iepriekšējie apraksti, kuros minēts repozitorijs, zars vai biļetes numurs, un klienti, kuriem nesen un bieži reģistrējat.
- Apraksts, zars un commit tēmas. Papildu norāde, ne izšķirošais faktors.
Kā darbojas repozitorija atmiņa?
Atmiņa ir jūsu. Kad reģistrējat caur aģentu, pārvietojat šādu ierakstu pie cita klienta vai reģistrējat aģenta darbu Half5 darbvirsmas lietotnē, Half5 atceras, kurš repozitorijs pieder kuram klientam. Nākamreiz aģentam nebūs jāvaicā.
Ja aprakstā skaidri norādīts cits klients nekā atmiņā, Half5 nereģistrē automātiski: aģents vaicā, kurš no abiem ir pareizais. Ja organizācijā ieslēgta opcija ‘Mācīties no kolēģiem’, Half5 var piedāvāt klientu, kuru kolēģis reģistrējis tam pašam repozitorijam. Tā ir tikai rekomendācija; aģents vienmēr vispirms jautā jums, un jūsu atmiņa ir prioritāte.
Kādi rīki ir vēl bez log_work?
Serverī ir seši rīki. Visi darbojas tikai ar jūsu paša stundām, tiem klientiem, projektiem un aktivitātēm, kuri jums ir pieejami organizācijā.
| Rīks | Funkcija | Ierobežojumi |
|---|---|---|
log_work | Reģistrēt darbu | Jauni ieraksti tiek saglabāti kā neapstiprināti |
log_work_batch | Līdz 25 ierakstiem vienā izsaukumā, piemēram, visa nedēļa pēc fakta | Katram ierakstam tie paši pārbaudes un jautājumi kā log_work; viena atbilde uz kopīgu klienta jautājumu attiecas uz visiem ierakstiem, kam tas nepieciešams |
search_customers_projects | Meklēt klientus, projektus un aktivitātes pēc nosaukuma, komercnosaukuma, iezīmes vai e-pasta domēna | Tikai lasīšanai; nav nepieciešams pirms log_work |
list_entries | Sarakstīt savus ierakstus ar dienas kopsummām | Tikai lasīšanai; līdz 31 dienai vienā reizē |
update_entry | Labot vienu no saviem ierakstiem | Tikai neapstiprinātiem ierakstiem un tikai pēc jūsu pieprasījuma |
delete_entry | Dzēst vienu no saviem ierakstiem | Tikai neapstiprinātiem ierakstiem, pēc apstiprinājuma |
Kad ieraksts ir apstiprināts, aģents to vairs nevar mainīt. To varat izdarīt tikai pašā Half5.
Kā to dara Half5
Sadaļā Iestatījumi → ‘Piesaistītie aģenti’ redzams katra savienojuma klienta nosaukums, vai tas ir pārbaudīts, kad pēdējo reizi lietots un kādas tiesības tam ir (skatīt stundas, reģistrēt stundas). ‘Atvienot’ pārtrauc piekļuvi.
Šajā pašā lapā redzama arī jūsu repozitorija atmiņa. Vienu saiti varat dzēst ar ‘Aizmirst ...’, vai sākt no jauna ar ‘Aizmirst visu’. Par datu apstrādi lasiet sadaļā Privātums ar AI aģentiem. R&D projektiem Nīderlandes WBSO ietvaros Half5 nav īpaša WBSO eksporta; kā to iestatīt, skatiet WBSO stundu reģistrēšana ar programmatūru.
Biežāk uzdotie jautājumi
Vai aģentam pirms reģistrācijas jāizsauc search_customers_projects?
Nē. log_work pats atrod klientu un projektu. Meklēšanas rīks paredzēts jautājumiem, piemēram, ‘kādi projekti ir šim klientam?’ vai ja nosaukumi ir līdzīgi.
Kas notiek, ja aģents nosūta vienu un to pašu ierakstu divreiz?
Half5 atpazīst vienādu ierakstu un atgriež duplicate, neveidojot otru reģistrāciju. Aģentam to nevajadzētu reģistrēt atkārtoti.
Vai aģents nosūta manus koda vai failu nosaukumus?
Nedrīkst. Serveris skaidri norāda aģentiem nesūtīt failu ceļus vai kodu; apraksts ir viena rinda, ko varētu lasīt klients, un repozitorijs tiek sūtīts tikai kā nosaukums.
Vai kolēģa atmiņa var noteikt, kuram klientam tiek pieskaitītas manas stundas?
Nē. Kolēģa atmiņa ir tikai ieteikums un tikai tad, ja ieslēgta opcija ‘Mācīties no kolēģiem’. Tad aģents vispirms jautā jums.
Vai aģents var mainīt apstiprinātas stundas?
Nē. update_entry un delete_entry darbojas tikai ar jūsu neapstiprinātajiem ierakstiem. Apstiprinātas stundas maināmas tikai Half5.
