Τι κάνει το log_work;
Ο agent δεν χρειάζεται να βρει IDs πριν καταγράψει εργασία. Καλεί το log_work απευθείας με μια περιγραφή και ό,τι άλλο γνωρίζει. Το Half5 βρίσκει τον πελάτη, το έργο και τη δραστηριότητα ή σας ρωτά όταν δεν είναι σίγουρο.
Η καταχώρηση εμφανίζεται ως «Δεν έχει εγκριθεί ακόμα» στο όνομά σας. Έτσι διατηρείτε εσείς ή ο εγκρίνων τον έλεγχο, ακόμα κι αν ο agent συμπλήρωσε την εργασία. Οδηγίες σύνδεσης agent θα βρείτε στο Καταγραφή ωρών με Claude, ChatGPT ή Cursor.
Ποια πεδία στέλνει ο agent;
Μόνο η περιγραφή είναι υποχρεωτική. Τα υπόλοιπα βοηθούν το 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 | Όχι | Το branch και έως 10 commit subjects, ως επιπλέον ενδείξεις για πελάτη και έργο. |
session_id | Όχι | Το session ID του agent, μόνο αν το γνωρίζει πραγματικά. |
Ποια είναι τα πιθανά αποτελέσματα;
Κάθε κλήση καταλήγει σε μία από τέσσερις καταστάσεις. Κάθε μία ζητά κάτι διαφορετικό από τον agent.
| Αποτέλεσμα | Τι σημαίνει | Τι κάνει ο agent |
|---|---|---|
created | Η καταχώρηση αποθηκεύτηκε, ως μη εγκεκριμένη. | Σας ενημερώνει με μία πρόταση τι καταγράφηκε και γιατί σε αυτόν τον πελάτη. |
preview | Δοκιμαστική καταχώρηση: τι θα καταγραφόταν. Δεν αποθηκεύεται τίποτα. | Σας δείχνει την πρόταση. |
needs_confirmation | Το Half5 δεν είναι σίγουρο, π.χ. για τον πελάτη ή λείπει η διάρκεια («Πόση ώρα εργαστήκατε;» με προτεινόμενη διάρκεια). | Σας κάνει την ερώτηση και καταγράφει μόνο μετά την επιλογή σας, ακριβώς όπως επιλέξατε. |
duplicate | Η ίδια εργασία έχει ήδη καταγραφεί. | Δεν την καταγράφει ξανά. |
Χωρίς διάρκεια, το Half5 δεν αποθηκεύει τίποτα. Η πρόταση, π.χ., ξεκινά από το τέλος της τελευταίας σας καταχώρησης σήμερα μέχρι τώρα· εσείς επιβεβαιώνετε ή διορθώνετε.
Πώς επιλέγει το Half5 πελάτη και έργο;
Πρώτα ο πελάτης, μετά το έργο του. Το Half5 σταθμίζει τις ενδείξεις που έχει και καταγράφει απευθείας μόνο όταν ένας πελάτης ταιριάζει ξεκάθαρα. Αλλιώς ο agent σας ζητά να επιλέξετε από πρόσφατους συνδυασμούς πελάτη και έργου.
- Ό,τι ονομάζετε εσείς. Ονομαστικός πελάτης ή έργο υπερισχύει όλων. Αν δύο πελάτες έχουν ίδιο όνομα, π.χ. μόνο με διαφορά κεφαλαίων, υπερισχύει η ακριβής ορθογραφία, μετά ο πελάτης που έχετε καταγράψει αυτό το repository, μετά ο πελάτης που καταγράφετε πιο συχνά. Ο agent ρωτά μόνο αν κανένα από αυτά δεν αρκεί.
- Η μνήμη του repository σας. Το Half5 θυμάται για κάθε χρήστη ποιο repository ανήκει σε ποιον πελάτη, με βάση καταχωρήσεις που επιβεβαιώσατε ή μετακινήσατε.
- Το όνομα του repository. Συγκρίνεται με τα (διακριτικά) ονόματα, labels και e-mail domains των πελατών σας, καθώς και με ονόματα έργων.
- Το προσωπικό σας ιστορικό. Προηγούμενες περιγραφές που αναφέρουν το repository, branch ή αριθμό ticket, και πελάτες που καταγράφετε πρόσφατα και συχνά.
- Η περιγραφή, το branch και τα commits. Ως επιπλέον ένδειξη, όχι ως απόφαση.
Πώς λειτουργεί η μνήμη repository;
Η μνήμη ανήκει σε εσάς. Όταν καταγράφετε μέσω agent, μετακινείτε τέτοια καταχώρηση σε άλλον πελάτη ή καταγράφετε εργασία agent στην desktop εφαρμογή, το Half5 θυμάται ποιο repository ανήκει σε ποιον πελάτη. Την επόμενη φορά ο agent δεν χρειάζεται να ρωτήσει.
Αν η περιγραφή ονοματίζει ξεκάθαρα άλλον πελάτη από τη μνήμη σας, το Half5 δεν καταγράφει αυτόματα: ο agent ρωτά ποιος από τους δύο είναι. Με τη ρύθμιση οργανισμού «Μάθηση από συναδέλφους», το Half5 μπορεί να προτείνει πελάτη που έχει καταγράψει συνάδελφος στο ίδιο repository. Αυτό παραμένει πρόταση· ο agent πάντα ρωτά πρώτα και η δική σας μνήμη προηγείται.
Ποια άλλα εργαλεία υπάρχουν εκτός από το log_work;
Ο server προσφέρει έξι εργαλεία. Όλα λειτουργούν μόνο για τις δικές σας ώρες, με τους πελάτες, έργα και δραστηριότητες που βλέπετε στην οργάνωσή σας.
| Εργαλείο | Τι κάνει | Περιορισμοί |
|---|---|---|
log_work | Καταγραφή εργασίας | Οι νέες καταχωρήσεις εμφανίζονται ως μη εγκεκριμένες |
log_work_batch | Έως 25 καταχωρήσεις σε μία κλήση, π.χ. ολόκληρη εβδομάδα εκ των υστέρων | Κάθε καταχώρηση ελέγχεται και ρωτά όπως το log_work· μία απάντηση σε κοινή ερώτηση πελάτη ισχύει για όλες τις σχετικές καταχωρήσεις |
search_customers_projects | Αναζήτηση πελατών, έργων και δραστηριοτήτων με όνομα, διακριτικό τίτλο, label ή e-mail domain | Μόνο για ανάγνωση· δεν απαιτείται πριν το log_work |
list_entries | Λίστα δικών σας καταχωρήσεων με ημερήσια σύνολα | Μόνο για ανάγνωση· έως 31 ημέρες κάθε φορά |
update_entry | Αλλαγή μίας δικής σας καταχώρησης | Μόνο μη εγκεκριμένες καταχωρήσεις, και μόνο κατόπιν αιτήματός σας |
delete_entry | Διαγραφή μίας δικής σας καταχώρησης | Μόνο μη εγκεκριμένες καταχωρήσεις, μετά από επιβεβαίωση |
Μόλις εγκριθεί μια καταχώρηση, ο agent δεν μπορεί να την αλλάξει. Αυτό γίνεται μόνο μέσα στο Half5.
Έτσι λειτουργεί το Half5
Στις Ρυθμίσεις → «Συνδεδεμένοι agents» βλέπετε το όνομα πελάτη κάθε σύνδεσης, αν είναι επαληθευμένη, πότε χρησιμοποιήθηκε τελευταία και τι δικαιώματα έχει (προβολή ωρών, καταγραφή ωρών). Με «Αποσύνδεση» αφαιρείτε την πρόσβαση.
Στην ίδια σελίδα εμφανίζεται και η μνήμη repository σας. Μπορείτε να διαγράψετε έναν σύνδεσμο με «Ξέχνα …» ή να ξεκινήσετε από την αρχή με «Ξέχνα όλα». Τι συμβαίνει με αυτά τα δεδομένα εξηγείται στο Απόρρητο με AI agents. Για έργα R&D υπό το ολλανδικό WBSO, το Half5 δεν έχει ειδική εξαγωγή WBSO· οδηγίες ρύθμισης θα βρείτε στο Ώρες WBSO με λογισμικό.
Συχνές ερωτήσεις
Χρειάζεται ο agent να καλέσει το search_customers_projects πριν την καταγραφή;
Όχι. Το log_work βρίσκει μόνο του πελάτη και έργο. Το εργαλείο αναζήτησης προορίζεται για ερωτήσεις όπως «ποια έργα έχει αυτός ο πελάτης;» ή για ασαφή ονόματα.
Τι συμβαίνει αν ο agent στείλει την ίδια καταχώρηση δύο φορές;
Το Half5 αναγνωρίζει την ίδια καταχώρηση και επιστρέφει duplicate αντί να δημιουργήσει δεύτερη εγγραφή. Ο agent δεν πρέπει να την καταγράψει ξανά.
Στέλνει ο agent τον κώδικά μου ή ονόματα αρχείων;
Δεν πρέπει. Ο server δίνει σαφείς οδηγίες στους agents να μην στέλνουν διαδρομές αρχείων ή κώδικα· η περιγραφή είναι μία γραμμή που μπορεί να διαβάσει ο πελάτης και το repository στέλνεται μόνο ως όνομα.
Μπορεί η μνήμη συναδέλφου να καθορίσει σε ποιον πελάτη θα πάνε οι ώρες μου;
Όχι. Η μνήμη συναδέλφου δίνει μόνο πρόταση, και μόνο όταν είναι ενεργό το «Μάθηση από συναδέλφους». Ο agent τότε σας ρωτά πρώτα.
Μπορεί ο agent να αλλάξει εγκεκριμένες ώρες;
Όχι. Τα update_entry και delete_entry λειτουργούν μόνο σε δικές σας μη εγκεκριμένες καταχωρήσεις. Οι εγκεκριμένες ώρες αλλάζουν μόνο μέσα στο Half5.
