Портал собирает и правит агент, а общаться с ним удобнее всего словами. Для этого в портале есть чат: вы описываете, что нужно сделать, и агент берётся за работу. Чат открывается панелью сбоку — кнопкой Новый чат в заголовке. Если в этот момент у вас открыта страница портала, в поле ввода сразу подставится, о какой странице речь, и останется только дописать, что поменять. Чат подключается к внешнему Pastukhov Agent — тому же, которым вы пользуетесь для других задач.
Подключение
Чат работает, когда для портала указаны адрес вашего Pastukhov Agent и ключ доступа к нему (эти значения задаются в настройках продукта). Если они не заданы, панель чата и кнопки правки просто не появляются — так портал не показывает кнопки, которые никуда не ведут. Подробнее — в разделе Управление агентом.
Что умеет агент
- Создать страницу — по описанию словами собрать новую страницу из блоков.
- Переделать страницу — изменить текст, порядок блоков, оформление и доступ.
- Поправить отдельный блок — заменить картинку, обновить таблицу, добавить кнопку.
- Написать или починить скрипт — сделать расчёт для живых цифр и отладить его, если что-то не сработало.
Правки прямо со страницы
Не обязательно начинать с чата: попросить правку можно прямо с той страницы, которую смотрите. У заголовка страницы и у каждого блока при наведении есть кнопка Изменить с помощью агента. Она открывает панель чата и подставляет в поле ввода, о какой странице или блоке речь, — текст не отправляется, пока вы не допишете, что нужно поменять. Для страницы запрос касается всей страницы, для блока — только выбранного блока.
В запрос портал сам добавляет нужный контекст: путь к странице портала и пометку блока. Благодаря этому агент понимает, о какой именно странице речь, и не переспрашивает.
Замечания прямо на странице
Есть и другой способ попросить правку — прямо на странице. Выделите неудачный фрагмент, и внизу появится поле ввода с теми же возможностями, что и в панели чата. Дальше — два пути: оставить замечание кнопкой Комментировать или сразу отправить задание кнопкой Отправить — тогда портал заведёт отдельную беседу с агентом, и в неё уйдут и выделенный текст, и ваша просьба.
В обоих случаях не нужно объяснять словами, где что находится: замечание само помнит выделенный текст, и агент правит ровно это место. Разобранное замечание он убирает — нить комментариев работает как очередь на разбор, а не как журнал. Подробнее — в разделе Комментарии к страницам.
Исправление проблем
Если страница или блок сломались, рядом с сообщением о проблеме есть кнопка Исправить с помощью агента. Нажатие отправляет агенту описание проблемы и контекст страницы, и он берётся за починку. Вам не нужно разбираться в причинах — достаточно нажать кнопку и описать, что вы хотели видеть.
Рекомендация
Иногда агент оставляет на странице одну ненавязчивую карточку Рекомендация — что было бы полезно добавить или поправить, и почему. Это не ошибка, а подсказка. Карточку можно скрыть кнопкой ✕: пока страницу не тронут, она больше не появится. Как только агент снова изменит страницу, рекомендация может вернуться — материал ведь обновился.
Как идёт работа
Пока агент трудится, в панели чата видно Агент работает…. Если задаче нужны уточнения, агент задаёт вопросы — на них отвечают карточками прямо в переписке. Вся история разговора сохраняется, поэтому к прежним задачам можно вернуться и продолжить. Когда правка готова, страница обновляется на экране сама.
В новом чате по умолчанию уже выбран навык управления порталом portal-manager — агент с первого сообщения знает, как устроены страницы, блоки и правила портала, и не тратит время на объяснения. Как только вы выберете другой навык или «без навыка», выбор запомнится и будет применяться в следующих новых чатах.
Зафиксировать работу агента
Свои правки агент держит в рабочей папке репозитория — как черновик перед записью в историю. Пока в этой папке есть несохранённые изменения, в заголовке портала появляется пара кнопок: Коммит записывает работу агента в историю версий, а Отмена сначала спрашивает и затем необратимо откатывает все незафиксированные изменения. Так можно и закрепить удачную правку одной кнопкой, и отменить неудачную — до того, как она попадёт в историю.
Лицензия
Отправка сообщений агенту требует действующей лицензии — это единственное, что она ограничивает. Всё остальное работает и без неё: дерево страниц, просмотр, блоки, расчётные скрипты, формы и публичный сайт. Если лицензия истекла, при попытке отправить сообщение агенту появляется окно с предложением её обновить. Подробнее — на странице «Фабрика агентов».
Дальше: что именно проверяется у страницы — в разделе Проверки страниц; как агент правит контент через служебный адрес — в разделе Управление агентом; общее знакомство — в разделе Начало работы.