support@routerai.ru

Загрузка...

Bench + RouterAI: подключение AI-агента к моделям через API

Bench — десктопное приложение-агент для macOS, Windows и Linux. Приложение работает с файлами в открытых ему папках: читает и редактирует код и документы, выполняет многошаговые задачи, по запросу подключается к внешним системам — трекерам задач, вики, базам данных. Bench поддерживает любой OpenAI-совместимый API, поэтому RouterAI подключается к нему напрямую: один ключ API даёт доступ ко всем моделям каталога, включая Claude, GPT, DeepSeek и Gemini.

Инструкция описывает установку Bench, подключение RouterAI в качестве провайдера моделей, выбор моделей и решение типичных проблем. Настройка занимает несколько минут.

Требования

VPN и зарубежная банковская карта не требуются: запросы к моделям проходят через RouterAI, оплата производится в рублях.

Шаг 1. Установка Bench

  1. Скачайте дистрибутив для своей операционной системы на getbench-ai.ru/download.
  2. Установите и запустите приложение.
  3. Создайте пространство — рабочую область: задайте ему имя и привяжите одну или несколько папок, с которыми будет работать агент. Bench имеет доступ только к указанным папкам; остальная файловая система приложению недоступна. Папки можно добавить или убрать в любой момент.
  4. Войдите в аккаунт Bench: вход выполняется через сайт Bench, меню аккаунта находится внизу слева (профиль, выход).

Шаг 2. Ключ API RouterAI

  1. Зарегистрируйтесь или войдите на routerai.ru.
  2. Откройте в личном кабинете раздел «Ключи API».
  3. Нажмите «Создать ключ» и скопируйте его.
  4. Пополните баланс. Оплата начисляется за фактически использованные токены; фиксированная подписка не требуется.

Ключ начинается с sk- и отображается только один раз — при создании. Если ключ не был скопирован, создайте новый, а прежний удалите.

Шаг 3. Подключение RouterAI к Bench

  1. Откройте Bench и перейдите в Настройки: меню аккаунта в нижнем левом углу или сочетание Ctrl+, (на macOS — Cmd+,).

1.00

  1. Откройте раздел «Модели» (блок «Настройки» в списке слева). Блок «Свои провайдеры» пуст — нажмите «Добавить провайдера» (или «+ Добавить» справа от заголовка блока).

1.00

  1. В окне «Новый провайдер» заполните поля подключения:

1.00

Поле Значение
Тип OpenAI-совместимый (остальные варианты — Ollama и LM Studio)
Адрес https://routerai.ru/api/v1
API-ключ ключ sk-…, созданный на шаге 2
Название произвольное, например RouterAI — под этим именем подключение отображается в списке
  1. Нажмите «Дальше».

Шаг 4. Выбор моделей

На следующем экране — «RouterAI · модели» — Bench загрузит каталог моделей RouterAI и покажет его списком с поиском. Введите в поле поиска часть названия и отметьте модели, которые планируете использовать, — например, одну для сложных задач и одну недорогую для массовых операций. Счётчик внизу показывает, сколько моделей выбрано из всего каталога («Выбрано 2 из 575»); если список пуст или устарел, нажмите «Обновить».

1.00

У каждой отмеченной модели есть поле «Контекст»: по умолчанию стоит «Автоматически» — размер окна сообщает сервер. Эта настройка нужна Bench, чтобы вовремя сокращать переписку; она не увеличивает окно модели на сервере. Минимальное значение — 32K.

Нажмите «Добавить провайдера». Настройка завершена: провайдер появится в блоке «Свои провайдеры» с пометкой «ключ сохранён», а выбранные модели станут доступны в списке моделей чата. Состав моделей можно изменить в любой момент кнопкой «Выбрать модели…» в карточке провайдера; подключение редактируется кнопкой «Изменить», удаляется — «Удалить».

1.00

Шаг 5. Проверка подключения

  1. Создайте в Bench новый чат.
  2. Выберите одну из подключённых моделей в списке под полем ввода.
  3. Отправьте короткое тестовое сообщение и убедитесь, что модель отвечает. Например, в папке с демо-проектом «Invoices» попросите: «Найди в invoices.js просроченные счета и выведи их».

1.00

Если вместо ответа возвращается ошибка, см. раздел «Решение проблем».

Выбор модели под задачу

Модель в RouterAI выбирается под конкретную задачу. Ориентировочное разделение:

Задача Рекомендуемые модели Обоснование
Архитектура, анализ незнакомого проекта, длинный контекст Claude (anthropic/…) Устойчиво работают с большим контекстом и многошаговыми рассуждениями
Универсальные задачи, работа с инструментами GPT (openai/…) Стабильный вызов инструментов, качественная генерация кода и текста
Массовые правки, тесты, однотипные операции Модели семейства DeepSeek (deepseek/…) Существенно ниже стоимость при сопоставимом качестве на простых задачах
Обработка сверхдлинных документов Модели с контекстом от 1 млн токенов Позволяют обрабатывать документ целиком, без разбиения на части

Состав каталога и идентификаторы моделей периодически меняются — актуальный список приведён на странице «Модели».

Рекомендации по сокращению расхода токенов:

  • Закрывайте файлы, не относящиеся к задаче. Агент учитывает открытые вкладки, и лишние файлы увеличивают объём контекста.
  • Сжимайте длинные диалоги. Если диалог стал очень длинным, попросите Bench «сжать» его — он кратко перескажет суть и продолжит работу. Отдельной команды для этого нет. Поле «Контекст» в настройках модели (шаг 4) помогает Bench вовремя сокращать переписку автоматически, но окно модели на сервере не увеличивает.
  • Зафиксируйте правила проекта в файле инструкций для агента, чтобы не повторять одни и те же требования в каждом запросе.

Безопасность и контроль расходов

  • Ключ API хранится локально в защищённом хранилище Bench, не записывается в логи и используется только для запросов к API RouterAI. В интерфейсе после сохранения ключ отображается как ••••••••.
  • В сеть передаётся содержимое запроса: текст задачи и фрагменты файлов, необходимые модели для ответа. Запросы направляются в RouterAI, который проксирует их к выбранной модели.
  • Степень самостоятельности агента настраивается режимами доступа: от режима «только чтение» до автономной работы. В ограниченных режимах изменение файлов, выполнение команд и обращения в сеть требуют подтверждения пользователя.
  • Баланс и расходы отображаются в личном кабинете RouterAI. Для контроля остатка рекомендуется включить уведомления о низком балансе в разделе «Финансы».

Решение проблем

Ошибка 401 при первом запросе. Ключ введён неверно или отозван. Создайте новый ключ в разделе «Ключи API» и обновите подключение в Bench.

Каталог моделей не загружается (пустой список). Ключ не сохранился или скопирован с лишним пробелом. Вернитесь на предыдущий экран, проверьте поле «API-ключ» и нажмите «Обновить».

Ошибка 402. Недостаточно средств на балансе. Пополните баланс в личном кабинете RouterAI.

Ошибка «Модель не найдена». Модель переименована или исключена из каталога. Выберите актуальную модель на странице «Модели» и добавьте её к подключению в настройках Bench.

Модель отвечает медленно. Используйте для текущей задачи более лёгкую модель или сократите объём контекста, закрыв файлы, не относящиеся к задаче.

Расход токенов выше ожидаемого. Попросите Bench «сжать» длинный диалог (он кратко перескажет суть и продолжит работу), закройте неиспользуемые файлы, разносите независимые задачи по отдельным чатам.

Полезные ссылки