Комментарии к страницам

Страницы портала правят словами — через чат с агентом. Но иногда удобнее не описывать правку в чате, а показать её прямо на странице: выделить неудачную фразу и оставить к ней замечание. Для этого у страниц портала есть комментарии — короткая просьба, привязанная к месту страницы.

Зачем это нужно

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

Так из замечаний собирается простая очередь работы: администратор оставляет, что поправить, а агент по этим замечаниям правит страницу. Пока замечание не разобрано, оно висит на странице и не теряется.

Как оставить замечание

Выделите мышью нужный текст на открытой странице — прямо внутри блоков. Как только выделение готово, внизу страницы появляется полоса с пометкой Выделенный текст и полем ввода. Оно устроено как поле ввода в чате: слева выбираются модель и навык, справа — две кнопки. В полосе видно, какой отрывок вы выбрали, — он и станет зацепкой для агента. Длинный отрывок можно раскрыть целиком нажатием на него.

  • Комментировать — оранжевая кнопка слева. Оставляет замечание: оно попадёт в нить комментариев внизу страницы, и агент разберёт его при следующем заходе.
  • Отправить — кнопка справа. Если понятно, что именно поправить, портал сразу заводит отдельную беседу с агентом: в неё уходят и выделенный отрывок, и ваша просьба, а сама беседа появляется в списке чатов. Панель чата при этом не открывается — страница остаётся перед вами.
  • Выбор модели и навыка здесь и в панели чата общий: что выбрали в одном месте, то и применится в другом. Без подключённого агента остаётся только кнопка «Комментировать».
  • Enter отправляет, Shift+Enter переносит строку, Escape закрывает полосу, ничего не сохраняя.
  • Если отправка не удалась, текст и выделение остаются на месте — можно попробовать снова, ничего не набирая заново. Под полем появится объяснение ошибки.

Оставить комментарий можно к нескольким блокам сразу — важно только то, что выделение начинается и заканчивается внутри блоков страницы. Выделение в заголовке окна или в дереве слева комментарием не становится.

Нить комментариев внизу страницы

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

  • Автор — у замечания от человека стоит пометка Администратор, у ответа агента — Агент (такой ответ появляется, только если вы прямо попросили агента написать его).
  • Время — когда комментарий написан. Если его потом правили, рядом появляется пометка Изменён.

Правка и удаление

У любого комментария при наведении появляются два действия: Изменить — правит текст на месте, и Удалить — убирает комментарий после подтверждения. Так можно дописать уточнение к своему замечанию или убрать то, что потеряло смысл.

Кому это видно

Комментарии — внутренний рабочий инструмент. Их видят только администраторы и только внутри самого портала: сотрудникам после входа и посетителям публичного сайта ни нить комментариев, ни поле для нового замечания не показываются вовсе. Наружу замечания не уходят — публичный сайт остаётся прежним.

Только у обычных страниц

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

Обновление на лету

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

Как это работает с агентом

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

Когда правка сделана, агент убирает разобранное замечание — нить комментариев работает как очередь на разбор, а не как журнал. Свой ответ агент оставляет не здесь, а в чате: комментарии — это канал просьб в одну сторону, и писать в них что-то от себя агент не станет. Комментарий от агента появится только в одном случае — если вы прямо попросите его ответить.

Где лежат комментарии

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

Дальше: как устроена страница на диске — в разделе Формат документа; как поговорить с агентом о правке — в разделе Чат с ИИ-агентом; чем управляет агент через служебный адрес — в разделе Управление агентом.

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