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).