Colay / Руководства
Обновляйте базу знаний партиями, сохраняя контроль над изменениями
Когда изменение продукта затрагивает много статей и скриптов поддержки, основная задача — согласованное обновление. Colay помогает сравнить способы редактирования и подготовить выбранные фрагменты. Реестр изменений, общая карточка фактов и очередь проверки делают черновики пригодными для всей партии. Это управляемая редакторская работа, а не автоматическое фоновое обновление подключённой базы знаний.
Найдите затронутые материалы до генерации текста
Начните с изменения продукта и найдите в текущем контенте старый термин, правило или процедуру. Запишите идентификаторы статей, макросов поддержки, сообщений онбординга и внутренних инструкций, где они встречаются. Похожие заголовки не означают одинакового содержания, а модель не знает всех мест со старой формулировкой.
Составьте утверждённую карточку изменения: старое и новое поведение, дата вступления в силу, исключения и точные термины. Назначьте ответственного за неясные факты. Отделите обязательные фактические правки от необязательной стилистики, чтобы красивое предложение не скрыло изменение правила. Руководство Google по процедурам рекомендует понятные действия и явный контекст; применяйте этот стандарт ко всей партии.
Ведите реестр до самой публикации
Представим вымышленный сервис, который переносит кнопку экспорта. Утверждённый новый путь — Reports → Export; права и форматы выгрузки остаются прежними. В списке есть инструкция, чек-лист онбординга и ответ поддержки. Эти условия примера не описывают интерфейс Colay.
Материалам нужны разные правки: инструкции может понадобиться новый скриншот, чек-листу — замена одного названия, скрипту — исправленный путь. Восемь полных версий каждого текста увеличили бы объём проверки без обязательной пользы для обновления.
| Материал | Нужная правка | Подтверждение проверки | Статус |
|---|---|---|---|
| KB-12: инструкция экспорта | Обновить путь и скриншот | Пройти экспорт с указанной ролью | Черновик ждёт проверки |
| ON-4: чек-лист онбординга | Заменить старое расположение настройки | Проверить ссылку на инструкцию и видимое название | Готово к проверке владельцем |
| SUP-7: сохранённый ответ | Исправить одну инструкцию | Проверить ответ на примере вопроса | Не начато |
Согласуйте подход на небольшой разнородной выборке
Восемь способов переписывания полезны при выборе подхода: краткая инструкция, объяснение новичку, разбор неполадок, FAQ, ответ поддержки, внутренний чек-лист, простой доступный язык и короткое резюме. Выберите нужные вашему списку форматы. Полезный результат — единое правило редактирования, а не восемь конкурирующих редакций каждой страницы.
- Выберите простую статью, статью с исключениями и скрипт поддержки. Сначала подготовьте их, затем переходите к остальному реестру.
- Передайте доступным агентам Colay одну карточку изменения и запросите разные способы редактирования. Сравните сохранность неизменяемых правил.
- Утвердите образец редактуры и словарь терминов. Держите принятые и отклонённые правки рядом с брифом партии.
- Вручную обрабатывайте обозримые группы материалов, сохраняя идентификатор и версию источника каждого. При новом противоречии остановите соответствующую часть работы.
Промпт для прослеживаемой правки одного материала
Передавайте только разрешённые материалы, убрав ненужные сведения о клиентах. Основной реестр храните в привычном документе или системе контента. Сгенерированный ответ Colay сам по себе не меняет статус публикации материала.
Обнови материал [ID и версия источника] по утверждённой карточке: [старое и новое поведение, дата, исключения]. Исходный текст: [текст]. Утверждённые термины и образец редактуры: [правила]. Верни новую редакцию, изменённые фрагменты с причинами, сохранённые неизменяемые правила и вопросы, блокирующие публикацию. Меняй только затронутый контент. Сохрани ссылки и идентификаторы, если бриф прямо не требует их изменить. Не выдумывай элементы интерфейса, права, даты или поведение продукта. Если материал противоречит карточке, отметь конфликт, не разрешая его догадкой.
Публикуйте проверенные группы и сохраняйте прошлую редакцию
Перед публикацией сверьте каждый изменённый шаг, исключение и ссылку с утверждённым источником и реальным продуктом. Прочитайте документ целиком вокруг правок: исправленный абзац может противоречить неизменённому вступлению. Зафиксируйте проверяющего и сохраните прежнюю версию.
Опубликуйте через свои инструменты, затем проверьте живую статью и сохранённые ответы, которые на неё ссылаются. Закрывайте пункт только после проверки. Для оценки процесса фиксируйте редакторское время и обнаруженные после публикации ошибки. Пакетный подход сокращает повторное объяснение контекста, но результат зависит от материалов и проверки; автоматической экономии недели он не обещает.
Вопросы и ответы
Можно загрузить всю базу и автоматически обновить её?
Здесь описана управляемая ручная подготовка текстов с Colay. Автоматическое подключение базы знаний, пакетная публикация или фоновая синхронизация не заявляются.
Какого размера должна быть партия?
Такого, чтобы проверяющий мог сверить каждый затронутый материал с карточкой изменения. Уменьшайте группу, если правила или форматы контента различаются.
Что делать, если исходные статьи противоречат друг другу?
Приостановите эти материалы и уточните у владельца контента или продукта, какое правило верно. Сохраните конфликт в реестре, чтобы гладкая редактура его не скрыла.
Источники и методология
- Google: написание процедур
Первичное руководство о действиях и контексте; реестр партии и порядок публикации — оригинальные редакторские рекомендации.
Задайте следующий вопрос в Colay
Выберите модель, используйте Auto или объедините несколько точек зрения с Consensus.