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 /ru/docs/modules/task-recovery.md (or send Accept: text/markdown).

API задач и восстановление

Восстанавливайте неопределённую отправку без создания новой задачи.

Задать вопрос об этом руководстве

Прежде чем начать

Откройте загруженный проект supastack в Visual Studio Code, используя «Файл» → «Открыть папку», затем выберите «Терминал» → «Новый терминал». Корень репозитория — это папка, содержащая package.json, приложения и пакеты. Запустите команду ниже и оставьте терминал открытым. Если команда не распознается, завершите руководство по установке инструмента, прежде чем продолжить.

Сначала прочтите руководство по платформе. Сервер — это процесс приложения, который отвечает на запросы браузера или телефона. Веб читает apps/web/.env.local, Expo читает apps/mobile/.env.local, а команды миграции базы данных читают корневой .env. Демонстрация без базы данных / панели мониторинга отделена от реальных учетных записей / аутентификации, для которых необходимо перенести Postgres. Для оформления заказа только на телефоне или компьютере требуется отдельно работающий веб-сервер.

corepack pnpm --filter @supastack/web dev

Настройка и конфигурация

POST /api/ai/tasks требует аутентифицированный воркспейс и активное право доступа. Запрос с ключом резервирует неизменную задачу до отправки. Idempotency-Key принимает 16–128 ASCII-букв, цифр, подчёркиваний или дефисов.

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

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

Рабочий процесс внедрения

Сохраните ключ восстановления до отправки. После неопределённой отправки переиспользуйте тот же ключ и тело resume; сервер загружает исходный ввод и повторяет с той же идентичностью Trigger в области задачи. Изменённый ввод под тем же ключом возвращает 409 idempotencyConflict.

HTTP 202 после неоднозначной отправки означает, что отправка неопределённа. Это не доказывает, что Trigger принял работу. Уже выполняющиеся или завершённые задачи возвращают сохранённое состояние без повторной отправки. Восстановление всё равно требует аутентификации, владения и права доступа.

Проверка и устранение неполадок

Отработайте потерянный ответ, конфликт изменённого ввода, запрос чужого воркспейса и восстановление после обновления. Нет автоматического диспетчера исходящих или сквозной гарантии exactly-once. Не сбрасывайте выполняющуюся задачу в очередь без исследования её побочных эффектов.