Pastukhov Agent — это личный ИИ-помощник, который работает над вашим проектом на компьютере или сервере: читает и изменяет файлы, выполняет команды, следит за качеством кода и ведёт с вами обычный чат. Он пригодится и разработчику, и владельцу бизнеса, который хочет самостоятельно вносить изменения в свой проект. Эта страница — с чего начать.
Pastukhov Agent разворачивается на вашем сервере или компьютере через Pastukhov MultiAgent — в рамках «Фабрики агентов». Отдельно ставить ничего не нужно: MultiAgent сам подготовит окружение и запустит приложение.
Агент работает в изолированной среде и видит только папку вашего проекта — остальная система ему недоступна. Дальше остаётся настроить модель и указать API-ключ вашего поставщика ИИ — об этом в разделе Настройка первой модели ниже.
Настройка учётных данных
Учётные данные — это ваш логин и пароль для входа в приложение, как в личный кабинет. Они задаются переменными окружения AGENT_LOGIN (логин) и AGENT_PASSWORD (пароль). Переменные окружения — это технические параметры запуска: вы прописываете их один раз в настройках, и программа применяет их автоматически при каждом запуске.
Если переменные не заданы, приложение само сгенерирует временный пароль (логин — agent) и выведет его в консоль — окно, где работает программа. Такие учётные данные действуют до перезапуска приложения — удобно, чтобы просто попробовать программу. Полный список переменных — на странице Модели.
Пароль и его отпечаток
Пароль хранится не как есть, а в виде SHA256-хэша — «отпечатка», по которому нельзя восстановить исходный текст: даже если файл настроек попадёт не в те руки, пароль останется в безопасности. Готовый отпечаток выдаёт встроенный генератор прямо на странице входа — его и указывают в значении AGENT_PASSWORD.
Когда вы входите с временными учётными данными, на странице входа появляется предупреждение. Чтобы сделать их постоянными, задайте переменные окружения и перезапустите приложение.
После входа вы получаете JWT-токен — «цифровой пропуск»: он поддерживает вашу сессию 90 дней, так что повторно входить каждый раз не придётся.
По умолчанию ключ подписи токенов генерируется автоматически и хранится во временной папке системы — для обычной работы этого достаточно. Для постоянного ключа задайте переменную JWT_SECRET_KEY (не менее 32 символов): тогда выданные «пропуски» останутся действительными между перезапусками приложения.
Другие способы доступа — единый вход через сервер (SSO), вход по API-ключу и живые подключения — описаны на странице Вход и авторизация.
Главный интерфейс
После входа вы видите список чатов — главный экран, с которого начинается работа:
- Список чатов — здесь собраны все ваши разговоры. У каждого чата — заголовок и время последнего обновления. Если чатов ещё нет, вас встретит заметная кнопка Новый чат.
- Новый чат — каждая беседа независима и не делится контекстом с другими, поэтому можно работать над несколькими задачами одновременно и нигде не запутаться.
- Обновления в реальном времени — список чатов обновляется сам, через технологию SignalR: новые чаты и прогресс работы появляются на экране сразу, страницу перезагружать не нужно.
Список чатов запоминается браузером локально, поэтому при повторных визитах открывается мгновенно. Если он рассинхронизировался с базой данных — например, после удаления чатов из другого браузера, — нажмите кнопку обновления рядом с полем поиска чатов.
Нажмите на любой чат, чтобы открыть его. Внутри — общение с агентом; подробно об интерфейсе чата — в документации Чат.
Демо-проект
В поставку входит готовый демо-проект: на нём удобно посмотреть, как агент разрабатывает, собирает, проверяет и исправляет код. При первом запуске приложения вы увидите именно его.
Для своего проекта укажите путь к нему переменной окружения AGENT_PROJECT_PATH. Pastukhov Agent работает с любой кодовой базой — просто укажите папку проекта и начинайте чат.
Демо-проект включает демо-навыки — готовые инструкции для агента, как выполнять типовые задачи. Они полезны сами по себе и служат шаблонами для ваших собственных навыков. Подробнее — в документации Навыки.
Pastukhov Agent работает в режиме одного проекта: один экземпляр — один проект. Экземпляры полностью изолированы, поэтому можно запускать несколько одновременно — на разных портах и для разных проектов.
Настройка первой модели
Прежде чем начать чат, нужно создать модель — набор настроек, который говорит агенту, какую нейросеть использовать и как к ней подключиться. Минимально — указать API-ключ: это секретный ключ доступа к нейросети, который выдаёт поставщик ИИ (компания, предоставляющая нейросети, — Anthropic, z.ai, OpenRouter и другие).
Быстрый способ: пока моделей нет, в области ввода сообщений появляется ссылка «создать модель» — диалог настройки откроется прямо там, где нужно, отдельно переходить на страницу «Модели» не обязательно.
Как создать первую модель:
- Нажмите Новая модель — на странице Модели в главном меню или по ссылке «создать модель» в области ввода сообщений
- Выберите поставщика ИИ из встроенного списка — Anthropic, z.ai, OpenRouter, xAI Grok, MiniMax, Kimi или «Своё»
- Выберите вариант модели (например, Claude Sonnet 4.6 или Claude Opus 4.7 для Anthropic) — модели отличаются качеством, скоростью и ценой
- Введите ваш API-ключ — все остальные параметры (название модели, адрес поставщика, цены) подставятся автоматически
Если вашего поставщика или модели нет в списке, возьмите любой существующий шаблон и поправьте параметры после создания, либо добавьте поставщика в файл .pastukhov/providers.yml проекта. Можно также связаться с нами — добавим его во встроенный список.
Какой поставщик выбрать: для интенсивной разработки (крупные программные продукты) удобнее всего z.ai (модели GLM) — там есть планы под активную работу. Для всего остального — включая повседневную работу с готовыми продуктами — оптимален DeepSeek с оплатой за фактические токены (доступен через шаблон OpenRouter). Если вы планируете и разрабатывать, и пользоваться готовым продуктом, заведите обе модели и переключайтесь под задачу.
После создания модели выберите её в селекторе моделей — выпадающий список рядом с полем ввода (он появляется, когда создана хотя бы одна модель). Можно создать несколько моделей для разных поставщиков и переключаться между ними в любой момент. Подробнее — в документации Модели.
Отправка первого сообщения
Начать разговор просто:
- Создайте чат — в списке чатов нажмите Новый чат.
- Введите сообщение — в поле ввода напишите вопрос или опишите задачу обычными словами. Поле поддерживает многострочный текст.
- Отправьте — нажмите Enter или кнопку отправки. Shift+Enter добавляет перенос строки без отправки.
- Следите за ответом — ответ появляется в реальном времени. Если агент читает файлы или выполняет действия, вы увидите это прямо в чате.
Совет: будьте конкретны. Вместо «Исправь баг» напишите «Форма входа не отправляется при нажатии кнопки. Помоги найти проблему». Чем больше контекста — тем точнее помощь.
Пока агент работает, заголовок страницы показывает текущую статистику: затраченное время, скорость обработки (токенов в секунду — токены это «единицы текста», за которые вы платите поставщику) и стоимость на текущий момент. Рядом появляется кнопка остановки — нажмите, чтобы прервать запрос в любой момент.
Нажмите на любое сообщение, чтобы увидеть его детали — какие файлы были прочитаны или изменены. Для правок показывается diff — наглядное сравнение «было/стало»: добавленные строки зелёным, удалённые красным. Наведите курсор на сообщение, чтобы увидеть статистику (время обработки, токены, стоимость) и кнопки: копировать сообщение или продолжить разговор с этого места — удобно для возобновления остановленного чата.
Все возможности чата — типы сообщений, выбор навыка, переключение моделей, очередь сообщений — описаны в документации Чат.
Работа с несколькими чатами
Каждый чат — самостоятельный разговор со своим контекстом: один можно посвятить отладке функции, другой — планированию нового проекта, третий — изучению части кода. Вот как этим пользоваться:
- Создание чатов — нажмите Новый чат в списке чатов. После первого сообщения агент сам придумает чату понятный заголовок.
- Переключение между чатами — вернитесь к списку чатов и выберите нужный. Каждый чат помнит весь разговор, поэтому вы продолжите ровно с того места, где остановились.
Рекомендация: заводите отдельный чат под каждую задачу или тему — так разговоры остаются сфокусированными, а нужную информацию легко найти. Например, один чат — «Обновление формы заказа», другой — «Настройка уведомлений по почте».
Что дальше?
Теперь, когда вы знакомы с основами, можно углубиться в возможности агента:
- Чат — типы сообщений, выбор навыка, переключение моделей, очередь сообщений и плавающая панель задач. Читать о чате
- Модели — несколько поставщиков ИИ, управление API-ключами, переключение между конфигурациями. Читать о моделях
- Файлы и проекты — как агент читает, редактирует и управляет файлами вашего проекта. Читать о файлах и проектах
- Сборка и развёртывание — автоматические проверки качества, управление запуском приложения. Читать о сборке и развёртывании
- Навыки — использование, создание и управление навыками, расширяющими возможности агента. Читать о навыках
- Настройки — карточный хаб: оформление, чат и звук, автоматизация, инструменты и конфигурация. Читать о настройках
Назад: Документация | Далее: Чат