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 имеет доступ только к указанным папкам; остальная файловая система приложению недоступна.

Шаг 2. Ключ API RouterAI

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

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

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

  1. Откройте Bench и перейдите в Настройки (значок профиля в нижнем левом углу).

[Скриншот: окно настроек Bench — step1-settings.jpg]

  1. Откройте страницу «Модели» и нажмите «Добавить».

[Скриншот: страница «Модели», кнопка «Добавить» — step2-models-add.jpg]

  1. Заполните поля подключения:

[Скриншот: форма подключения провайдера — step3-form.jpg]

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

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

На следующем экране Bench автоматически загрузит каталог моделей RouterAI и покажет его списком с поиском. Отметьте модели, которые планируете использовать, — например, одну для сложных задач и одну недорогую для массовых операций.

Нажмите «Добавить провайдера». Настройка завершена: выбранные модели доступны в списке моделей чата. Состав моделей можно изменить в любой момент в том же разделе настроек.

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

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

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

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

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

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

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

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

  • Закрывайте файлы, не относящиеся к задаче. Агент учитывает открытые вкладки, и лишние файлы увеличивают объём контекста.
  • Сжимайте длинные диалоги командой /compact — она заменяет полную историю переписки кратким пересказом.
  • Зафиксируйте правила проекта в файле инструкций для агента, чтобы не повторять одни и те же требования в каждом запросе.

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

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

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

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

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

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

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

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

Расход токенов выше ожидаемого. Сожмите диалог командой /compact, закройте неиспользуемые файлы, разносите независимые задачи по отдельным чатам.

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