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