Entscheidungen

Wo du die Fragen von kanman beantwortest, und wie deine Werkzeuge sie über die REST-API auflisten, lesen und beantworten.

Entscheidungen sind die Fragen, die kanman einem Menschen stellt: was du beabsichtigst, eine Wahl, die nur du treffen kannst, oder ein Zugang, den kanman nicht hat. Jede kommt mit den Optionen, die kanman sieht, und du kannst auch in eigenen Worten antworten. Das Konzept beschreibt Fragen von kanman. Du beantwortest sie in der App, in Slack oder über die REST-API.

Eine Entscheidung beantworten

Wo Wie
App Entscheidungen (/<workspace>/decisions), Reiter Offen, Stories und Entschieden, oder die Entscheidungsseite /<workspace>/decisions/<entscheidungsschlüssel>. Wähle eine Option oder antworte in eigenen Worten.
Slack Die Buttons unter der Entscheidungsnachricht im Kanal des Teams, oder eine Antwort an kanman im Thread. Siehe Entscheidungen in Slack beantworten.
Aufnahme Eine Antwort in der Aufnahme des Teams, die die Entscheidung nennt, zum Beispiel „dec-4h2k: das Sandbox-Konto verwenden“.
REST-API POST /v1/decisions/<decision-key>/resolve mit einem Token mit der Berechtigung write. Siehe unten.

Die erste Antwort gilt. Wer als Zweites antwortet, erfährt, dass die Entscheidung schon getroffen ist. Jede Antwort schreibt einen Audit-Eintrag decision_resolved mit Person und Kanal; die Entscheidung zeigt, ob sie über die App, Slack, den MCP-Server oder die API getroffen wurde.

REST-API

Entscheidungen auflisten

GET /v1/decisions liefert die Entscheidungen des Workspaces, die neuesten zuerst, seitenweise. Filtere mit status (pending, resolved, expired, cancelled, superseded), team (Team-Slug) und run (Run-Schlüssel).

curl "https://api.kanman.ai/functions/v1/api-gateway/v1/decisions?status=pending" --header "Authorization: Bearer $KANMAN_API_KEY"
Feld Beschreibung
key, title, body Die Entscheidung; body enthält kanmans Begründung als Markdown.
status, recommendation Der Zustand und die ID der Option, die kanman empfiehlt.
options id, label, action und recommended pro Option.
team, story, runKey Wozu die Entscheidung gehört.
resolution, resolvedVia, resolvedAt Die Antwort (optionId, note) und ihr Kanal, sobald beantwortet.
expiresAt, createdAt Zeitstempel.

GET /v1/decisions/{decision-key} liefert eine Entscheidung in derselben Form.

Eine Entscheidung über die API beantworten

POST /v1/decisions/{decision-key}/resolve braucht ein Token mit der Berechtigung write. Die Antwort wird mit der Person, der das Token gehört, als Antwortender und api als Kanal festgehalten und wirkt genauso wie eine Antwort in der App.

curl -X POST https://api.kanman.ai/functions/v1/api-gateway/v1/decisions/dec-4h2k/resolve \
  --header "Authorization: Bearer $KANMAN_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"optionId": "opt-1", "note": "Use the sandbox account"}'
Feld im Body Beschreibung
optionId Pflicht. Die id einer der Optionen der Entscheidung.
note Optional, bis zu 50.000 Zeichen (ein längerer Hinweis wird abgelehnt, nicht gekürzt). Wird wie eine Notiz in der App weitergegeben.

Die Antwort ist die aktualisierte Entscheidung plus effects, die Schritte, die kanman ausgeführt hat. 400 bedeutet, dass es die Option nicht gibt, 404, dass die Entscheidung nicht im Workspace des Tokens liegt, 409, dass sie schon beantwortet ist (die erste Antwort gilt).

Zuletzt aktualisiert: January 1, 0001

kanman öffnen