# Сценарии, история и проверка результата

Сценарий помогает повторять одну задачу с понятными требованиями. Он должен упрощать запрос, сохраняя связь с исходным проектом, файлами и разрешениями.

## Сформулируйте задачу

Запишите назначение результата, обязательные исходники и критерии проверки. Например: сравнить два договора и сформировать таблицу отличий только по приложенным документам.

Сначала проверьте сценарий на обычном запросе в Studio. Не выдавайте сохранённую настройку за уже выполненную работу.

## Настройте сценарий своего проекта

Откройте «Проекты», выберите нужный проект и раздел сценариев. Параметры сценария относятся к этому проекту; не переносите чужие материалы и права доступа.

В кабинете используются GET и POST /api/v1/client/projects/{project_id}/use-cases, а для конкретной записи — PUT и DELETE по тому же пути с идентификатором записи. Эти операции требуют действующего входа и прав. Структуру создаваемой записи сверяйте с текущим интерфейсом и контрактом API; пример другой задачи не является универсальной схемой.

Подключение по ключу читает доступные сценарии через GET /api/v1/waygpt/use-cases. Секрет проекта остаётся на сервере своего приложения.

## Проверьте исходники и вывод

Дождитесь загрузки вложений. При ошибке оставьте файл в списке с понятным состоянием, предложите повтор или явное исключение. Не отправляйте запрос с незаметно потерянными материалами.

Укажите формат ответа обычными словами. Если сценарию нужна строгая структура, проверьте успешный и ошибочный ответ отдельно: техническая ошибка не должна попасть в поле готового результата.

## Ведите историю безопасно

Сохранённые диалоги кабинета доступны через /api/v1/client/chat/history в разрешённом контексте. При смене рабочего пространства предыдущая история не должна появляться в новом проекте.

store: false в текстовом API не обещает восстановление несохранённого текста. Закрытие вкладки не подтверждает отмену. При разрыве связи проверьте известный статус или историю до нового платного выполнения.

## Проверяйте фоновые задачи

Если получен job_id, читайте /api/v1/waygpt/media/jobs/{job_id} с исходным подключением. Не создавайте новую генерацию при каждом чтении статуса и не обозначайте ожидание расчёта как готовый файл.

Команда отмены имеет отдельный ответ. Нажатие кнопки и закрытие потока не доказывают автоматический возврат средств.

## Что оставлять в журнале

Для поддержки нужны время действия, понятный тип операции и известный статус. Секреты, cookie, временные ссылки и содержание личных файлов не должны попадать в публичные журналы.

Пользователю показывайте безопасное сообщение и следующий шаг. Исходные технические тела ошибок и внутренние сведения подключения в клиентском интерфейсе не нужны.

Продолжение: /docs/integration, /docs/api и /docs/files.