AI Gateway
Central model routing, provider governance, API keys, usage и external agent access для AI-функций Skitflow.
AI Gateway объединяет настройку провайдеров, состояние шлюза, API-ключи и использование в одном разделе dashboard. Здесь можно подключить провайдера организации, включить AI-функции Skitflow и дать разрешённым приложениям OpenAI-совместимый доступ без передачи provider credentials.
Он поддерживает AI Assistant, Ask AI actions, анализ и hardening Compose, а также внешние приложения, использующие доступные организации модели.
Начало работы в dashboard
- Откройте AI Gateway → Overview. Карточка Шлюз показывает Отключён, Работает или Недоступен, а карточка Провайдеры — количество включённых провайдеров организации.
- Откройте Providers и добавьте провайдера. Вернитесь в Overview и убедитесь, что он доступен.
- Используйте Assistant для интерактивной работы, API Keys для разрешённых приложений и Usage для просмотра запросов и расходов организации.
- Операторы платформы могут использовать Models и Platform Usage для настройки общих моделей и governance.
Gateway sections в dashboard
AI Gateway включает такие разделы:
| Section | Purpose |
|---|---|
| Overview | Состояние gateway, количество провайдеров организации, сводка usage и доступные self-hosted controls. |
| Assistant | Product-facing AI chat и operations assistant. |
| Providers | Tenant BYOK provider configuration. Старый Settings → AI редиректит сюда. |
| Models | Platform model configuration и default chat models. |
| API Keys | Organization-scoped gateway API keys и callable models для approved agents и automation. |
| Usage | Organization usage через gateway. |
| Platform Usage | Operator view для platform model spend и governance. |
Администрирование self-hosted
На поддерживаемых self-hosted инсталляциях в AI Gateway → Overview доступна карточка AI-слой:
- Нажмите Включить AI Gateway. После успешной настройки карточка показывает Развёрнуто, а затем Работает; статус Запускается означает, что gateway ещё не готов.
- Используйте controls Реплики, чтобы запустить от 1 до 5 реплик, если нагрузке нужна дополнительная ёмкость.
- Для доступа внешних приложений укажите HTTPS base address в поле Публичный URL шлюза и нажмите Сохранить. Направьте DNS A record этого хоста на сервер и откройте порты 80 и 443. Опубликованный route предоставляет
/v1и/health. - Отключить останавливает запросы к gateway. Опция Также удалить данные (том pgvector) — необратимо удаляет эти данные без возможности восстановления; не включайте её, если хотите лишь временно выключить gateway.
Облачные клиенты не управляют этим AI layer. Если карточки нет на self-hosted инсталляции, уточните у администратора инстанса, как управляется gateway.
Если включение завершилось ошибкой, статус остаётся Запускается или карточка Шлюз показывает Недоступен, скопируйте отображаемую ошибку и выполните шаги диагностики self-hosted.
Внешние приложения и агенты
Откройте API Keys, чтобы создать organization-scoped key и увидеть endpoint и модели, доступные организации. Используйте эти значения с OpenAI-compatible SDK для разрешённых агентов, automation и внутренних приложений. Provider credentials должны оставаться server-side; приложениям нужен только gateway key.
Security and privacy
- Provider keys write-only в management API. UI видит только факт наличия key, не значение.
- Gateway использует server-side routing decisions и organization-scoped keys для attribution.
- Assistant proposals не выполняются автоматически. Mutating actions требуют явного подтверждения и затем повторно проходят server-side authorization.
- Environment-variable diffs показывают только имена keys, без secret values.
Используйте AI Gateway → Providers для tenant BYOK configuration. Используйте AI Gateway → Models, API Keys и Platform Usage для governed model access и operator-managed defaults.
ИИ-ассистент
Используйте AI Assistant в Skitflow для генерации Compose, анализа деплоев, hardening и proposal-based операций через AI Gateway.
Code Review
Автоматическое ревью pull request в подключённых репозиториях GitHub, GitLab и Gitea/Forgejo с переиспользуемыми правилами ревью и контекстом всей кодовой базы.