Нужно ли уметь программировать?
Нет. Установка сводится к запуску контейнера, а вся настройка идёт в обычном веб-интерфейсе: завести модель, создать ключ доступа, посмотреть журнал и расходы. Программы подключаются известным им адресом — для них ничего программировать не нужно. Разве что строка подключения к базе да команда запуска в файле настройки, и то их удобнее один раз скопировать из инструкции по установке.
Чем это отличается от встроенного прокси-сервера Pastukhov Agent?
Это разные вещи, и их легко перепутать по названию. Встроенный прокси-сервер живёт внутри Pastukhov Agent, обслуживает только его и включается в настройках агента — снаружи к нему не подключиться. «Прокси-агент» — самостоятельное приложение на вашем сервере: к нему обращаются все ваши программы сразу, любые модели и любые поставщики, а рядом есть ключи доступа, лимиты, журнал, аналитика, скрытие секретов и прокси для обычного трафика. Подробнее о встроенном — на странице Прокси-сервер, о самостоятельном — в разделе Начало работы.
Какие программы подойдут?
Любые, которые умеют работать с адресом в формате OpenAI или Anthropic: в настройках такой программы вы просто меняете адрес сервера и ключ. Это программистские помощники (в том числе Claude Code), свои скрипты, внутренние сервисы и всё остальное, что обращается к моделям по этим форматам. Программы, вовсе не связанные с ИИ — браузер, менеджер загрузок, любой клиент с поддержкой прокси, — тоже можно пустить через этот же сервер, но уже как обычный трафик. Подробнее — в разделах Подключение программ и Прокси для обычного трафика.
Обязательна ли отдельная база данных?
Да, честно скажем: продукт работает только на PostgreSQL, и это единственная обязательная настройка. Внутри контейнера базы нет — если не указать строку подключения, приложение не запустится. Хорошая новость в том, что отдельный сервер для базы не нужен: она поднимается рядом в том же файле запуска, одной службой. Настройка описана в разделе Установка.
Нужен ли ключ активации?
Да, ключ нужен — скажем об этом прямо. «Прокси-агент» проверяет лицензию: без действующего ключа запросы ваших программ к моделям не проходят, а прокси-служба не пропускает соединения. При этом сам продукт запускается и работает как обычно: вход, настройки, модели, ключи доступа, журналы, аналитика, скрытие секретов и управление по API доступны и без ключа. Ключ задаётся на сервере переменной AGENT_LICENSE и читается при запуске контейнера. Что именно закрыто, как задать ключ и как проверить его состояние — на странице Лицензирование. Цены те же, что у соседних продуктов: персональная —
Как ограничить расходы подрядчика?
Для каждого человека или подрядчика заводится свой ключ доступа. У ключа есть четыре предела расхода — на день, неделю, месяц и всего, — и они задаются в деньгах, а не в «порциях текста» (токенах), поэтому понятны без пересчёта. Как только достигнут первый из них, ключ перестаёт пропускать запросы, а в журнале видно, сколько и на что потрачено. Кроме того, ключу можно разрешить только часть моделей: тогда дорогой моделью через него не воспользуются. Подробнее — в разделах Ключи доступа и Расходы и лимиты.
Сохраняются ли тексты запросов?
Нет, и это сделано намеренно. В журнале остаются только служебные сведения: время, модель, ключ, объём токенов, длительность, стоимость и текст ошибки. Сами запросы и ответы не записываются никогда — переписка нигде не копится, даже у вас. Если по каким-то причинам нужно хранить и содержимое, это придётся делать отдельно от продукта. Подробнее — в разделе Журнал запросов.
Как работает скрытие секретов и безопасно ли это?
Функция выключена по умолчанию — включаете её сами в настройках. Дальше вы заводите правило: имя, образец поиска и список секретов (ключи, пароли, номера документов). Перед отправкой в модель продукт находит в тексте только перечисленные вами значения и заменяет их условными обозначениями; в ответе модели эти обозначения возвращаются на прежние места. Обозначения одни и те же для одного и того же значения, поэтому смысл запроса не теряется. Если проверку выполнить не удалось, запрос вообще не уходит поставщику — продукт выбирает безопасный отказ. События утечек записываются, но сами секреты в них замаскированы. Честная оговорка: соответствия хранятся в томе рабочего состояния; если том не подключён, при пересоздании контейнера уже отправленные обозначения вернуть не удастся. Подробнее — в разделе Скрытие секретов.
Можно ли через него пускать обычный трафик?
Да. Кроме моделей продукт умеет быть обычным прокси-сервером: каждому вашему каналу связи можно задать свой порт, на котором он принимает и HTTP, и SOCKS5, со своей проверкой входа по ключу доступа. По умолчанию не слушает никто — канал начинает принимать соединения только после того, как вы зададите ему порт. Соединения на этом порту выходят в интернет только через этот канал. Важное отличие от трафика моделей: обычный трафик считается в объёме и виден в отдельном журнале, но никогда не считается в деньгах и не расходует пределы ключа. Подробнее — в разделе Прокси для обычного трафика.
Куда уходят данные?
Только туда, куда вы сами их направляете: к выбранным вами поставщикам моделей или через ваши каналы связи. Ключи поставщиков, ключи доступа, журналы, аналитика и правила скрытия секретов лежат на вашем сервере — аккаунт у нас заводить не нужно, в чужое облако ничего не отправляется. Единственное исключение — если вы сами включите отправку статистики в ClickHouse по своему адресу. Стоит держать в голове, что администратор вашего сервера видит настройки и журналы полностью. Подробнее — в разделе Доступ и безопасность.
Не нашли ответ — загляните в документацию или начните с установки.