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/web/setup-ai.md (or send Accept: text/markdown).
Настройка AI
Реальные модели за алиасами cheap / fast / smart — ключи остаются на сервере.
Настройка и конфигурация
Перед любым действием прочтите Перед началом работы и Основные сведения о терминале. В этих инструкциях предполагается, что вы открыли полный монорепозиторий 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 провайдера для реальной генерации. Если ни один алиас недоступен, инспектируйте политику сервера и конфигурацию каталога вместо показа сырого селектора моделей.