---
title: "Начало работы"
id: "1974"
type: "page"
slug: "getting-started"
published_at: "2026-09-20T15:42:58+00:00"
modified_at: "2026-10-28T18:13:30+00:00"
url: "https://pastukhov.com/agents/portal/docs/getting-started/"
markdown_url: "https://pastukhov.com/agents/portal/docs/getting-started.md"
excerpt: "Портал-агент — это корпоративный портал, который собирает и поддерживает ИИ-агент. Вы описываете задачу словами, агент…"
---

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

[https://pastukhov.com/agents/portal/docs/getting-started/.md](https://pastukhov.com/agents/portal/docs/getting-started/.md)

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

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

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

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

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

- **Дерево страниц** — слева список всех страниц, справа открытая страница. Это основной экран портала.
- **Блоки** — из них собирается страница: текст, картинки, таблицы, карточки, карусели, кнопки. Всего 28 типов.
- **Скрипты на Python** — небольшие программы, которые считают цифры и берут данные из ваших систем. Python — это язык программирования, на котором пишут такие расчётные скрипты.
- **Данные и визуализации** — если у вас есть база, сводку на странице можно построить из неё — без программы, одним описанием запроса. Показать результат можно 33 способами: от одной цифры и шкалы до карты регионов (см. [Источники данных и визуализации](/agents/portal/docs/sources) ).
- **Публичный сайт** — часть страниц можно открыть наружу по адресу `/p/`: их увидит любой, без входа в портал.

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

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

## Первый вход

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

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

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

- **Список страниц** — слева дерево портала с поиском по содержимому и переключателем списков (недавно просмотренные, обновлённые, созданные). Его ширину можно менять, а сам список — свернуть.
- **Открытая страница** — справа содержимое выбранной страницы. Именно здесь проводят большую часть времени.
- **Замечания к странице** — под содержимым может быть нить комментариев: администратор выделяет на странице текст и оставляет, что поправить, а агент разбирает эти замечания. Тем же выделением можно сразу отправить агенту задание отдельной беседой. Видна только администратору внутри портала (см. [Комментарии к страницам](/agents/portal/docs/comments) ).
- **Панель чата** — выезжает сбоку по кнопке **Новый чат** в заголовке: это переписка с ИИ-агентом, который правит портал. Появляется только когда подключён Pastukhov Agent.
- **Настройки** — шестерёнка в заголовке: оформление (тема, язык, размер шрифта) и выход. Настройки сохраняются для каждого пользователя отдельно.
- **Лицензия** — состояние лицензии показано строкой внизу настроек. Она нужна только для отправки сообщений агенту, всё остальное работает и без неё.
- **Кнопки «Коммит» и «Отмена»** — появляются в заголовке, когда подключён агент и в его рабочей папке есть несохранённые изменения. **Коммит** записывает работу агента в историю версий, **Отмена** сначала спрашивает и затем необратимо откатывает все незафиксированные изменения.

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

## Первые шаги

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

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

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

Дальше: как устроено дерево и что видно читателю — в разделе [Страницы и дерево](/agents/portal/docs/pages)
; из чего собирается страница — в разделе [Блоки](/agents/portal/docs/blocks)
; как агент правит контент — в разделе [Управление агентом](/agents/portal/docs/management)
.

[← Оглавление документации](/agents/portal/docs)