AIRUS SupportOps

«Пришлите скриншот» — это не техподдержка. Gateway уже знает request_id, route, модель, provider attempts и ошибку. AIRUS сам говорит: что сломалось → кто виноват → списались ли деньги → как исправить. Скриншоты — археология, Request ID — инженерия.

Что делает

Error Doctor по Request ID

Вставьте request_id → диагноз именно вашего запроса из реальной телеметрии: category/source, retryable, списан ли баланс, fix snippets. Не статическая страница про «429 вообще».

Единый Error Envelope

Одна taxonomy для GPT, Claude, Gemini, GigaChat и локальных: отделяет ошибку клиента, gateway, маршрута, upstream-провайдера, модели и биллинга. Не гадать, чей это 429.

Safe Debug Bundle

Безопасно by design: сырые prompt/completion не хранятся (правило #6), ключ redacted. Отдаём модель/route/status/provider — без утечки секретов и ПДн.

Support Case + SLA-тиры

One-click кейс с request_id и debug bundle. Developer (self-service) → Team → Business → Enterprise (SEV1 за 15 мин, private channel + инженер). Поддержка как продукт.

Как использовать

# 1. Диагноз по request_id (из заголовка x-request-id ответа) (JWT)
GET /v1/airus/support/errors/{request_id}
# → category, source, retryable, root_cause, cost_charged_rub, balance_charged, fix_snippets

# 2. Безопасный debug bundle (без промптов/ключей)
GET /v1/airus/support/debug-bundles/{request_id}?sdk=openai-python/2.x
# → sanitized:true, prompt_body_included:false, api_key_redacted:true

# 3. One-click support case (SLA по тиру)
POST /v1/airus/support/cases
{ "subject": "streaming падает", "category": "streaming", "severity": "SEV2",
  "request_ids": ["req_..."], "tier": "business", "attach_debug_bundle": true }

# 4. Fix verification (client-driven replay)
POST /v1/airus/support/fix-verifications
{ "original_request_id": "req_old", "replay_request_id": "req_new", "fix": "backoff" }
# → verified (original failed → replay ok)

Честно про слой

Диагностика по реальной телеметрии: request_id ищется в RequestLog (metadata-only). Классификация детерминирована.
Debug bundle безопасен by design: AIRUS изначально не хранит тела промптов (правило #6) → нечего утекать; ключ хранится только hash+prefix.
Fix verification — client-driven: AIRUS не может авто-replay (нет тела промпта) — клиент повторяет запрос, AIRUS сверяет статусы двух request_id. Sandbox auto-replay — roadmap.
Дополняет, не дублирует: статический Error Doctor (/v1/airus/errors — каталог why/how) — здесь trace-aware поверх реального запроса. Реальная доставка (live Telegram-канал, инженер Integration Rescue) — платная услуга/бизнес-процесс; SLA-тир задаёт целевое время. Telegram routing — roadmap.

Диагноз по Request ID SupportOps API