--- title: "Комментарии к страницам" id: "2340" type: "page" slug: "comments" published_at: "2026-10-14T20:40:21+00:00" modified_at: "2026-10-28T18:13:31+00:00" url: "https://pastukhov.com/agents/portal/docs/comments/" markdown_url: "https://pastukhov.com/agents/portal/docs/comments.md" excerpt: "Страницы портала правят словами — через чат с агентом. Но иногда удобнее не описывать правку…" --- # Комментарии к страницам [https://pastukhov.com/agents/portal/docs/comments/.md](https://pastukhov.com/agents/portal/docs/comments/.md) Страницы портала правят словами — через чат с агентом. Но иногда удобнее не описывать правку в чате, а показать её прямо на странице: выделить неудачную фразу и оставить к ней замечание. Для этого у страниц портала есть комментарии — короткая просьба, привязанная к месту страницы. ## Зачем это нужно Обычно правка начинается с чата: вы описываете, что поменять, и агент берётся за работу. Но когда замечание касается конкретного места на странице — «вот эта цифра устарела», «сократите этот абзац» — проще ткнуть в него, чем объяснять словами, где оно находится. Комментарий запоминает и сам выделенный отрывок, и место, где он был, поэтому агенту не приходится ничего искать. Так из замечаний собирается простая очередь работы: администратор оставляет, что поправить, а агент по этим замечаниям правит страницу. Пока замечание не разобрано, оно висит на странице и не теряется. ## Как оставить замечание Выделите мышью нужный текст на открытой странице — прямо внутри блоков. Как только выделение готово, внизу страницы появляется полоса с пометкой **Выделенный текст** и полем ввода. Оно устроено как поле ввода в чате: слева выбираются модель и навык, справа — две кнопки. В полосе видно, какой отрывок вы выбрали, — он и станет зацепкой для агента. Длинный отрывок можно раскрыть целиком нажатием на него. - **Комментировать** — оранжевая кнопка слева. Оставляет замечание: оно попадёт в нить комментариев внизу страницы, и агент разберёт его при следующем заходе. - **Отправить** — кнопка справа. Если понятно, что именно поправить, портал сразу заводит отдельную беседу с агентом: в неё уходят и выделенный отрывок, и ваша просьба, а сама беседа появляется в списке чатов. Панель чата при этом не открывается — страница остаётся перед вами. - **Выбор модели и навыка здесь и в панели чата общий**: что выбрали в одном месте, то и применится в другом. Без подключённого агента остаётся только кнопка «Комментировать». - **Enter отправляет, Shift+Enter переносит строку, Escape закрывает** полосу, ничего не сохраняя. - **Если отправка не удалась**, текст и выделение остаются на месте — можно попробовать снова, ничего не набирая заново. Под полем появится объяснение ошибки. Оставить комментарий можно к нескольким блокам сразу — важно только то, что выделение начинается и заканчивается внутри блоков страницы. Выделение в заголовке окна или в дереве слева комментарием не становится. ## Нить комментариев внизу страницы Все комментарии страницы собраны внизу, под содержимым, в разделе **Комментарии** — рядом видно их число. Порядок простой: сначала старые, потом новые. Каждый комментарий показан так, как к нему удобнее возвращаться: сначала идёт выделенный отрывок страницы, а под ним — сам комментарий. - **Автор** — у замечания от человека стоит пометка **Администратор**, у ответа агента — **Агент** (такой ответ появляется, только если вы прямо попросили агента написать его). - **Время** — когда комментарий написан. Если его потом правили, рядом появляется пометка **Изменён**. ## Правка и удаление У любого комментария при наведении появляются два действия: **Изменить** — правит текст на месте, и **Удалить** — убирает комментарий после подтверждения. Так можно дописать уточнение к своему замечанию или убрать то, что потеряло смысл. ## Кому это видно Комментарии — внутренний рабочий инструмент. Их видят только администраторы и только внутри самого портала: сотрудникам после входа и посетителям публичного сайта ни нить комментариев, ни поле для нового замечания не показываются вовсе. Наружу замечания не уходят — публичный сайт остаётся прежним. ## Только у обычных страниц Комментарии есть только у обычных страниц. У страницы-образца, которая обслуживает сразу много адресов, своей папки нет — общий образец делили бы все адреса, и замечания перемешались бы. Поэтому у таких страниц комментариев не бывает, а попытка оставить замечание вежливо отклоняется. ## Обновление на лету Новое замечание появляется на открытой странице само, без перезагрузки — и у того, кто его оставил, и у всех остальных администраторов, у кого эта страница открыта. При этом комментарии не считаются правкой содержимого: страница не помечается непрочитанной, дерево и поиск не пересчитываются. Замечание — это разговор, а не изменение текста. ## Как это работает с агентом Замечания администратора — это задания для управляющего агента. Прочитав комментарий, агент относится к выделенному отрывку как к указанию: правит страницу так, как просят, глядя ровно на то место, о котором речь. Удобный порядок работы: оставили замечания по странице, отправили агенту задачу «разбери комментарии» — и вернулись к чистой странице. А если правку можно описать сразу, то и замечание заводить не обязательно: хватит кнопки «Отправить» в полосе выделения — портал сам заведёт беседу с агентом. Когда правка сделана, агент убирает разобранное замечание — нить комментариев работает как очередь на разбор, а не как журнал. Свой ответ агент оставляет не здесь, а в чате: комментарии — это канал просьб в одну сторону, и писать в них что-то от себя агент не станет. Комментарий от агента появится только в одном случае — если вы прямо попросите его ответить. ## Где лежат комментарии Как и всё в портале, комментарии хранятся обычным файлом: рядом с описанием страницы лежит файл с замечаниями. Это значит, что историю замечаний видно в истории версий, а агент работает с ними как с файлами — читает и убирает разобранное, а отвечает в чате. Если файл случайно испортили, страница от этого не пострадает: комментариев просто не будет видно, пока файл не поправят. Когда удаляют последний комментарий, файл исчезает сам. Дальше: как устроена страница на диске — в разделе [Формат документа](/agents/portal/docs/documents) ; как поговорить с агентом о правке — в разделе [Чат с ИИ-агентом](/agents/portal/docs/agent) ; чем управляет агент через служебный адрес — в разделе [Управление агентом](/agents/portal/docs/management) . [← Оглавление документации](/agents/portal/docs)