For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /nl/docs/modules/task-recovery.md (or send Accept: text/markdown).

Taak-API en recovery

Herstel een onzekere submission zonder een nieuwe taak te creëren.

Vraag over deze handleiding

Voordat je begint

Open uw gedownloade supastack-project in Visual Studio Code met behulp van Bestand → Map openen en kies vervolgens Terminal → Nieuwe terminal. De root van de repository is de map met package.json, apps en pakketten. Voer daar de onderstaande opdracht uit en laat de terminal open. Als een opdracht niet wordt herkend, voltooi dan de installatiehandleiding van het hulpprogramma voordat u verdergaat.

Lees eerst de platformtutorial. Een server is het app-proces dat browser- of telefoonverzoeken beantwoordt. Web leest apps/web/.env.local, Expo leest apps/mobile/.env.local en opdrachten voor databasemigratie lezen root .env. De demonstratie zonder database/dashboard staat los van echte/auth-accounts, waarvoor Postgres moet worden gemigreerd. Voor een telefoon- of desktop-afrekening is een afzonderlijk draaiende web-backend nodig.

corepack pnpm --filter @supastack/web dev

Setup en configuratie

POST /api/ai/tasks vereist een geauthenticeerde workspace en actieve entitlement. Een keyed request reserveert een immutable taak vóór dispatch. Idempotency-Key accepteert 16–128 ASCII-letters, cijfers, underscores of hyphens.

POST /api/ai/tasks
Idempotency-Key: a-stable-client-submission-key

Recovery body: { "resume": true }
Status: GET /api/ai/tasks/{taskId}

Implementatieworkflow

Persisteer de recoverykey vóór submitten. Hergebruik na onzekere dispatch dezelfde key en de resume-body; de server laadt de originele input en probeert opnieuw met dezelfde taak-scoped Trigger-identiteit. Gewijzigde input onder dezelfde key retourneert 409 idempotencyConflict.

HTTP 202 na een ambigue enqueue betekent dat dispatch onzeker is. Het bewijst niet dat Trigger het werk accepteerde. Reeds draaiende of terminale taken retourneren opgeslagen state zonder nog een enqueue. Recovery vereist nog steeds authenticatie, eigenaarschap en entitlement.

Verificatie en probleemoplossing

Oefen een verloren response, gewijzigde-input-conflict, vreemde-workspace-request en herstel na refresh. Er is geen automatische outbox-dispatcher of end-to-end exactly-once-garantie. Reset een draaiende taak niet naar queued zonder de side effects te onderzoeken.