Провайдеры
Состояние провайдеров, доступность моделей и ручной запуск проверки.
Раздел «Система» → «Провайдеры» состоит из страниц «Здоровье» и «Матрица». Они доступны только для просмотра; на странице «Здоровье» можно вручную запустить проверку.
Провайдер — внешняя служба, которая и выполняет работу внутри задачи или чата. Какие провайдеры подключены и какие модели у каждого разрешены, задаётся при установке портала. Добавить провайдера или модель с этих страниц нельзя.
Здоровье провайдеров
Заголовок страницы — «Здоровье провайдеров», под ним подпись «Текущее состояние CLI-провайдеров и история переходов». Справа вверху стоят «Последняя проверка: …» и кнопка «Проверить сейчас».
Столбцы таблицы: «Провайдер», «Состояние», «Причина», «Латентность», «С какого момента», «Проверено».
- «Провайдер» — короткое имя, под которым провайдер записан в портале:
claude,codex,opencode,claude-compact,codex-compact,selfhosted. В таблице стоят только те из них, которые подключены к вашему порталу, — набор задаётся при установке. На «Матрице» те же провайдеры подписаны полными названиями вроде «Claude Code CLI». - «Состояние» — цветная плашка с английским словом. Портал их не переводит; что каждое значит — в таблице ниже.
- «Причина» — короткое пояснение от самой проверки. Прочерк означает, что пояснять нечего.
- «Латентность» — сколько миллисекунд заняла проверка.
- «С какого момента» — когда провайдер перешёл в нынешнее состояние; «Проверено» — когда его проверяли в последний раз.
Страница сама перечитывает данные раз в полминуты — обновлять вкладку не нужно.
Что означают состояния
| Плашка | Цвет | Что это значит |
|---|---|---|
healthy | зелёная | Провайдер отвечает, все прописанные ему модели на месте. |
unhealthy | красная | Провайдер не отвечает. Задачи, отправленные на него, будут падать или зависать. Если это провайдер по умолчанию — падать будут и новые задачи, где провайдер не выбран явно. |
unresolved | красная | Провайдер отвечает, но моделей, которые ему прописаны, у него нет. Задачи на этих моделях обрываются сразу, не начав работу. |
stale_catalog | жёлтая | Все прописанные модели нашлись, но справочник моделей, по которому портал сверяется, устарел. Работе это не мешает. |
probe_failed | жёлтая | Не отработала сама проверка моделей — про их состав ничего не известно. Задачи при этом могут идти нормально: сломан контроль, а не обязательно провайдер. |
Под плашкой иногда появляются ещё две строки:
- «⚠ не резолвится (N): …» — перечислены модели, которых у провайдера не нашлось, и их общее число.
- «⚠ только базовый вариант: …» — модель нашлась, но не в том варианте, который ей прописан.
Красная плашка — не то, что чинится из портала. Ни на одной из этих страниц нельзя переключить провайдера, поменять его настройки или подставить другую модель вместо пропавшей. Ваше действие здесь ровно одно: сообщить тому, кто обслуживает портал, и назвать провайдера, слово из столбца «Состояние» и текст из столбца «Причина».
Проверка вне расписания
Портал проверяет провайдеров сам, по расписанию. Кнопка «Проверить сейчас» просит сделать это немедленно.
Пока идёт ожидание, над таблицей может появиться подсказка «Перепроверка занимает несколько минут — вкладку можно закрыть, браузер пришлёт уведомление о её завершении» с кнопкой «Включить» — её показывают, пока уведомления в браузере не включены.
Портал отвечает на нажатие одним из четырёх сообщений. В двух из них встречается слово «воркер» — так называется фоновая служба портала, которая и опрашивает провайдеров.
- «Запрошена перепроверка — ждём ответ воркера» — заявка принята, проверка начнётся.
- «Провайдеры перепроверены» — данные в таблице уже новые.
- «Воркер ещё не отчитался — состояние обновится автоматически» — страница ждала две минуты и перестала следить. Проверка при этом продолжается, результат появится сам.
- «Нет живого воркера» — фоновая служба сейчас не работает, проверять некому. Это повод обратиться к тому, кто обслуживает портал.
Над таблицей могут появиться два предупреждения:
- «Нет активного воркера — текущее состояние может быть устаревшим. История переходов актуальна.» — цифры в верхней таблице могли устареть, нижняя таблица по-прежнему верна.
- «Не удалось обновить данные: … Показано последнее известное состояние.» — очередная попытка перечитать данные не удалась, на экране остались прежние.
История переходов
Нижняя таблица «История переходов» показывает не текущее состояние, а моменты, когда оно менялось: «Время», «Провайдер», «Переход», «Причина». Переход записан как «было → стало»; если провайдер попал в портал впервые, слева стоит прочерк.
Показываются последние сто переходов. Записи старше 90 дней портал удаляет сам, поэтому история за прошлый квартал здесь уже не найдётся.
Эта таблица читается независимо от фоновой службы — она остаётся верной даже тогда, когда верхняя устарела. Именно по ней видно, когда всё сломалось.
Матрица провайдеров
Вторая страница отвечает на вопрос «где в портале используется вот эта модель». Заголовок — «Матрица провайдеров», подпись — «Все провайдеры и модели по тасктайпам — шаги, сравнение, аудит, чат».
По умолчанию строки сгруппированы по типам задач: название типа стоит в заголовке серой полосы, рядом — число строк под ней и ссылка «Открыть тасктайп». Полосу можно свернуть щелчком.
Столбцы внутри группы: «Тип», «Что», «Провайдер», «Модель», «Действие».
- «Тип» — где именно стоит эта пара: «Шаг», «Сравнение», «Аудит» или «Чат». У чата рядом может стоять пометка «default».
- «Что» — конкретное место, например «Шаг 1: …».
- «Провайдер» — полное название. Если в самом типе задачи записан один провайдер, а работает другой, ниже появится строка «(задано: …)». Пометка «не сконфигурирован» означает, что записанного провайдера в портале нет.
- «Модель» — название модели. Курсивом с пометкой «(дефолт)» показана модель, которую портал подставил сам, потому что в типе задачи она не выбрана.
- «Действие» — ссылка «Открыть», ведущая прямо на нужную вкладку формы типа задачи.
Вместо модели в строке может стоять курсивная надпись:
| Надпись | Что это значит |
|---|---|
| «— (провайдер не сконф.)» | Провайдера, записанного в этом месте, в портале нет. |
| «любая модель провайдера» | Ограничения по модели нет, подойдёт любая. |
| «по умолчанию провайдера» | Модель не выбрана, и портал не знает, какая подставится. |
Рядом с моделью встречаются пометки: «не в текущем списке» — модель больше не разрешена; «кросс-провайдерная пара» — модель и провайдер из разных наборов; «wildcard» — вместо названия стоит шаблон; «разрешена любая модель».
Фильтры
Над таблицей — «Поиск по тасктайпу», выпадающие списки «Модель» и «Провайдер», кнопки «Тип поверхности» («Все типы», «Шаги», «Сравнение», «Аудит», «Чат») и три галочки: «Группировать», «Выключенные», «Системные». Последние две по умолчанию сняты, поэтому отключённые и системные типы задач в матрице не видны, пока вы их не попросите.
Стоит выбрать модель, и над таблицей появляется счётчик: «Модель «…» используется в N местах / M тасктайпах». Это и есть ответ на вопрос «что сломается, если модель уберут».
Под счётчиком может встать жёлтая полоса: «+N шагов с моделью по умолчанию провайдера (не фильтруются). Такие шаги могут использовать модель «…», но forge не знает её дефолт. Проверьте их вручную.» Это значит, что счётчик занижен: в найденные N мест не попали шаги без явно выбранной модели. Пересчитывать их портал не берётся.
Когда под фильтры ничего не подошло, вместо таблицы стоит «Нет записей» и пояснение «Нет провайдер/модель привязок, соответствующих фильтрам.».
Что здесь можно изменить
Ничего. Обе страницы только читают. Провайдер и модель выбираются в другом месте — в форме типа задачи: на вкладке «Шаги» у каждого шага есть поля «CLI-провайдер» и «Модель», а на вкладке «Настройки» — «Провайдер сравнения», «Модель сравнения», «Провайдер аудита» и «Модель аудита». Ссылка «Открыть» в матрице ведёт ровно туда.
Если что-то пошло не так
- Плашка красная, а задачи идут. Проверьте столбец «Проверено»: если проверка была давно, а над таблицей висит «Нет активного воркера…», состояние просто устарело.
- Кнопка «Проверить сейчас» отвечает сообщением о том, что ручная перепроверка отключена. Проверку по кнопке выключили при настройке портала. Расписание при этом работает; чтобы вернуть кнопку, обратитесь к тому, кто портал ставил.
- «Последняя проверка» показывает прочерк. Ни одной проверки после запуска ещё не было. Подождите или нажмите «Проверить сейчас».
- В выпадающем списке «Модель» нет нужной модели. Список собирается из того, что реально встретилось в типах задач, а не из всех разрешённых моделей.
- Тип задачи не нашёлся в матрице. Снимите фильтры и поставьте галочки «Выключенные» и «Системные» — по умолчанию такие типы скрыты.