Начало работы

Портал агент — это корпоративный портал, который собирает и поддерживает ИИ-агент. Вы описываете задачу словами, агент создаёт и правит страницы, а сам портал хранит их обычными файлами под контролем истории версий. Люди контент в браузере не правят: редактора в интерфейсе нет — так исключаются случайные правки и «поехавшая» вёрстка.

Что такое Портал агент

Обычную страницу сайта человек делает руками: открывает редактор, набирает текст, расставляет картинки. Здесь иначе. Страницу целиком собирает управляющий агент — программа с искусственным интеллектом, которой вы говорите, что должно быть на странице. Портал сам хранит результат: каждая страница — это папка с файлом описания и отдельными текстовыми файлами.

Всё содержимое портала лежит обычными файлами в хранилище версий — так называют программу, которая запоминает историю изменений файлов (например, git). Из этого следуют две вещи, важные для бизнеса. У каждой правки есть автор и время, поэтому всегда можно посмотреть, что и когда менялось. И весь портал можно скопировать на другой сервер простым копированием папки — без экспорта, импорта и «переноса базы».

Из чего состоит портал

  • Дерево страниц — слева список всех страниц, справа открытая страница. Это основной экран портала.
  • Блоки — из них собирается страница: текст, картинки, таблицы, карточки, карусели, кнопки. Всего 27 типов.
  • Скрипты на Python — небольшие программы, которые считают цифры и берут данные из ваших систем. Python — это язык программирования, на котором пишут такие расчётные скрипты.
  • Публичный сайт — часть страниц можно открыть наружу по адресу /p/: их увидит любой, без входа в портал.

Кому подходит

  • Внутренние базы знаний — инструкции, онбординг, ответы на частые вопросы сотрудников, которые агент поддерживает в актуальном виде.
  • Справочники и регламенты — правила, договоры, шаблоны документов в одном месте и в едином виде.
  • Страницы с живыми цифрами — остатки на складе, статус сервисов, сводки продаж: данные подтягиваются скриптом, а не вбиваются руками.
  • Публичные разделы для клиентов — новости, каталог услуг, лендинги, которые открыты наружу по адресу /p/.

Первый вход

Откройте адрес портала в браузере. Пока в базе нет ни одного пользователя, форма регистрации показывается сама — первый зарегистрировавшийся становится администратором и получает полный доступ, включая черновики. Второй способ — задать логин и пароль заранее переменными окружения при запуске сервера; в переменной хранится не сам пароль, а его отпечаток (строчная сумма SHA-256). Сессия входа живёт 90 дней, поэтому входить каждую неделю не придётся.

Что видно на экране

В боковом меню портала всего несколько разделов:

  • Главная — сам портал: слева Страницы портала (дерево), справа открытая страница. Именно здесь проводят большую часть времени.
  • Чаты — переписка с ИИ-агентом, который правит портал. Появляется только когда подключён Pastukhov Agent.
  • Настройки — внешний вид (светлая или тёмная тема), язык и размер шрифта. Настройки сохраняются для каждого пользователя отдельно.
  • Лицензия — состояние лицензии. Она нужна только для отправки сообщений агенту, всё остальное работает и без неё.

Первые шаги

  1. Подключите Pastukhov Agent — укажите его адрес и ключ доступа при установке портала. Без этого чат с агентом в интерфейсе не показывается.
  2. Попросите агента создать первую страницу — опишите словами, что на ней должно быть. Агент соберёт страницу из блоков.
  3. Назначьте доступ — новая страница всегда создаётся черновиком. Пока не скажете иначе, её видите только вы.
  4. Отметьте публичные страницы — те, что должны быть видны снаружи на /p/.
  5. Проверьте самое важное глазами — стиль, порядок блоков и живые цифры агент возьмёт на себя, но первый взгляд владельца не заменит ничего.

Чего в интерфейсе нет

В портале нет редактора страниц: ни визуального, ни текстового. Нет и кнопок «изменить» на самих страницах. Это сделано нарочно — контент правит один управляющий агент через отдельный служебный адрес, а не люди в браузере. Благодаря этому страницы всегда в одном стиле, а история правок остаётся чистой: каждое изменение — отдельная запись в истории файлов, а не поток случайных нажатий.

Дальше: как устроено дерево и что видно читателю — в разделе Страницы и дерево; из чего собирается страница — в разделе Блоки; как агент правит контент — в разделе Управление агентом.

← Оглавление документации