
TL;DR
|
An einem Dienstagmorgen wird
eine Warnmeldung ausgelöst. Bei den Exporten für eine Handvoll Kunden kommt es zu Zeitüberschreitungen, und zwar ausschließlich bei Konten, die vor 2023 angelegt wurden. Du führst das auf eine Änderung an einer Abfrage zurück, die vor Monaten veröffentlicht wurde.
git blame verweist auf einen Merge-Commit aus einem Branch namens company/issue-418. Der Pull-Request wurde von einem Mitarbeiter eröffnet und von jemandem genehmigt, der inzwischen das Team gewechselt hat. Die Commit-Meldung lautet: „Exportabfrage für große Konten optimieren.“
Das ist ein Anfang. Was du wissen musst, ist, warum der Agent den Index-Hinweis weggelassen hat, ob er über das alte Kontoschema Bescheid wusste und ob damals jemand auf das Risiko hingewiesen hat. Diese Antworten lagen in der Ausführung des Agenten, und ob du sie noch abrufen kannst, hängt davon ab, ob irgendetwas davon aufgezeichnet wurde.
Das Wichtigste auf einen Blick: Git zeichnet das Ergebnis einer Änderung auf. Bei der Arbeit mit Agenten liegt der Kontext, der das Ergebnis erklärt, in der Ausführungssitzung, und er verschwindet, sofern er nicht irgendwo gespeichert wird.
Bei von Menschen geschriebenem Programmieren kommst du mit dem Git-Verlauf und ein bisschen Herumfragen normalerweise hinter den Grund für eine Änderung. Die Commit-Meldung gibt dir einen Hinweis, die PR-Diskussion füllt einige Lücken, und der Autor kann sich meist an den Rest erinnern.
Bei der Arbeit mit Agenten wird diese Kette an drei Stellen unterbrochen.
Man kann das teilweise durch Disziplin ausgleichen, indem man Pläne in PR-Beschreibungen einfügt oder sie in ein Docs-Verzeichnis legt. Das funktioniert, bis die queue lang wird. Eine Aufzeichnung, die automatisch während der Ausführung erfasst wird, ist zuverlässiger als eine, die davon abhängt, dass sich jemand daran erinnert.
Das Wichtigste auf einen Blick: Jede Eingabeaufforderung, jeder Diff, jede Freigabe und jedes Nutzungsereignis wird dem Lauf zugeordnet, der es erzeugt hat, und jedes Detail beantwortet eine bestimmte Frage, die du später haben wirst.
Upsun Dispatch ist die Plattform für geregelte Zusammenarbeit zwischen KI-Agenten und funktionsübergreifenden menschlichen Teams. Jede Workflow-Ausführung wird in der Upsun Dispatch-Konsole zu einem Lauf, und der Datensatz wird während des Laufs erfasst, anstatt erst im Nachhinein zusammengestellt zu werden. Hier erfährst du, was er enthält und wo du die einzelnen Teile findest.
| Was wird protokolliert? | Wo du es findest | Die Frage, die es beantwortet |
|---|---|---|
| Eingabeaufforderungen und Tool-Aufrufe | Laufdetails im Aktivitäts-Feed | Was wurde dem Agenten mitgeteilt und was hat er sich angesehen? |
| Der Plan: Zusammenfassung, vollständiger Plan, betroffene Dateien, Komplexität, Annahmen und Risiken | Veröffentlicht im ursprünglichen Problem oder Ticket | Was hatte der Bearbeiter vor und wovon ist er ausgegangen? |
| Planfreigaben und -überarbeitungen (Jira läuft mit aktiviertem Planfreigabe-Gate) | Ausführungsdetails | Wer hat den Ansatz abgenommen, und was hat sich vor dem Programmieren geändert? |
| Diffs, Artefakte, eröffnete PRs und Push-Ergebnisse | Laufdetails und der PR selbst | Was genau hat sich geändert und wo wurde es umgesetzt? |
| Ergebnisse der Überprüfung | Die PR-Beschreibung und die Ausführungsdetails | Welche Probleme wurden bereits vor der Überprüfung gemeldet? |
| Schritte, Versuche und Ereignisse in der Zeitleiste | Laufdetails | Was ist in welcher Reihenfolge passiert, und wo gab es einen erneuten Versuch oder einen Fehler? |
| Protokolle | Kurze Auszüge in den Ausführungsdetails, vollständige Protokolle pro Auftrag | Was wurde bei jedem Schritt ausgegeben? |
| Nutzung | Ausführungsdetails sowie Verbrauchsberichte nach Modell oder Workflow | Was hat der Lauf verbraucht? |
| Der aktuelle Status des zugehörigen PRs: Titel, Lebenszyklus, Überprüfungsentscheidung, Head-Commit | Die zugehörige Entitätsansicht | Was ist nach dem Lauf mit der Änderung passiert? |
Der Datensatz ist schreibgeschützt: Einträge können bei normaler Nutzung weder bearbeitet noch gelöscht werden. Das erneute Ausführen eines abgeschlossenen Laufs startet einen neuen Vorgang und lässt den ursprünglichen Lauf unverändert.
Das Wichtigste: Fang beim Programmieren an, folge den Links zurück zum Issue und öffne dann den Lauf. Jeder Schritt beantwortet einen anderen Teil der Frage „Warum?“.
Zurück zu den Exporten mit Zeitüberschreitung. So gehst du vom zusammengeführten Commit bis zur Begründung des Agenten vor.
Am Ende weißt du, was vom Agenten verlangt wurde, wovon er ausgegangen ist, was er sich angesehen hat, was markiert wurde und wer die Freigabe erteilt hat. Das reicht normalerweise aus, um eine falsche Annahme von einer schlechten Überprüfung zu unterscheiden und das Richtige zu korrigieren.
Das Wichtigste auf einen Blick: Der Protokollauszug zeigt, was einem Agenten übergeben wurde, was er geplant hat, was er getan hat und wer es genehmigt hat. Er kann dir nicht sagen, ob die Änderung richtig war, und er deckt nur Arbeiten ab, die über Upsun Dispatch abgewickelt wurden.
Die Aufzeichnung macht sich in einigen wiederkehrenden Situationen bezahlt: beim Debuggen einer Änderung lange nach dem Merge, beim Verfassen eines Postmortems, beim Überprüfen eines PRs mit Kontext statt nur einem bloßen Diff und beim Erklären an einen Teamkollegen, warum das Programm so aussieht, wie es aussieht.
Es gibt aber auch Einschränkungen, die du kennen solltest, bevor du dich darauf verlässt.
Der schnellste Weg, um zu verstehen, was ein Lauf erfasst, ist, dir einen aus deinem eigenen Repository anzusehen. Verbinde GitHub oder GitLab, speichere einen Modellschlüssel und löse eine Code-Review für einen Pull-Request aus. Jede neue Organisation startet mit einem kostenlosen Tarif, für den keine Kreditkarte erforderlich ist.
CTA: Führe deinen ersten Workflow aus
Was ist ein Audit-Trail eines KI-Agenten?
Eine Aufzeichnung darüber, was von einem Agenten angefordert wurde, welchen Kontext er verwendet hat, was er geplant und ausgeführt hat und wer seine Arbeit genehmigt hat. Damit kann ein Team eine vom Agenten vorgenommene Änderung im Nachhinein bis zu ihrer Absicht zurückverfolgen.
Was protokolliert Upsun Dispatch bei jedem Durchlauf?
Jede Eingabeaufforderung, jeden Diff, jede Genehmigung und jedes Nutzungsereignis wird in Echtzeit erfasst. Die Durchlaufdetails in der Konsole zeigen außerdem Schritte, Zeitachsenereignisse, Tool-Aufrufe, Ergebnisse, Artefakte, Protokolle und den zugehörigen PR an.
Wo kann ich den Plan eines Agenten einsehen?
Bei Issue-to-Programmieren-Läufen veröffentlicht Upsun Dispatch vor dem Programmieren einen strukturierten Plan im ursprünglichen Issue oder Ticket. Dieser enthält eine Zusammenfassung, den vollständigen Plan, betroffene Dateien, Komplexität, Annahmen und Risiken.
Kann der Datensatz nachträglich bearbeitet werden?
Das Protokoll ist nur für neue Einträge zugänglich, daher können Einträge bei normaler Nutzung weder bearbeitet noch gelöscht werden. Das erneute Ausführen eines abgeschlossenen Durchlaufs erstellt einen neuen Durchlauf und lässt den ursprünglichen unverändert.
Zeigt der Datensatz auch die Arbeit von Agenten an, die außerhalb von Upsun Dispatch erledigt wurde?
Nein. Er umfasst nur Durchläufe, die über die Workflows von Upsun Dispatch laufen. Agentensitzungen auf dem Rechner eines Entwicklers oder in anderen Tools sind nicht enthalten.