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