Нужно ли уметь программировать?
Нет. Страницы собирает агент по вашим словам: вы описываете, что нужно на странице, а он создаёт её из готовых блоков. Программирование понадобится только для динамических блоков, которые считают данные, — и то его берёт на себя агент. От вас нужны только знания о том, какие цифры и откуда вы хотите показывать.
Кто редактирует страницы портала?
Управляющий ИИ-агент. Люди не редактируют контент в браузере: в интерфейсе нет редактора, есть только просмотр страниц и команды агенту. Это сделано намеренно. Контент лежит обычными файлами под контролем git — хранилища версий, — поэтому каждая правка видна, а неудачную всегда можно отменить. Плюс не бывает двух «последних» версий страницы и непонятно чьих изменений.
Можно ли показать агенту, что именно поправить на странице?
Да, и двумя способами. Первый — оставить замечание: выделите неудачный фрагмент, напишите к нему комментарий и нажмите «Комментировать». Второй — сразу отправить задание: то же выделение и ваша просьба уходят агенту отдельной беседой, и он берётся за правку сразу. В обоих случаях не нужно объяснять словами, где что находится, — замечание само помнит выделенный текст. Замечания видит только администратор внутри портала — на публичный сайт они не попадают. Подробнее — в разделе Комментарии к страницам.
Что происходит, когда читатель отправляет форму агенту или нажимает кнопку-просьбу?
Портал заводит агенту отдельную беседу: её первое сообщение — то, что собрала форма или кнопка. Беседа появляется в списке чатов и работает сама по себе — панель чата не открывается, и ждать ничего не нужно: агент берётся за задачу сразу. Если у кнопки или формы заранее заданы последствия, после принятия задания обновятся нужные блоки на странице и откроется указанная страница — рядом или в новой вкладке. Не прошло задание — не происходит ничего, кроме сообщения об ошибке. Подробнее — в разделах Кнопки и действия и Формы.
Нужен ли Pastukhov Agent?
Да, если вы хотите чат и правки словами: агент подключается по адресу и ключу, после чего можно сказать «добавь на главную блок с контактами» — и он это сделает. Без него портал всё равно работает: страницы и дерево видны, публичный сайт открывается, динамические блоки считаются. Скрыт только чат с агентом. Подробнее — в разделе Чат с ИИ-агентом.
Чем это отличается от WordPress и обычных систем управления сайтом?
Контент лежит файлами в git и полностью управляется агентом, а не человеком: в интерфейсе просто нет редактора. Страницы собираются из 28 типов блоков, а часть блоков считает данные скриптами на Python — то есть цифры на странице живые, а не вписаны руками. Готовые системы удобны для правок руками, но требуют, чтобы кто-то эти правки делал. Здесь вы описываете словами, что нужно, — и получаете страницу. Подробнее о продукте для сайта — на странице WordPress-агент.
Где хранятся данные и можно ли всё перенести?
На вашем сервере. Служебные данные (база, лицензия, пометки) лежат в постоянном томе /apps/portal, а сам контент портала — в отдельной папке /project/apps/portal. Контент — обычные файлы: папку можно целиком держать в git и перенести на другой сервер копированием. Никакого экспорта и импорта не нужно, данные не привязаны к программе. Продукт разворачивается на сервере через Pastukhov MultiAgent — в рамках «Фабрики агентов».
Где хранить ключи и тонкие настройки?
В файле .env в корне папки проекта — там же, где лежит папка с контентом портала. Туда удобно сложить ключ управления порталом, ключ вашего Pastukhov Agent и всё остальное, что не хочется расписывать в compose.yml. В git он не попадает: в нём обычно лежат ключи. Читается файл при запуске и перечитывается на лету: правки применяются за секунду, без перезапуска. Настройки, которые читаются один раз при старте (база данных, адрес и ключ агента, лицензия, бренд), подхватятся после перезапуска. Если агент у людей открывается по другому адресу, чем служебный (например, служебный — внутренний адрес в сети сервера), его задаёт переменная AGENT_URL: из неё строятся ссылки, которые попадают в браузер. А свой внешний адрес портала задаёт переменная PORTAL_APP_URL.
Можно ли открыть часть портала наружу?
Да. Страница с доступом «публичная» открывается для всех по адресу /p/, а меню публичного сайта собирается из опубликованных страниц — с порядком и глубиной, которые вы зададите. Черновики и внутренние страницы снаружи выглядят точно так же, как несуществующие: никто даже не догадается, что они есть. Подробнее — в разделах Доступ к страницам и Публичный сайт.
Безопасны ли скрипты динамических блоков?
Скрипты — такая же часть контента, как текст страницы, и пишет их управляющий агент, которому вы доверяете. Выполняются они прямо на сервере, в отдельном окружении Python: без запуска системной оболочки, с ограничением по времени (обычно до минуты для наполнения страницы и до двух минут для действия) и не более четырёх одновременно. Отдельной изолированной «песочницы» при этом нет: скрипт работает с правами приложения, поэтому доверие к тому, кто правит файлы, здесь так же важно, как и с любым другим кодом.
Не будет ли портал тормозить?
Сами страницы читаются из файлов, поэтому открываются быстро. Результаты скриптов можно временно сохранять: срок задаётся в настройках блока, и тогда повторный просмотр берёт готовый результат, не дёргая ваши системы заново. По умолчанию скрипт считается при каждом открытии — это удобно для свежих цифр, а для тяжёлых расчётов достаточно указать срок хранения в несколько минут. Подробнее — в разделах Динамические блоки на Python и Графики.
Откуда портал берёт цифры для сводок?
Двумя путями. Если цифры уже лежат в вашей базе (PostgreSQL, ClickHouse или SQLite), достаточно описать в странице, что именно взять, — и портал сам обратится к базе при каждом просмотре. Если данные нужно сначала собрать или посчитать, агент пишет небольшой скрипт на Python. Показать результат можно 33 способами: от одной цифры и шкалы до карты регионов. Подробнее — в разделах Источники данных и визуализации и Динамические блоки на Python.
Сколько стоит и что даёт лицензия?
Лицензия входит в подписку «Фабрика агентов», а на пробный период есть бесплатный ключ. Она нужна только для отправки сообщений в чат с ИИ-агентом: дерево и страницы, блоки, динамические блоки, формы, публичный сайт и правки контента агентом работают и без неё.