Редактор профилей маршрутизации
Вкладка Models → Routing в дашборде OpenCodex позволяет управлять config.routingProfiles без ручного редактирования config.json.
Создание профиля
Заголовок раздела «Создание профиля»- Откройте Routing в дашборде.
- Выберите Create profile.
- Укажите
id. Канонический id модели имеет видpolicy/<id>. - Добавьте одного или нескольких явных кандидатов provider/model.
- Настройте необязательные требования, веса оценки, ограничения стоимости (
maxEstimatedCostUsd, необязательныйonUnknownCost) и поведение при неизвестных данных. - Сохраните профиль.
После создания id профиля изменить нельзя. Если нужен другой id, создайте новый профиль, обновите вызывающие стороны и удалите старый.
Проверка и сохранение
Заголовок раздела «Проверка и сохранение»Дашборд отправляет в API управления тот же объект профиля, который используется в config.routingProfiles. Перед записью сервер проверяет кандидата целиком:
- id и алиасы должны соблюдать правила именования и исключения конфликтов профилей маршрутизации;
- каждый провайдер-кандидат должен существовать и быть включённым;
- повторяющиеся кандидаты отклоняются;
- числовые лимиты и требования должны оставаться в допустимых диапазонах;
- хотя бы один вес оптимизации должен быть положительным.
При успешном сохранении профиль записывается обычным механизмом конфигурации, согласуется с текущим состоянием и обновляет каталог моделей. При ошибке проверки прежняя конфигурация не меняется, а ошибка показывается в редакторе.
Если задан limits.maxEstimatedCostUsd, для limits.onUnknownCost по умолчанию используется "allow": неизвестная оценка стоимости не исключается именно из-за лимита, а трассировки пробной и реальной маршрутизации помечают cost.capOutcome: "unknown-allowed", чтобы оператор видел, что соблюдение лимита не доказано. Укажите "exclude", если потолок должен закрываться отказом (cost-limit-unknown и cost.capOutcome: "unknown-excluded"). Один только onUnknownCost ничего не меняет и не создаёт отметку о результате лимита. Это отдельно от unknownEvidence.cost, который может независимо исключать или штрафовать неизвестные цены.
Пробная оценка сохранённого профиля
Заголовок раздела «Пробная оценка сохранённого профиля»Возможности кандидата определяются по итоговой конфигурации провайдера после применения переопределений реестра. Поэтому требования к расположению (localOnly и remoteAllowed) используют фактический адрес вышестоящего сервиса. Если адрес нельзя классифицировать, допуск определяет настройка unknownEvidence.capability профиля. Неверная конфигурация провайдера, которую нельзя разрешить, всегда исключается с route-unavailable, даже если неизвестные возможности разрешены. Отсутствующие или отключённые провайдеры также исключаются с route-unavailable до оценки.
Выберите сохранённый профиль и используйте Dry-run evaluation, чтобы добавить сведения о запросе: размер контекстного окна, использование инструментов, входное изображение или структурированный вывод. Пробный запуск оценивает допуск и баллы, но не отправляет запрос вышестоящей модели.
Несохранённые изменения не участвуют в пробном запуске. Сначала сохраните профиль, чтобы показанные версия и оценка относились к одной конфигурации.
API управления
Заголовок раздела «API управления»Редактор использует следующие эндпоинты:
GET /api/routing-profilesперечисляет нормализованные профили и версии.PUT /api/routing-profilesсоздаёт или обновляет один профиль. Передайтеmode: "create"илиmode: "update"; режим создания не перезаписывает существующий id.DELETE /api/routing-profiles?id=<id>удаляет один профиль.POST /api/routing-profiles/dry-runоценивает сохранённый профиль без отправки запроса вышестоящему сервису.
Пример данных для сохранения:
{ "id": "fast", "mode": "create", "profile": { "alias": "ocx/fast", "candidates": [ { "provider": "anthropic", "model": "claude-sonnet-5" }, { "provider": "openai", "model": "gpt-5.6" } ], "require": { "tools": true, "minContextWindow": 128000 }, "optimize": { "latency": 0.55, "health": 0.25, "cost": 0.1, "quota": 0.1 }, "limits": { "maxEstimatedCostUsd": 0.5, "onUnknownCost": "allow" }, "unknownEvidence": { "capability": "exclude", "health": "penalize", "quota": "penalize", "cost": "penalize" } }}