> ## 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

Реальные модели за алиасами cheap / fast / smart — ключи остаются на сервере.

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

Перед любым действием прочтите [Перед началом работы](https://supastack.dev/ru/docs/web/before-you-start.md) и [Основные сведения о терминале](https://supastack.dev/ru/docs/web/terminal-basics.md). В этих инструкциях предполагается, что вы открыли полный монорепозиторий supastack в VS Code; его корень package.json отмечает корень репозитория. В командах pnpm пакет рабочей области представляет собой папку приложения или общего кода; В продукте рабочее пространство — это контейнер данных и граница безопасности команды. corepack pnpm --filter ... выбирает один пакет из монорепозитория, пока команды выполняются из его корня. Если вы открыли только синхронизированную папку мобильного устройства или рабочего стола, она не содержит веб-серверной части, настройки Docker или корневых сценариев: запустите серверную часть из этого монорепозитория или доступного размещенного сервера и используйте собственные сценарии папки платформы. Переменная среды — это именованный параметр, хранящийся в локальном файле .env или на панели управления хостингом; перезапустите соответствующее приложение после его изменения и не допускайте попадания секретов сервера в значения NEXT_PUBLIC_ и EXPO_PUBLIC_.

1. Откройте apps/web/.env.local для локального веб-сервера и apps/web/src/agent-runtime.ts для выбора провайдера; .env.example — это список поддерживаемых имен параметров.

2. Сохраните AI_PROVIDER=fake для работы локального интерфейса, если у вас нет собственной учетной записи провайдера и вы не хотите протестировать реальную генерацию; никогда не помещайте ключи провайдера в настройки NEXT_PUBLIC_ или EXPO_PUBLIC_.

3. Запустите веб-приложение из корня репозитория с помощью corepack pnpm --filter @supastack/web dev. Ожидается: локальные экраны можно будет исследовать без настройки платного провайдера; для фактического создания требуется действительный поставщик сервера и включенный выбор моделей в каталоге базы данных.

Стандартный AI_PROVIDER=fake поддерживает локальную детерминированную работу. Конфигурация реальных провайдеров принадлежит серверному окружению. Ключи провайдеров, перечисленные в .env.example, включают OpenAI, Anthropic и OpenAI-совместимый endpoint.

AI_MODEL_POLICY содержит упорядоченные ID моделей для алиасов cheap, fast и smart. Пустой список алиасов отключает этот выбор. ID моделей должны соответствовать включённым записям каталога базы с действующими неизменными ценами.

```
AI_MODEL_POLICY='{"cheap":[],"fast":["catalog-model-id"],"smart":["catalog-model-id"]}'
AGENT_FRAMEWORK=ai-sdk    # ai-sdk | mastra | langgraph | openai-agents
```


## Команды для копирования

Следуйте комментариям, чтобы узнать, в какой папке запускается команда. Если помечены два терминала, откройте два окна терминала и продолжайте выполнять первую команду, пока используете вторую.

```
corepack pnpm --filter @supastack/web dev
```


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

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

Держите креденшелы вне переменных NEXT_PUBLIC_ и EXPO_PUBLIC_. Для режима bring-your-own-key используйте существующий зашифрованный конверт и границу расшифровки на сервере; никогда не возвращайте сохранённый ключ провайдера в интерфейс.


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

Если приложение сообщает, что модель ИИ недоступна, проверьте AI_PROVIDER сервера, включенные модели и цены в каталоге администратора, а также политику дешевых/быстрых/умных псевдонимов. Если реальный провайдер возвращает ошибку аутентификации, проверьте его ключ в apps/web/.env.local и перезапустите сервер. Ключ с префиксом NEXT_PUBLIC_ будет виден браузерам, и его необходимо удалить.

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


Чтобы продолжить настройку, прочитайте [Настройка фоновых задач](https://supastack.dev/ru/docs/web/setup-jobs.md).


## Вперёд

[AI и фоновые задачи](https://supastack.dev/ru/docs/modules/ai.md)