Colay / Руководства

Обновляйте базу знаний партиями, сохраняя контроль над изменениями

Когда изменение продукта затрагивает много статей и скриптов поддержки, основная задача — согласованное обновление. Colay помогает сравнить способы редактирования и подготовить выбранные фрагменты. Реестр изменений, общая карточка фактов и очередь проверки делают черновики пригодными для всей партии. Это управляемая редакторская работа, а не автоматическое фоновое обновление подключённой базы знаний.

Найдите затронутые материалы до генерации текста

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

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

Ведите реестр до самой публикации

Представим вымышленный сервис, который переносит кнопку экспорта. Утверждённый новый путь — Reports → Export; права и форматы выгрузки остаются прежними. В списке есть инструкция, чек-лист онбординга и ответ поддержки. Эти условия примера не описывают интерфейс Colay.

Материалам нужны разные правки: инструкции может понадобиться новый скриншот, чек-листу — замена одного названия, скрипту — исправленный путь. Восемь полных версий каждого текста увеличили бы объём проверки без обязательной пользы для обновления.

Пример реестра для вымышленного изменения интерфейса
МатериалНужная правкаПодтверждение проверкиСтатус
KB-12: инструкция экспортаОбновить путь и скриншотПройти экспорт с указанной рольюЧерновик ждёт проверки
ON-4: чек-лист онбордингаЗаменить старое расположение настройкиПроверить ссылку на инструкцию и видимое названиеГотово к проверке владельцем
SUP-7: сохранённый ответИсправить одну инструкциюПроверить ответ на примере вопросаНе начато

Согласуйте подход на небольшой разнородной выборке

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

  1. Выберите простую статью, статью с исключениями и скрипт поддержки. Сначала подготовьте их, затем переходите к остальному реестру.
  2. Передайте доступным агентам Colay одну карточку изменения и запросите разные способы редактирования. Сравните сохранность неизменяемых правил.
  3. Утвердите образец редактуры и словарь терминов. Держите принятые и отклонённые правки рядом с брифом партии.
  4. Вручную обрабатывайте обозримые группы материалов, сохраняя идентификатор и версию источника каждого. При новом противоречии остановите соответствующую часть работы.

Промпт для прослеживаемой правки одного материала

Передавайте только разрешённые материалы, убрав ненужные сведения о клиентах. Основной реестр храните в привычном документе или системе контента. Сгенерированный ответ Colay сам по себе не меняет статус публикации материала.

Обнови материал [ID и версия источника] по утверждённой карточке: [старое и новое поведение, дата, исключения]. Исходный текст: [текст]. Утверждённые термины и образец редактуры: [правила]. Верни новую редакцию, изменённые фрагменты с причинами, сохранённые неизменяемые правила и вопросы, блокирующие публикацию. Меняй только затронутый контент. Сохрани ссылки и идентификаторы, если бриф прямо не требует их изменить. Не выдумывай элементы интерфейса, права, даты или поведение продукта. Если материал противоречит карточке, отметь конфликт, не разрешая его догадкой.

Публикуйте проверенные группы и сохраняйте прошлую редакцию

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

Опубликуйте через свои инструменты, затем проверьте живую статью и сохранённые ответы, которые на неё ссылаются. Закрывайте пункт только после проверки. Для оценки процесса фиксируйте редакторское время и обнаруженные после публикации ошибки. Пакетный подход сокращает повторное объяснение контекста, но результат зависит от материалов и проверки; автоматической экономии недели он не обещает.

Вопросы и ответы

Можно загрузить всю базу и автоматически обновить её?

Здесь описана управляемая ручная подготовка текстов с Colay. Автоматическое подключение базы знаний, пакетная публикация или фоновая синхронизация не заявляются.

Какого размера должна быть партия?

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

Что делать, если исходные статьи противоречат друг другу?

Приостановите эти материалы и уточните у владельца контента или продукта, какое правило верно. Сохраните конфликт в реестре, чтобы гладкая редактура его не скрыла.

Источники и методология

  1. Google: написание процедур

    Первичное руководство о действиях и контексте; реестр партии и порядок публикации — оригинальные редакторские рекомендации.

Задайте следующий вопрос в Colay

Выберите модель, используйте Auto или объедините несколько точек зрения с Consensus.

Подготовить обновление