> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# AI-функции

Чат, задачи, политика моделей и bring-your-own-key.

## Попробуйте поддельный искусственный интеллект, а затем выберите настоящего провайдера

Для получения первого результата выполните задачу /dashboard веб-учебника: запустите локальный поток, поставьте приглашение в очередь, запустите его и просмотрите результат. AI_PROVIDER=fake возвращает повторяемый демонстрационный ответ без отправки данных во внешнюю модель или использования платного ключа API.

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

Фоновому AI task также требуется настроенная служба заданий. Если выбор модели не отображается, проверьте каталог и политику псевдонимов, прежде чем повторять попытку. Если в доступе отказано, проверьте права активной рабочей области. Храните все ключи поставщика API в конфигурации веб-сервера, а не в окне браузера, мобильного приложения или рабочего стола.

[Попробуйте демонстрацию ИИ без учетных данных](https://supastack.dev/ru/docs/web/ship-in-5-minutes.md)

[Настроить генерацию реального ИИ](https://supastack.dev/ru/docs/modules/ai-configuration.md)

[Добавить разрешенные модели и цены](https://supastack.dev/ru/docs/web/setup-ai.md)

[Настроить выполнение фоновой задачи](https://supastack.dev/ru/docs/modules/jobs.md)


## Следите за жизненным циклом задачи

Продакшен-API задач валидирует аутентифицированный воркспейс и право доступа до сохранения задачи и отправки workflow ai.generate в Trigger.dev. Маршрутизатор применяет требования возможностей и настроенную политику моделей.

```
POST /api/ai/tasks
  → authenticated workspace + entitlement
  → durable task record
  → Trigger.dev ai.generate
  → model routing + generation
  → usage record + result
  → transactional completion delivery
```


## Настраивайте алиасы и бюджеты

Пользователь выбирает включённый алиас: cheap, fast или smart. Сервер контролирует базовые ID моделей, креденшелы провайдеров, политику воркспейса и обеспечение бюджета. Зашифрованная поддержка bring-your-own-key должна сохранять ту же серверную границу.


## Держите семантику workflow явной

JobRunner обещает только enqueue, status и cancel. Семантика workflow Trigger.dev явная, включая устойчивое поведение выполнения. Не выводите повторы или гарантии планирования из общего контракта.

Продакшен-путь отправки использует идемпотентность и восстановление сохранённых задач для обработки неоднозначной отправки. Завершение генерации отделено от доставки письма о завершении.


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

AI_PROVIDER=fake сохраняет разработку детерминированной. Продакшен-провайдеры настраиваются на сервере (OpenAI, Anthropic или OpenAI-совместимый endpoint) с ключами, которые никогда не попадают в клиентские бандлы. AI_MODEL_POLICY сопоставляет пользовательские алиасы — cheap, fast, smart — с id моделей каталога; пустой алиас убирает выбор из интерфейса.

Каталог моделей (ai-model-catalog) несёт метаданные о возможностях и неизменяемых ценах, так что записи об использовании остаются объяснимыми после изменений цен.

```
POST /api/ai/tasks          → durable task + Trigger.dev dispatch
GET  /api/ai/tasks/{taskId}  → status + result
/chat                        → streaming assistant surface
```


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

Поверхность чата ведёт треды по участникам пространства и стримит токены через chat-stream-runtime. Длительные генерации выполняются как задачи: авторизуются на API-границе, исполняются workflow ai.generate и восстанавливаются через идемпотентное хранилище отправок.

Режим bring-your-own-key хранит ключи провайдеров как AES-GCM-конверты (CREDENTIAL_ENCRYPTION_KEY, byok-key-vault.ts); расшифровка происходит только внутри серверного пути исполнения. Использование и оценочная стоимость записываются на каждый запрос для бюджетов пространства.


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

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


## Вперёд

[Фоновые задачи](https://supastack.dev/ru/docs/web/jobs.md)