Mitä log_work tekee?
Agentin ei tarvitse etsiä tunnisteita ennen kirjausta. Se kutsuu log_work-toimintoa suoraan kuvauksella ja muilla tiedoilla, jotka se tietää. Half5 etsii asiakkaan, projektin ja aktiviteetin – tai kysyy, jos ei ole varma.
Kirjaus tulee nimelläsi tilaan ‘Ei vielä hyväksytty’. Sinulla tai hyväksyjälläsi säilyy siis kontrolli, vaikka agentti täyttäisi tunnit. Ohje agentin yhdistämiseen löytyy kohdasta Tuntien kirjaus Claudella, ChatGPT:llä tai Cursorilla.
Mitkä kentät agentti lähettää?
Vain kuvaus on pakollinen. Muut tiedot auttavat Half5:ttä valitsemaan oikean asiakkaan ja keston. Ilman päivämäärää kirjaus menee tälle päivälle. Ilman kestoa mitään ei kirjata, mutta saat ehdotuksen, jonka voit hyväksyä. Ilman asiakasta Half5 valitsee asiakkaan vain, jos yksi vaihtoehto on selvästi paras.
| Kenttä | Pakollinen | Mitä tarkoittaa |
|---|---|---|
description | Kyllä | Yksi rivi, 3–500 merkkiä, jonka asiakas voisi lukea omalla kielelläsi – ei tiedosto- tai luokkanimiä. Voi päätyä laskulle. |
date | Ei | today, yesterday tai päivämäärä (YYYY-MM-DD). Jos jätät pois, käytetään tätä päivää. |
minutes | Ei | Kesto minuutteina, 1–1 440. Jätetään pois, jos kestoa ei tiedetä. |
start_time, end_time | Ei | Aloitus- ja lopetusaika muodossa HH:MM. Jos lopetusaika on ennen aloitusta, työ jatkui yli keskiyön: 21:30–01:30 on yksi 4 tunnin kirjaus aloituspäivälle. |
customer, project, activity | Ei | Nimi, toiminimi tai viite. Projekti viittaa samalla asiakkaaseen. |
repository | Ei | Git-osoite, owner/repo tai kansion nimi. Ei koskaan koko polkua. |
branch, commit_subjects | Ei | Branch ja enintään 10 commitin otsikkoa, lisävihjeinä asiakkaalle ja projektille. |
session_id | Ei | Agentin session ID, vain jos se oikeasti tietää sen. |
Mitkä ovat mahdolliset lopputulokset?
Jokainen kutsu päättyy yhteen neljästä tilasta. Jokainen vaatii agentilta eri toimintaa.
| Lopputulos | Mitä tarkoittaa | Mitä agentti tekee |
|---|---|---|
created | Kirjaus tallennettu, ei vielä hyväksytty. | Kertoo yhdellä lauseella, mitä kirjattiin ja miksi juuri tälle asiakkaalle. |
preview | Kuivaharjoittelu: näin kirjattaisiin. Mitään ei tallenneta. | Näyttää sinulle ehdotuksen. |
needs_confirmation | Half5 ei ole varma, esimerkiksi asiakkaasta, tai kesto puuttuu (‘Kuinka kauan työskentelit tässä?’ ehdotetulla kestolla). | Kysyy sinulta ja kirjaa vasta valitsemasi vaihtoehdon mukaan. |
duplicate | Sama työ on jo kirjattu. | Ei kirjaa uudelleen. |
Ilman kestoa mitään ei tallenneta. Ehdotus voi olla esimerkiksi edellisen tämän päivän kirjauksen lopusta tähän hetkeen; voit hyväksyä tai muokata sen.
Miten Half5 valitsee asiakkaan ja projektin?
Ensin asiakas, sitten projekti kyseiselle asiakkaalle. Half5 punnitsee kaikki vihjeet ja kirjaa suoraan vain, jos yksi asiakas on selvästi paras. Muuten agentti pyytää sinua valitsemaan viimeaikaisten asiakas–projekti-yhdistelmiesi joukosta.
- Nimeämäsi asiakas. Nimetty asiakas tai projekti menee aina muiden edelle. Jos kahdella asiakkaalla on sama nimi (esim. vain isot kirjaimet eroavat), tarkka kirjoitusasu voittaa, sitten asiakas, jolle olet aiemmin kirjannut tälle repositorylle, sitten se, jolle kirjaat useimmin. Agentti kysyy vain, jos mikään näistä ei ratkaise.
- Repository-muistisi. Half5 muistaa käyttäjäkohtaisesti, mikä repository kuuluu millekin asiakkaalle, perustuen vahvistamiisi tai siirtämiisi kirjauksiin.
- Repositoryn nimi. Verrataan asiakkaiden (toimi)nimiin, tunnisteisiin ja sähköpostidomaineihin sekä projektien nimiin.
- Oma historiasi. Aiemmat kuvaukset, joissa mainitaan repository, branch tai tikettinumero, sekä asiakkaat, joille kirjaat usein ja äskettäin.
- Kuvaus, branch ja commitit. Lisävihjeenä, ei ratkaisevana tekijänä.
Miten repository-muisti toimii?
Muisti on sinun. Kun kirjaat agentilla, siirrät kirjauksen toiselle asiakkaalle tai rekisteröit agentin työn työpöytäsovelluksessa, Half5 muistaa, mikä repository kuuluu millekin asiakkaalle. Seuraavalla kerralla agentin ei tarvitse kysyä.
Jos kuvauksessa mainitaan selvästi toinen asiakas kuin muistissasi, Half5 ei kirjaa sokkona: agentti kysyy, kumpi on oikea. Kun organisaatiossa on asetus ‘Opi kollegoilta’ päällä, Half5 voi ehdottaa asiakasta, jonka kollegasi on kirjannut samalle repositorylle. Tämä on vain ehdotus; agentti kysyy aina ensin ja oma muistisi menee edelle.
Mitkä työkalut löytyvät log_workin lisäksi?
Palvelimella on kuusi työkalua. Kaikki toimivat vain omilla tunneillasi ja niillä asiakkailla, projekteilla ja aktiviteeteilla, joihin sinulla on oikeus organisaatiossasi.
| Työkalu | Mitä tekee | Rajoitukset |
|---|---|---|
log_work | Kirjaa työtunnit | Uudet kirjaukset tulevat tilaan ei vielä hyväksytty |
log_work_batch | Enintään 25 kirjausta kerralla, esimerkiksi koko viikon jälkikäteen | Jokainen kirjaus tarkistetaan ja kysytään kuten log_workissa; yksi vastaus yhteiseen asiakaskysymykseen koskee kaikkia siihen viittaavia kirjauksia |
search_customers_projects | Etsi asiakkaita, projekteja ja aktiviteetteja nimen, toiminimen, tunnisteen tai sähköpostidomainin perusteella | Vain luku; ei tarvita ennen log_workia |
list_entries | Näytä omat kirjaukset ja päivätasot | Vain luku; enintään 31 päivää kerrallaan |
update_entry | Muuta yhtä omaa kirjaustasi | Vain kirjaukset, joita ei ole vielä hyväksytty, ja vain omasta pyynnöstäsi |
delete_entry | Poista yksi oma kirjaus | Vain kirjaukset, joita ei ole vielä hyväksytty, vahvistuksen jälkeen |
Kun kirjaus on hyväksytty, agentti ei voi enää muuttaa sitä. Muutokset teet silloin Half5:ssä.
Näin Half5 toimii
Asetukset → ‘Yhdistetyt agentit’ -kohdassa näet jokaisen yhteyden asiakasnimen, onko se varmennettu, milloin sitä on viimeksi käytetty ja mitä se saa tehdä (näytä tunnit, kirjaa tunnit). ‘Katkaise yhteys’ poistaa oikeudet.
Samalla sivulla näet repository-muistisi. Voit poistaa yksittäisen linkin valitsemalla ‘Unohda …’ tai aloittaa alusta ‘Unohda kaikki’. Tietojen käsittelystä kerrotaan kohdassa Tietosuoja AI-agenttien kanssa. Hollantilaisen WBSO-tutkimus- ja kehityshankkeen tuntien kirjaamiseen ei ole erillistä WBSO-vientiä; ohjeet löytyvät kohdasta WBSO-tunnit ohjelmistolla.
Usein kysytyt kysymykset
Pitääkö agentin käyttää search_customers_projects ennen kirjausta?
Ei tarvitse. log_work löytää asiakkaan ja projektin itse. Hakutyökalu on tarkoitettu kysymyksiin kuten ‘mitä projekteja tällä asiakkaalla on?’ tai jos nimet ovat epäselviä.
Mitä tapahtuu, jos agentti lähettää saman kirjauksen kahdesti?
Half5 tunnistaa saman kirjauksen ja palauttaa duplicate uuden rekisteröinnin sijaan. Agentin ei pidä kirjata sitä uudelleen.
Lähettääkö agentti koodiani tai tiedostonimiä?
Ei pitäisi. Palvelin ohjeistaa agentteja olemaan lähettämättä tiedostopolkuja tai koodia; kuvaus on yksi rivi, jonka asiakas voisi lukea, ja repository lähetetään vain nimenä.
Voiko kollegan muisti päättää, mille asiakkaalle tuntini kirjataan?
Ei voi. Kollegan muisti on korkeintaan ehdotus, ja vain jos ‘Opi kollegoilta’ on päällä. Agentti kysyy sinulta ensin.
Voiko agentti muuttaa hyväksyttyjä tunteja?
Ei voi. update_entry ja delete_entry toimivat vain omiin kirjauksiisi, joita ei ole vielä hyväksytty. Hyväksyttyjä tunteja muutetaan Half5:ssä.
