---
title: "Начало работы"
id: "1974"
type: "page"
slug: "getting-started"
published_at: "2026-09-20T15:42:58+00:00"
modified_at: "2026-09-20T18:29:23+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). Из этого следуют две вещи, важные для бизнеса. У каждой правки есть автор и время, поэтому всегда можно посмотреть, что и когда менялось. И весь портал можно скопировать на другой сервер простым копированием папки — без экспорта, импорта и «переноса базы».

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

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

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

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

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

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

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

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

- **Главная** — сам портал: слева **Страницы портала** (дерево), справа открытая страница. Именно здесь проводят большую часть времени.
- **Чаты** — переписка с ИИ-агентом, который правит портал. Появляется только когда подключён 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)