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