AIRUS MigrationOps
«Поменяли base_url — прод умер» — классика. OpenAI-compatible не значит одинаковое поведение: JSON, tool calls, streaming и RAG могут деградировать. AIRUS переносит production-нагрузку с проверкой совместимости, стоимости и rollback — а не молитвой.
Что делает
Переезд как продукт: импорт конфига → compatibility scan → сравнение цены/качества → migration receipt → cutover checklist → rollback plan. Каждый шаг — доказательство для CTO, CFO и ИБ, а не «у нас тоже API».
Config Import
POST /migration/import-config → распознаём провайдера, base_url и модель из .env / OpenAI SDK / n8n. Ключ не сохраняется — только факт наличия.
Compatibility Score
POST /compatibility-scan → детерминированная оценка гэпов по capabilities (chat, streaming, JSON, tools, embeddings, vision, audio, batch, long context) + known_gaps.
Compare + Receipt
POST /compare → cost delta (реальный), quality delta (через EvalOps), latency, cutover decision. Migration Receipt для CTO/CFO/ИБ.
Cutover + Rollback
Чек-лист переключения (scoped keys, data route, мониторинг) и rollback plan по умолчанию: старый base_url, модель, scope. Кнопка «назад» всегда готова.
Как переехать
# 1. Импорт текущего конфига (публично, ключ не сохраняется)
POST /v1/airus/migration/import-config
{ "kind": "env", "content": "OPENAI_BASE_URL=https://api.aitunnel.ru/v1\nOPENAI_MODEL=gpt-4o" }
# → { "detected_provider": "aitunnel", "suggested_capabilities": [...] }
# 2. Проект миграции + compatibility scan (JWT)
POST /v1/airus/migration/projects { "migration_key": "support_rag", "source_base_url": "..." }
POST /v1/airus/migration/projects/{id}/compatibility-scan
{ "used_capabilities": ["chat","streaming","tool_calls","json_schema"] }
# 3. Сравнение и решение
POST /v1/airus/migration/projects/{id}/compare { "source_cost_per_1m_rub": 300 }
# → migration_receipt: cost_delta_percent, cutover_decision
# 4. Cutover / rollback
POST /v1/airus/migration/projects/{id}/cutover # чек-лист
POST /v1/airus/migration/projects/{id}/rollback # план откатаЧестно про проверку
- Compatibility scan — детерминированный knowledge-base задокументированных гэпов совместимости (напр., у Claude через OpenAI-compat строже tool-call схема, нет embeddings; у vLLM/Ollama JSON/tools зависят от модели). Это не живой зонд вашего endpoint'а — для live self-check ключом есть Migration Cockpit.
- Cost delta — реальный (из вашей текущей цены vs цена AIRUS-маршрута). Quality delta — измеряется через EvalOps (golden dataset), иначе честно помечается not_measured.
- Roadmap: реальный shadow-mirror живого production-трафика, native execution-адаптеры (Anthropic Messages / Gemini native / OpenAI Responses / vLLM / Ollama), автогенератор SDK-PR, сканер GitHub-конфигов. Не выдаём за готовое.
- Импортированные конфиги обрабатываются без сохранения секретов (metadata-only).