Was macht log_work?
Ein Agent muss vor dem Buchen keine IDs nachschlagen. Er ruft log_work direkt mit einer Beschreibung und allem, was er sonst weiß, auf. Half5 ordnet Kunde, Projekt und Tätigkeit zu oder stellt eine Frage, wenn es nicht sicher ist.
Die Buchung kommt als ‚Noch nicht freigegeben‘ auf deinen Namen an. So bleibt die Kontrolle bei dir oder der freigebenden Person, auch wenn der Agent die Arbeit eingetragen hat. Wie du einen Agenten verbindest, steht in Stunden erfassen mit Claude, ChatGPT oder Cursor.
Welche Felder schickt der Agent mit?
Nur die Beschreibung ist Pflicht. Der Rest hilft Half5, den richtigen Kunden und die Dauer zu wählen. Fehlt ein Feld, füllt Half5 es nicht auf gut Glück aus.
| Feld | Pflicht | Was es ist |
|---|---|---|
description | Ja | Eine Zeile mit 3 bis 500 Zeichen, die ein Kunde lesen darf, in deiner Sprache, ohne Datei- oder Klassennamen. Kann auf einer Rechnung landen. |
date | Nein | today, yesterday oder ein Datum (JJJJ-MM-TT). Ohne Angabe gilt heute. |
minutes | Nein | Dauer in Minuten, 1 bis 1.440. Weglassen, wenn die Dauer nicht bekannt ist. |
start_time, end_time | Nein | Beginn und Ende als HH:MM. |
customer, project, activity | Nein | Name, Handelsname oder Referenz. Ein Projekt legt auch den Kunden fest. |
repository | Nein | Git-Remote, Besitzer/Repo oder der Ordnername. Nie ein vollständiger lokaler Pfad. |
branch, commit_subjects | Nein | Der Branch und bis zu 10 Commit-Betreffzeilen als zusätzliche Hinweise für Kunde und Projekt. |
session_id | Nein | Die Sitzungs-ID des Agenten, nur wenn er sie wirklich kennt. |
Welche Ergebnisse gibt es?
Jeder Aufruf endet mit einem von vier Status. Jeder verlangt vom Agenten etwas anderes.
| Ergebnis | Was es bedeutet | Was der Agent tut |
|---|---|---|
created | Die Buchung ist gespeichert, als noch nicht freigegeben. | Sagt dir in einem Satz, was gebucht wurde und warum auf diesen Kunden. |
preview | Ein Probelauf: Das würde gebucht. Gespeichert ist nichts. | Zeigt dir den Vorschlag. |
needs_confirmation | Half5 ist unsicher, etwa beim Kunden, oder die Dauer fehlt (Frage nach der Dauer mit einem Vorschlag). | Stellt dir die Frage und bucht erst nach deiner Wahl, mit genau der gewählten Option. |
duplicate | Dieselbe Arbeit ist schon gebucht. | Bucht nicht noch einmal. |
Ohne Dauer speichert Half5 nichts. Der Vorschlag reicht zum Beispiel vom Ende deiner letzten Buchung heute bis jetzt; du bestätigst oder passt ihn an.
Wie wählt Half5 Kunde und Projekt?
Erst den Kunden, dann das Projekt innerhalb dieses Kunden. Half5 gewichtet die vorhandenen Hinweise und bucht nur direkt, wenn ein Kunde klar am besten passt. Sonst bittet dich der Agent, aus deinen letzten Kombinationen von Kunde und Projekt zu wählen.
- Was du selbst nennst. Ein genannter Kunde oder ein Projekt geht vor.
- Dein Repository-Speicher. Half5 merkt sich pro Person, welches Repository zu welchem Kunden gehört, gelernt aus Buchungen, die du bestätigt oder verschoben hast.
- Der Name des Repositorys. Verglichen mit (Handels-)Namen, Labels und E-Mail-Domains deiner Kunden sowie mit Projektnamen.
- Deine eigene Historie. Frühere Beschreibungen, in denen Repository, Branch oder eine Ticketnummer vorkommen, und Kunden, auf die du kürzlich und oft buchst.
- Beschreibung, Branch und Commits. Als zusätzlicher Hinweis, nicht als Entscheidung.
Wie funktioniert der Repository-Speicher?
Der Speicher gehört dir. Buchst du über einen Agenten, verschiebst du eine solche Buchung auf einen anderen Kunden oder erfasst du Agentenarbeit in der Desktop-App, merkt sich Half5, welches Repository zu welchem Kunden gehört. Beim nächsten Mal muss der Agent nicht fragen.
Nennt die Beschreibung klar einen anderen Kunden als dein Speicher, bucht Half5 nicht blind: Der Agent fragt, welcher von beiden es ist. Mit der Organisationseinstellung ‚Von Kolleg:innen lernen‘ kann Half5 auch einen Kunden vorschlagen, auf den eine Kollegin oder ein Kollege dasselbe Repository gebucht hat. Das bleibt ein Vorschlag; der Agent fragt immer erst nach, und dein eigener Speicher hat Vorrang.
Welche Tools gibt es neben log_work?
Der Server bietet fünf Tools. Alle wirken nur auf deine eigenen Stunden, mit den Kunden, Projekten und Tätigkeiten, die du in deiner Organisation sehen darfst.
| Tool | Was es tut | Grenzen |
|---|---|---|
log_work | Arbeit buchen | Neue Buchungen kommen als noch nicht freigegeben an |
search_customers_projects | Kunden, Projekte und Tätigkeiten nach Name, Handelsname, Label oder E-Mail-Domain suchen | Nur lesen; vor log_work nicht nötig |
list_entries | Deine eigenen Buchungen mit Tagessummen abrufen | Nur lesen; bis zu 31 Tage auf einmal |
update_entry | Eine eigene Buchung ändern | Nur noch nicht freigegebene Buchungen und nur auf deinen Wunsch |
delete_entry | Eine eigene Buchung löschen | Nur noch nicht freigegebene Buchungen, nach Bestätigung |
Ist eine Buchung freigegeben, kann der Agent sie nicht mehr ändern. Das machst du in Half5 selbst.
So macht es Half5
Unter Einstellungen → ‚Verbundene Agents‘ siehst du pro Verbindung den Namen des Clients, ob er verifiziert ist, wann er zuletzt genutzt wurde und was er darf (Stunden anzeigen, Stunden erfassen). Mit ‚Trennen‘ entziehst du den Zugriff.
Auf derselben Seite steht dein ‚Repository-Speicher‘. Einzelne Zuordnungen löschst du mit ‚… vergessen‘, mit ‚Alles vergessen‘ fängst du neu an. Was mit diesen Daten passiert, steht in Datenschutz bei KI-Agenten.
Häufige Fragen
Muss der Agent vor dem Buchen search_customers_projects aufrufen?
Nein. log_work findet Kunde und Projekt selbst. Das Suchtool ist für Fragen wie ‚welche Projekte hat dieser Kunde?‘ gedacht oder für mehrdeutige Namen.
Was passiert, wenn der Agent dieselbe Buchung zweimal schickt?
Half5 erkennt die gleiche Buchung und antwortet mit duplicate statt eine zweite Erfassung anzulegen. Der Agent soll dann nicht erneut buchen.
Schickt der Agent meinen Code oder Dateinamen mit?
Das soll er nicht. Der Server weist Agenten ausdrücklich an, nie Dateipfade oder Code zu senden; die Beschreibung ist eine Zeile, die ein Kunde lesen darf, und das Repository geht nur als Name mit.
Kann der Speicher einer Kollegin bestimmen, auf welchen Kunden meine Stunden gehen?
Nein. Der Speicher von Kolleginnen und Kollegen liefert höchstens einen Vorschlag, und nur wenn ‚Von Kolleg:innen lernen‘ eingeschaltet ist. Der Agent fragt dann zuerst dich.
Kann der Agent freigegebene Stunden noch ändern?
Nein. update_entry und delete_entry wirken nur auf deine eigenen, noch nicht freigegebenen Buchungen. Freigegebene Stunden änderst du in Half5.
