Контент портала правит управляющий агент — и делает это через отдельный служебный адрес, а не через браузер. В интерфейсе портала редактора нет вообще: ни кнопки «изменить», ни текстового поля. Такой порядок выбран ради чистоты: каждое изменение проходит через одно место, а история правок остаётся понятной.
Ключ управления
Доступ к управлению открывает ключ. В настройках сервера хранится не сам ключ, а его отпечаток — сумма SHA-256, по которой ключ восстановить нельзя. Агент присылает ключ в служебном заголовке запроса, и портал сверяет отпечатки. Если ключ управления не задан вовсе, управление выключено: все запросы к нему отклоняются. Это значит, что открыть правки может только тот, кому ключ известен.
Отсюда важное правило: ключ управления — такое же секретное значение, как пароль администратора. Его не публикуют и не передают посторонним.
Что умеет агент
- Читать и сохранять страницу — забрать текущее описание, поправить и записать обратно.
- Переименовать, перенести, скопировать, удалить — навести порядок в дереве страниц.
- Записать текстовый файл и загрузить картинку — добавить тексты блоков и изображения (png, jpg, webp, svg, gif до 10 мегабайт).
- Проверить структуру — прогнать страницу через проверки и увидеть ошибки и подсказки (см. Проверки страниц).
- Запустить скрипт и поставить библиотеки — отладить расчётный скрипт и добавить ему то, чего не хватает (см. Скрипты и зависимости).
- Узнать состояние портала — версию, папку контента, следит ли сервер за файлами, сколько всего страниц и готов ли Python. Это нужно агенту, чтобы понять, с чем он работает, до первой правки.
Понятные правила и ограничения
- Свободное имя у копии. Если копируете страницу, а рядом уже есть папка с таким именем, портал добавит к имени число —
news2,news3— и не перезапишет существующее. - Корневую страницу удалить нельзя. Это главная страница портала и настройки всего сайта; случайно снести её не получится.
- Конфликты адресов объясняются. Если перенос задевает существующую страницу или заходит внутрь самого себя, портал отвечает понятным отказом с причиной, а не делает что-то наугад.
Что сервер делает сам
При сохранении сервер наводит порядок за агента. Крупные тексты блоков он автоматически выносит из описания страницы в отдельные файлы — так описание остаётся коротким, а правки в истории версий — читаемыми. Время изменения и номер версии страницы он проставляет тоже сам. Агенту об этом думать не нужно.
Как понять, что всё готово
Перед сохранением агент может прогнать страницу через проверки и увидеть, нет ли ошибок. Результат проверки хранится несколько минут, поэтому повторный запрос не пересчитывает всё заново. А состояние портала помогает понять, на месте ли файлы, работает ли слежение за изменениями и готова ли среда для скриптов. Так агент проверяет результат до того, как его увидят читатели.
Дальше: как поговорить с агентом о правке — в разделе Чат с ИИ-агентом; что именно проверяется у страницы — в разделе Проверки страниц; как устроена страница на диске — в разделе Формат документа.