Runs
Wo du Runs mit ihren Versuchen verfolgst, wie du einen Run stoppst oder wiederholst, und wie deine Werkzeuge Runs über die REST-API lesen.
Ein Run ist ein Helfer von kanman bei der Arbeit an einer Story. Alle Versuche eines Runs teilen sich einen Run-Schlüssel wie run-7f3k. Das Konzept beschreibt Runs, die Prüfungen vor einem Merge So prüft kanman seine Arbeit. Runs verfolgst und steuerst du in der App.
Deine Werkzeuge lesen Runs über die REST-API. Stoppen und Wiederholen bleiben in der App und in der Aufnahme.
Runs auflisten
Öffne dein Team und den Reiter Runs (/<workspace>/teams/<team>/runs). Jeder Run zeigt seine Story, den Run-Schlüssel, die Zahl der Versuche, die Kosten und den Status.
Einen Run lesen
Die Run-Seite (/<workspace>/teams/<team>/runs/<run-schlüssel>) zeigt, was der Run gerade tut, seine Schritte mit ihren Prüfungen und Dauern, die Fortschrittsmeldungen unter Fortschritt, die Versuche, die Kosten im Verhältnis zum Run-Budget und Links zum Pull Request und zu einer offenen Frage. Ihre Reiter haben eigene Adressen: /steps, /evidence, /agent-log und /details nach dem Run-Schlüssel, siehe Die Run-Seite.
Einen Run stoppen
Klicke auf der Run-Seite auf Stoppen und bestätige mit Run stoppen. kanman beendet den aktuellen Versuch; die Story bleibt, wo sie ist, und du kannst den Run später erneut starten. Du kannst kanman auch in der Aufnahme des Teams darum bitten, zum Beispiel „brich run-7f3k ab“. Das Stoppen steht im Audit-Log als run_state_changed.
Einen Run wiederholen
Einen Run, der fehlgeschlagen ist, in eine Zeitüberschreitung lief oder gestoppt wurde, startest du auf der Run-Seite mit Erneut versuchen neu. kanman reiht einen neuen Versuch unter demselben Run-Schlüssel ein; er nutzt die Richtlinie des Teams, wie sie jetzt ist, ein inzwischen erhöhtes Modell oder Schrittbudget gilt also schon. Sind dem letzten Versuch die Schritte ausgegangen, heißt die Schaltfläche Mit mehr Schritten erneut versuchen, und der neue Versuch bekommt die nächsthöhere Klasse mit mindestens doppelt so vielen Schritten, im Rahmen deiner Richtlinie (siehe Wenn etwas fehlschlägt). Das Wiederholen steht im Audit-Log als run_state_changed, Modell und Schritte des neuen Versuchs als policy_decision.
REST-API
Runs auflisten
GET /v1/runs liefert die Runs des Workspaces, die neuesten zuerst, seitenweise. Filtere mit team (Team-Slug) und story (Story-Schlüssel).
curl "https://api.kanman.ai/functions/v1/api-gateway/v1/runs?team=sandbox-team" --header "Authorization: Bearer $KANMAN_API_KEY"
| Feld | Beschreibung |
|---|---|
key, team, story |
Der Run-Schlüssel, der Team-Slug und die Story (key, title). |
status, stage |
Status und Phase des letzten Versuchs, zum Beispiel running und verifying. |
executor, attempts |
Das Coding-Werkzeug und die Zahl der Versuche. |
costCents, budgetCents |
Kosten aller Versuche und das Run-Budget, in Euro-Cent. |
failureClass |
Warum der Run gestoppt hat: transient, persistent, policy, budget oder dependency, sonst null. |
pullRequest |
url und number, oder null. |
startedAt, completedAt, createdAt |
Zeitstempel. |
Einen Run lesen
GET /v1/runs/{run-key} liefert einen Run mit attemptList (pro Versuch: attempt, status, stage, executor, costCents, failureClass, error, startedAt, completedAt) und den decisions des Runs (key, status).
Zuletzt aktualisiert: January 1, 0001
kanman öffnen