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/ai.md (or send Accept: text/markdown).
AI-функции
Чат, задачи, политика моделей и bring-your-own-key.
Попробуйте поддельный искусственный интеллект, а затем выберите настоящего провайдера
Для получения первого результата выполните задачу /dashboard веб-учебника: запустите локальный поток, поставьте приглашение в очередь, запустите его и просмотрите результат. AI_PROVIDER=fake возвращает повторяемый демонстрационный ответ без отправки данных во внешнюю модель или использования платного ключа API.
Для реального создания сначала настройте постоянные учетные записи, выберите поставщика AI и следуйте настройке AI ниже. Добавьте модель и ее цену в каталог базы данных, выберите разрешенные модели для каждого псевдонима и предоставьте рабочей области необходимый доступ. Псевдоним, такой как fast, представляет собой удобный выбор, отображаемый пользователю; он сам по себе не является идентификатором модели внешнего поставщика.
Фоновому AI task также требуется настроенная служба заданий. Если выбор модели не отображается, проверьте каталог и политику псевдонимов, прежде чем повторять попытку. Если в доступе отказано, проверьте права активной рабочей области. Храните все ключи поставщика API в конфигурации веб-сервера, а не в окне браузера, мобильного приложения или рабочего стола.
Следите за жизненным циклом задачи
Продакшен-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-пути провайдера.