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