# Proto Agent через RouterAI: персональный AI-агент для бизнеса на своём ключе

Proto Agent — десктопный ИИ-агент для бизнес-задач от ERP•AI: вы описываете результат обычными словами («найди дубли счетов», «собери отчёт за квартал»), а агент работает с файлами на компьютере, сайтами во встроенном браузере и приложениями ERP•AI. По умолчанию Proto использует собственную управляемую модель, но в настройках можно подключить свой ключ провайдера. Тогда задача уходит на выбранную модель, и платите вы за токены у провайдера — через RouterAI это Claude, GPT, DeepSeek и GLM по одному ключу, с работой из России без VPN и оплатой в рублях.

Proto — альфа-версия: на момент проверки сайт отдаёт 0.3.9 для macOS (Apple Silicon), Windows (x64) и Linux (x64), и сам разработчик предупреждает, что возможности и форматы файлов могут меняться между выпусками. Интерфейс английский.

## Что умеет Proto {#chto-umeet}

Агент собирает задачу вокруг одного результата и сам решает, каким инструментом его получить. По [описанию на сайте](https://proto.erp.ai/) и в документации:

* **Файлы и документы** — читает Excel, Word, PowerPoint, PDF, изображения и CSV на вашем компьютере, сохраняет результат новым файлом, не меняя исходники. Работает в рамках рабочей папки (workspace).
* **Браузер** — встроенный браузер, где он заходит в сайты, под которыми вы уже авторизованы: веб-почта, CRM, порталы поставщиков.
* **ERP•AI** — собирает и обновляет приложения, записи, отчёты и процессы, если аккаунт ERP•AI подключён и у него есть права.
* **Память и навыки** — хранит историю задач и контекст на компьютере; повторяемую процедуру можно сохранить как навык и переиспользовать в следующий раз.

Управление чужими настольными приложениями — экспериментальная опция, по умолчанию выключена. CLI-версия Proto на момент проверки есть только как исследовательская сборка, для публики не выложена.

## Требования {#trebovaniya}

* macOS на Apple Silicon, Windows x64 или Linux x64 — других сборок на странице загрузки нет.
* Ключ RouterAI: [создайте его в личном кабинете](https://routerai.ru/settings/keys) и пополните баланс. Ключ вида `sk-xxxxxxxxxxxxxxxx` показывается один раз.
* Учётная запись для входа в приложение: Proto отправляет на email шестизначный код, пароля нет. Без входа настройки моделей недоступны.

## Установка {#ustanovka}

1. Откройте [proto.erp.ai/download](https://proto.erp.ai/download) и скачайте установщик для своей системы: DMG для macOS, EXE для Windows, AppImage для Linux.
2. Запустите установщик. На Linux AppImage нужно сделать исполняемым (`chmod +x Proto-x86_64.AppImage`) и запустить.
3. Введите email в поле на стартовом экране и нажмите **Send code** — Proto пришлёт шестизначный код, пароля нет.
4. В меню настроек (шестерёнка справа сверху) видна версия сборки и сервер: на проверочной сборке — **Version 0.3.9**, **Server apps.erp.ai**. Там же **Check for updates**.

![Стартовое окно Proto 0.3.9: вход по email и меню Settings с версией сборки и сервером](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/ded84dc944aa388d76c7aa50e0be8fce.png)

После первого запуска стоит сразу открыть **Settings → Permissions** и выключить **Uninterrupted mode**: по умолчанию новые установки работают без подтверждений, то есть Proto сам отправляет сообщения, отправляет формы и делает массовые изменения в ERP•AI. С выключенным режимом он спрашивает перед такими действиями. Это не заменяет права доступа к данным — только порядок подтверждений.

## Три способа подключить модель {#sposoby}

Модель задаётся в **Settings → Models**: в разделе **Plan** переключатель **Account** предлагает три варианта.

| Вариант Account | Что это | Когда подходит |
| --- | --- | --- |
| Proto Managed | Управляемая модель от Proto, ключ провайдера не нужен. Настройка и учёт использования — через ERP•AI | По умолчанию: попробовать агента без настройки |
| Your own API keys | Свои ключи провайдеров: раздел **API Keys** содержит OpenRouter и Fireworks, **More providers** — остальные настройки провайдеров | Вы хотите платить провайдеру напрямую и выбирать модель, в том числе RouterAI |
| Codex (ChatGPT) | Вход в аккаунт ChatGPT кнопкой **Sign in** в разделе **ChatGPT account** | У вас уже есть подписка ChatGPT |

Важно: подключение модели и подключение ERP•AI — разные вещи. Модель рассуждает над задачей, а учётная запись ERP•AI определяет, к каким бизнес-приложениям и записям агент имеет доступ.

## Подключение к RouterAI {#podklyuchenie-k-routerai}

RouterAI — OpenAI-совместимый шлюз, поэтому в Proto он подключается как провайдер со своим Base URL. Порядок шагов ниже — по [документации Proto](https://proto.erp.ai/docs/models-and-keys) (сборка 0.2.122 на момент её публикации); экран моделей открывается после входа в аккаунт, поэтому точные подписи полей в разделе **More providers** сверьте с вашей сборкой.

1. Откройте **Settings → Models**.
2. В **Plan → Account** выберите **Your own API keys**.
3. Откройте **More providers** — раздел с дополнительными настройками провайдеров, помимо OpenRouter и Fireworks.
4. В поле **Base URL** укажите `https://routerai.ru/api/v1`. Документация Proto отдельно предупреждает: лишний сегмент пути, адрес другого провайдера или случайно скопированный пробел ломают соединение. `https://routerai.ru/api` без `/v1` — это Anthropic Messages API, для этого поля он не подходит.
5. В поле ключа вставьте ключ RouterAI (в примерах ниже — заглушка `sk-xxxxxxxxxxxxxxxx`).
6. В поле модели укажите id из [каталога RouterAI](/models), например `anthropic/claude-sonnet-5.5` — id копируется целиком, вместе с префиксом провайдера.
7. Нажмите кнопку проверки соединения рядом с ключом, если она есть в вашей сборке. Proto проверяет доступ в этот момент; ошибку «нет ключа», «неверный ключ» или «ошибка соединения» нужно разобрать до запуска длинной задачи.
8. Сохраните настройки и запустите короткую задачу с результатом, который вы можете проверить глазами.

Независимая проверка ключа без интерфейса Proto:

```bash
curl https://routerai.ru/api/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"anthropic/claude-sonnet-5.5","messages":[{"role":"user","content":"Ответь одним словом: OK"}]}'
```

Если ответ пришёл, а Proto соединение не подтверждает — причина в адресе Base URL или в том, что модель не выбрана.

Тестовый контроль в Proto проверяет доступность провайдера, а не конкретную модель: после смены id задачу всё равно нужно перезапустить и посмотреть, какая модель отвечает.

## Выбор модели {#vybor-modeli}

Для агентских задач важны вызов инструментов и большой контекст: агент читает файлы, возвращает результаты шагов и держит в контексте историю задачи. Варианты из каталога RouterAI:

| Модель | Контекст (каталог) | Для чего |
| --- | --- | --- |
| `anthropic/claude-sonnet-5.5` | 1 000 000 | Основная для длинных бизнес-задач: файлы, таблицы, несколько инструментов |
| `deepseek/deepseek-v4.1-flash` | 1 048 576 | Дешёвая рабочая лошадка для извлечения данных и рутинной обработки |
| `z-ai/glm-5.3` | 1 048 576 | Альтернатива для работы с документами и таблицами |
| `openai/gpt-6.1-terra` | 1 050 000 | Задачи, где важна аккуратность формулировок и структура отчёта |

Все четыре id отвечают через API RouterAI. Цены в рублях за миллион токенов — в [каталоге](/models), они меняются, поэтому здесь не приводятся.

### Что меняется от модели к модели {#modeli-raznica}

Агентская работа в Proto состоит из повторяющихся циклов: прочитать файл, вызвать инструмент, посмотреть результат, при необходимости вызвать ещё один. На этом пути модель решает три разные задачи, и слабая модель обычно проваливается на последних двух:

* извлечь данные из неоднородных источников — сканов, выгрузок с разной структурой, переписки;
* удержать правила задачи на длинной цепочке шагов, не потеряв оговорку из брифа;
* выбрать следующий инструмент и корректно передать в него аргументы.

Практика, которую советует документация: одна и та же задача, один и тот же файл, одни и те же критерии проверки. Если две модели дали похожий ответ, но разное число шагов — сравните журнал действий, лишние шаги стоят токенов и повышают риск нежелательного действия. Для рутинного извлечения данных из CSV и таблиц достаточно быстрой дешёвой модели; для отчёта, который уйдёт руководству, берите модель посильнее.

Смена модели не меняет права доступа Proto к файлам и системам: она влияет только на то, кто обрабатывает содержимое задачи.

## Проверка на бизнес-задаче {#proverka}

Документация советует тестировать не «умность» модели, а конкретную работу: тот же вход, тот же ожидаемый результат, те же критерии проверки, что и в ежедневной работе. Короткие сценарии, на которых видно разницу между моделями, Proto описывает на [странице решений](https://proto.erp.ai/solutions):

* **Finance exception review** — свести отчёт по просроченной дебиторке с перепиской и документами и получить список исключений: спор, обещанный платёж, ошибка в документе, нет объяснения. Правило, которое стоит проговорить сразу: обещание оплаты — не оплата.
* **Sales account research** — бриф по клиенту перед звонком: что изменилось, чем это подтверждается и что ещё нужно уточнить.
* **Operations reporting** — собрать квартальный отчёт из нескольких выгрузок, сохранив оговорки о качестве данных.
* **Procurement supplier comparison** — сравнить коммерческие предложения на сопоставимой основе, не стирая различия в условиях.

Для первой проверки дайте один небольшой файл и явный результат: «сверь эти два счёта, найди расхождения, сохрани новый файл, исходные не меняй». Так видно, правильно ли модель поняла задачу, прежде чем доверять ей выгрузку за квартал.

## Где оказываются данные {#dannye}

Proto хранит рабочие файлы, сессии и память на вашем компьютере, но выбранная модель получает содержимое задачи, которое ей нужно для ответа. Свой ключ меняет только то, чей аккаунт провайдера обрабатывает запросы: офлайн-режимом это не становится. Работа с ERP•AI дополнительно сохраняется в историю диалога соответствующего приложения.

Для бизнес-данных это значит: если в задаче есть договоры, выгрузки по клиентам или переписка, содержимое уйдёт в RouterAI и дальше в выбранную модель. Ключ храните только в полях настроек Proto, а не в переписке с поддержкой; если ключ попал в чужие руки — перевыпустите его в кабинете RouterAI и обновите в Proto.

## Цены и статус {#ceny}

Само приложение бесплатно. При своём ключе за токены платит ваш аккаунт у провайдера — при работе через RouterAI это баланс RouterAI, пополняемый в рублях. Управляемая модель Proto тарифицируется по условиям ERP•AI. Публичного enterprise-плана и SLA для альфы разработчик не заявляет, а в документации сказано, что корпоративные настройки вроде централизованного управления устройствами и сертификаций в альфе нет.

## Решение проблем {#problemy}

* **Приложение не устанавливается или не открывается.** Проверьте, что скачали сборку под свою систему: macOS Apple Silicon, Windows x64 или Linux x64. Если установщик блокирует ОС или политика организации, сохраните точный текст ошибки — его просят при обращении в поддержку.
* **Проверка соединения с RouterAI не проходит.** Типичные причины: Base URL без `/v1`, лишний сегмент пути (`/chat/completions` в конце не нужен), пробел при копировании ключа, нулевой баланс или ключ отозван.
* **Соединение тестируется, а задача падает.** Проверка контроля подтверждает доступ в момент нажатия; дальше возможны сетевой сбой, лимит провайдера или недоступность конкретной модели. Сохраните текст ошибки и повторите после устранения причины.
* **Proto не читает файл.** Убедитесь, что файл существует по указанному пути и доступен вашему пользователю. Старые форматы Office сохраните как `.docx`, `.xlsx` или `.pptx`. Документ под паролем нужно заменить доступной копией.
* **Модель отвечает, но делает странные действия.** Смените модель и сравните не только ответ, но и записанные шаги: агент на слабой модели может выполнять лишние действия. На время разбора включите подтверждение действий, выключив **Uninterrupted mode**.

## Что дальше {#chto-dalshe}

* [Каталог моделей RouterAI](/models) — id, контекст и цены.
* [Hermes Agent через RouterAI](/pages/hermes-agent-routerai) и [Goose через RouterAI](/pages/goose-routerai) — другие агенты, которые подключаются к RouterAI по своему ключу.
* [nanobot через RouterAI](/pages/nanobot-routerai) — персональный агент с памятью и мессенджерами.
* [AnythingLLM через RouterAI](/pages/anythingllm-routerai) — если задача ближе к вопросам по своим документам, чем к действиям в системе.
* [Документация Proto](https://proto.erp.ai/docs) и [страница загрузки](https://proto.erp.ai/download).