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

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

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

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

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

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

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

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

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

Первый вход

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

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

Почти весь экран портала — это две части: список страниц слева и открытая страница справа. Остальное — поиск, списки истории и служебные кнопки сверху:

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

Светлая тема включена по умолчанию. Переключить тему и звук, открыть настройки и начать новую беседу можно кнопками в заголовке.

Первые шаги

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

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

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

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

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