--- title: "FAQ Портал-агента" id: "1972" type: "page" slug: "faq" published_at: "2026-09-20T15:37:16+00:00" modified_at: "2026-10-28T18:13:30+00:00" url: "https://pastukhov.com/agents/portal/faq/" markdown_url: "https://pastukhov.com/agents/portal/faq.md" excerpt: "Нет. Страницы собирает агент по вашим словам: вы описываете, что нужно на странице, а он…" --- # FAQ Портал-агента [https://pastukhov.com/agents/portal/faq/.md](https://pastukhov.com/agents/portal/faq/.md) ## Нужно ли уметь программировать? Нет. Страницы собирает агент по вашим словам: вы описываете, что нужно на странице, а он создаёт её из готовых блоков. Программирование понадобится только для динамических блоков, которые считают данные, — и то его берёт на себя агент. От вас нужны только знания о том, какие цифры и откуда вы хотите показывать. ## Кто редактирует страницы портала? Управляющий ИИ-агент. Люди не редактируют контент в браузере: в интерфейсе нет редактора, есть только просмотр страниц и команды агенту. Это сделано намеренно. Контент лежит обычными файлами под контролем git — хранилища версий, — поэтому каждая правка видна, а неудачную всегда можно отменить. Плюс не бывает двух «последних» версий страницы и непонятно чьих изменений. ## Можно ли показать агенту, что именно поправить на странице? Да, и двумя способами. Первый — оставить замечание: выделите неудачный фрагмент, напишите к нему комментарий и нажмите «Комментировать». Второй — сразу отправить задание: то же выделение и ваша просьба уходят агенту отдельной беседой, и он берётся за правку сразу. В обоих случаях не нужно объяснять словами, где что находится, — замечание само помнит выделенный текст. Замечания видит только администратор внутри портала — на публичный сайт они не попадают. Подробнее — в разделе [Комментарии к страницам](/agents/portal/docs/comments) . ## Что происходит, когда читатель отправляет форму агенту или нажимает кнопку-просьбу? Портал заводит агенту отдельную беседу: её первое сообщение — то, что собрала форма или кнопка. Беседа появляется в списке чатов и работает сама по себе — панель чата не открывается, и ждать ничего не нужно: агент берётся за задачу сразу. Если у кнопки или формы заранее заданы последствия, после принятия задания обновятся нужные блоки на странице и откроется указанная страница — рядом или в новой вкладке. Не прошло задание — не происходит ничего, кроме сообщения об ошибке. Подробнее — в разделах [Кнопки и действия](/agents/portal/docs/actions) и [Формы](/agents/portal/docs/forms) . ## Нужен ли Pastukhov Agent? Да, если вы хотите чат и правки словами: агент подключается по адресу и ключу, после чего можно сказать «добавь на главную блок с контактами» — и он это сделает. Без него портал всё равно работает: страницы и дерево видны, публичный сайт открывается, динамические блоки считаются. Скрыт только чат с агентом. Подробнее — в разделе [Чат с ИИ-агентом](/agents/portal/docs/agent) . ## Чем это отличается от WordPress и обычных систем управления сайтом? Контент лежит файлами в git и полностью управляется агентом, а не человеком: в интерфейсе просто нет редактора. Страницы собираются из 28 типов блоков, а часть блоков считает данные скриптами на Python — то есть цифры на странице живые, а не вписаны руками. Готовые системы удобны для правок руками, но требуют, чтобы кто-то эти правки делал. Здесь вы описываете словами, что нужно, — и получаете страницу. Подробнее о продукте для сайта — на странице [WordPress-агент](/agents/wordpress) . ## Где хранятся данные и можно ли всё перенести? На вашем сервере. Служебные данные (база, лицензия, пометки) лежат в постоянном томе `/apps/portal`, а сам контент портала — в отдельной папке `/project/apps/portal`. Контент — обычные файлы: папку можно целиком держать в git и перенести на другой сервер копированием. Никакого экспорта и импорта не нужно, данные не привязаны к программе. Продукт разворачивается на сервере через Pastukhov MultiAgent — в рамках «Фабрики агентов». ## Где хранить ключи и тонкие настройки? В файле `.env` в корне папки проекта — там же, где лежит папка с контентом портала. Туда удобно сложить ключ управления порталом, ключ вашего Pastukhov Agent и всё остальное, что не хочется расписывать в `compose.yml`. В git он не попадает: в нём обычно лежат ключи. Читается файл при запуске и перечитывается на лету: правки применяются за секунду, без перезапуска. Настройки, которые читаются один раз при старте (база данных, адрес и ключ агента, лицензия, бренд), подхватятся после перезапуска. Если агент у людей открывается по другому адресу, чем служебный (например, служебный — внутренний адрес в сети сервера), его задаёт переменная `AGENT_URL`: из неё строятся ссылки, которые попадают в браузер. А свой внешний адрес портала задаёт переменная `PORTAL_APP_URL`. ## Можно ли открыть часть портала наружу? Да. Страница с доступом «публичная» открывается для всех по адресу `/p/`, а меню публичного сайта собирается из опубликованных страниц — с порядком и глубиной, которые вы зададите. Черновики и внутренние страницы снаружи выглядят точно так же, как несуществующие: никто даже не догадается, что они есть. Подробнее — в разделах [Доступ к страницам](/agents/portal/docs/access) и [Публичный сайт](/agents/portal/docs/public-site) . ## Безопасны ли скрипты динамических блоков? Скрипты — такая же часть контента, как текст страницы, и пишет их управляющий агент, которому вы доверяете. Выполняются они прямо на сервере, в отдельном окружении Python: без запуска системной оболочки, с ограничением по времени (обычно до минуты для наполнения страницы и до двух минут для действия) и не более четырёх одновременно. Отдельной изолированной «песочницы» при этом нет: скрипт работает с правами приложения, поэтому доверие к тому, кто правит файлы, здесь так же важно, как и с любым другим кодом. ## Не будет ли портал тормозить? Сами страницы читаются из файлов, поэтому открываются быстро. Результаты скриптов можно временно сохранять: срок задаётся в настройках блока, и тогда повторный просмотр берёт готовый результат, не дёргая ваши системы заново. По умолчанию скрипт считается при каждом открытии — это удобно для свежих цифр, а для тяжёлых расчётов достаточно указать срок хранения в несколько минут. Подробнее — в разделах [Динамические блоки на Python](/agents/portal/docs/python) и [Графики](/agents/portal/docs/charts) . ## Откуда портал берёт цифры для сводок? Двумя путями. Если цифры уже лежат в вашей базе (PostgreSQL, ClickHouse или SQLite), достаточно описать в странице, что именно взять, — и портал сам обратится к базе при каждом просмотре. Если данные нужно сначала собрать или посчитать, агент пишет небольшой скрипт на Python. Показать результат можно 33 способами: от одной цифры и шкалы до карты регионов. Подробнее — в разделах [Источники данных и визуализации](/agents/portal/docs/sources) и [Динамические блоки на Python](/agents/portal/docs/python) . ## Сколько стоит и что даёт лицензия? Лицензия входит в подписку [«Фабрика агентов»](/agents/factory) , а на пробный период есть бесплатный ключ. Она нужна только для отправки сообщений в чат с ИИ-агентом: дерево и страницы, блоки, динамические блоки, формы, публичный сайт и правки контента агентом работают и без неё.