---
title: "Управление агентом"
id: "1986"
type: "page"
slug: "management"
published_at: "2026-09-20T15:43:09+00:00"
modified_at: "2026-09-21T00:00:47+00:00"
url: "https://pastukhov.com/agents/portal/docs/management"
markdown_url: "https://pastukhov.com/agents/portal/docs/management.md"
excerpt: "Контент портала правит управляющий агент — и делает это через отдельный служебный адрес, а не…"
---

# Управление агентом

[https://pastukhov.com/agents/portal/docs/management.md](https://pastukhov.com/agents/portal/docs/management.md)

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

## Ключ управления

Доступ к управлению открывает ключ. В настройках сервера хранится не сам ключ, а его отпечаток — сумма SHA-256, по которой ключ восстановить нельзя. Агент присылает ключ в служебном заголовке запроса, и портал сверяет отпечатки. Если ключ управления не задан вовсе, управление выключено: все запросы к нему отклоняются. Это значит, что открыть правки может только тот, кому ключ известен.

Отсюда важное правило: ключ управления — такое же секретное значение, как пароль администратора. Его не публикуют и не передают посторонним.

## Что умеет агент

- **Читать и сохранять страницу** — забрать текущее описание, поправить и записать обратно.
- **Переименовать, перенести, скопировать, удалить** — навести порядок в дереве страниц.
- **Записать текстовый файл и загрузить картинку** — добавить тексты блоков и изображения (png, jpg, webp, svg, gif до 10 мегабайт).
- **Проверить структуру** — прогнать страницу через проверки и увидеть ошибки и подсказки (см. [Проверки страниц](/agents/portal/docs/validation) ).
- **Запустить скрипт и поставить библиотеки** — отладить расчётный скрипт и добавить ему то, чего не хватает (см. [Скрипты и зависимости](/agents/portal/docs/scripts) ).
- **Узнать состояние портала** — версию, папку контента, следит ли сервер за файлами, сколько всего страниц и готов ли Python. Это нужно агенту, чтобы понять, с чем он работает, до первой правки.

## Понятные правила и ограничения

- **Свободное имя у копии.** Если копируете страницу, а рядом уже есть папка с таким именем, портал добавит к имени число — `news2`, `news3` — и не перезапишет существующее.
- **Корневую страницу удалить нельзя.** Это главная страница портала и настройки всего сайта; случайно снести её не получится.
- **Конфликты адресов объясняются.** Если перенос задевает существующую страницу или заходит внутрь самого себя, портал отвечает понятным отказом с причиной, а не делает что-то наугад.

## Что сервер делает сам

При сохранении сервер наводит порядок за агента. Крупные тексты блоков он автоматически выносит из описания страницы в отдельные файлы — так описание остаётся коротким, а правки в истории версий — читаемыми. Время изменения и номер версии страницы он проставляет тоже сам. Агенту об этом думать не нужно.

## Как понять, что всё готово

Перед сохранением агент может прогнать страницу через проверки и увидеть, нет ли ошибок. Результат проверки хранится несколько минут, поэтому повторный запрос не пересчитывает всё заново. А состояние портала помогает понять, на месте ли файлы, работает ли слежение за изменениями и готова ли среда для скриптов. Так агент проверяет результат до того, как его увидят читатели.

Дальше: как поговорить с агентом о правке — в разделе [Чат с ИИ-агентом](/agents/portal/docs/agent)
; что именно проверяется у страницы — в разделе [Проверки страниц](/agents/portal/docs/validation)
; как устроена страница на диске — в разделе [Формат документа](/agents/portal/docs/documents)
.

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