Чтобы составить глоссарий с нейросетью, соберите документы команды, извлеките термины вместе с исходными фрагментами и подготовьте определения для проверки специалистами. Если отделы используют одно слово по-разному, сохраните контексты и согласуйте отдельные значения. Ниже — порядок работы, промпты и шаблон записи.
Как составить глоссарий, которым команда сможет пользоваться
Определите область применения, соберите источники, извлеките термины, проверьте определения, согласуйте значения и опубликуйте записи. Для этой задачи будем считать корпоративным глоссарием собрание карточек понятий, которыми пользуется команда. Каждая карточка связывает термин с определением и контекстом. Результат проверяйте на рабочем поручении: помогает ли справочник понять, какое действие нужно выполнить?
Сначала выберите масштаб.
Можно описать понятия предметной области, значения внутри компании или договорённости участников отдельного проекта. Здесь будем собирать глоссарий для продуктовой команды и поддержки.
Не пытайтесь вместить в него все справочники компании. Правила написания оставьте в руководстве по стилю, переведённые фрагменты — в памяти переводов. В карточке понятия сохраняйте сведения, которые помогают выбрать нужное значение и проверить его основание.
Проверьте результат на поручении: сотрудник находит термин, отличает нужное значение от соседнего и открывает подтверждающий источник.
Мнение. Начните с терминов одного процесса, которые вызывают конкретное затруднение у читателей. Решение о значении принимает ответственный специалист. Ответ нейросети остаётся черновиком до согласования.
Весь порядок ниже — редакционная рекомендация. Мы не утверждаем, что любая нейросеть прочитает любой файл или соблюдёт промпт: результат каждого шага нужно проверить по исходным фрагментам.
Расскажите, чему хотите научить команду. Обсудим задачи и формат обучения.
Подготовьте документы и правила отбора терминов
Маршрут подготовки: от цитаты в документе к карточке с проверяемым основанием.
Соберите разрешённые документы выбранного процесса и заранее определите читателей глоссария. Для новичков понадобятся пояснения сокращений, для смежных отделов — границы привычных слов. Сохраняйте контекст употребления: кто использует термин, какое действие описывает и при каких условиях. Передавайте нейросети эти фрагменты вместе с указателями на источники, чтобы затем сверить предложенные записи с оригиналами.
Возьмите регламенты, инструкции, учебные материалы, описания событий и шаблоны рабочих сообщений. Присвойте документам обозначения, сохраните версии и номера разделов. Устаревшие материалы пометьте отдельно. Противоречащие документы оставьте для разбора с владельцем процесса.
До передачи материалов согласуйте разрешение на использование документов в выбранном сервисе. Если допустимость передачи не установлена, не загружайте их. Замена названий сама по себе не подтверждает обезличивание: способ подготовки согласует ответственный за данные.
Пока проверка не завершена, используйте вымышленные фрагменты.
Для сквозного примера возьмём условные документы:
ПРОД, раздел «События»: «Активация — первое создание проекта пользователем».
ПОДДЕРЖКА, раздел «Доступ»: «Активация — включение доступа к оплаченному рабочему пространству».
Включайте специальные термины, сокращения, названия и обычные слова с особым рабочим значением. Слово «документ» без локального смысла пояснять незачем; «активацию» в нашем примере стоит разобрать.
Двигайтесь от источников к кандидатам терминов, затем к определениям, разбору конфликтов, согласованию и публикации. Сохраняйте связь записи с источником на каждом переходе.
Создайте шаблон карточки понятия
Заведите отдельную карточку понятия с устойчивым идентификатором, определением, областью применения и подтверждающим фрагментом. Не используйте написание термина как единственный идентификатор: предусмотрите разные значения одного слова и возможное переименование. В карточке также укажите, кто согласует определение. Предложенный ниже шаблон — рабочая заготовка, которую можно адаптировать к процессам команды и составу исходных документов.
Заполним карточку продуктового значения из условного примера.
| Поле карточки | Назначение | Условный пример |
|---|---|---|
| Идентификатор | Сохранять связь при переименовании | ПОН-001 |
| Предпочтительный термин | Задать название для документов | Активация пользователя |
| Определение | Раскрыть понятие | Первое создание проекта пользователем |
| Область применения | Ограничить значение | Продуктовая аналитика |
| Контекст и пример | Показать употребление | Отчёт: «Пользователь создал первый проект — произошла активация» |
| Допустимые варианты | Поддержать поиск | Активация — внутри продуктового отчёта |
| Нежелательные обозначения | Предупредить смешение | Активация доступа |
| Источник и фрагмент | Позволить проверку | ПРОД, «События»: «Активация — первое создание проекта пользователем» |
| Владелец понятия | Назначить согласующего | Ответственный за продуктовую аналитику |
| Версия и статус | Отличать редакции | Версия А, черновик |
Здесь название «Активация пользователя» и остальные поля карточки — учебные предложения для согласования. Условный источник подтверждает только приведённое в нём определение.
Факт. В SKOS Reference W3C различает предпочтительное и альтернативные названия понятия. В разделах о документации отдельно предусмотрены определения и заметки об области применения. Это устройство модели SKOS; предложенная здесь таблица не заявляет соответствие стандарту и не требует внедрять RDF.
Для поддержки создайте другую карточку.
Свяжите записи перекрёстными ссылками, чтобы читатель видел различие значений. Здесь составляем одноязычный справочник понятий. Если задача — подобрать соответствия на другом языке, используйте отдельный порядок проверки делового перевода.
Извлеките термины вместе с подтверждающими фрагментами
Поля карточки сохраняют смысл, адрес источника и состояние согласования.
Попросите нейросеть извлечь кандидатов только из переданных материалов и приложить к каждому точную цитату, источник и область употребления. Такой результат можно сверить с оригиналом. Список слов без контекста не показывает, почему термин предложен для глоссария и какое значение имел автор документа. До проверки считайте каждую запись предложением модели.
Сохраните указатели при разбиении материалов: обозначение документа, версию, раздел. Если соседний абзац задаёт исключение, передайте его вместе с основным определением.
Фрагмент должен оставаться связанным с документом.
Используйте промпт:
Извлеки кандидаты терминов только из переданных документов. Для каждого укажи точный фрагмент, обозначение документа, раздел и область употребления. Не добавляй отсутствующие термины и не придумывай ссылки. Если данных недостаточно, отметь это.
Порядок проверки результата:
- Передайте источники с сохранёнными обозначениями и разделами.
- Получите кандидатов с цитатами и основанием включения.
- Найдите каждую цитату в оригинале; запись без подтверждения исключите из подготовки определений.
- Отметьте варианты написания и возможные дубли для сопоставления.
Ожидаемая учебная запись: «активация»; цитата — «Активация — первое создание проекта пользователем»; источник — ПРОД, «События». Контекст — продуктовая аналитика, основание включения — специальное значение рабочего события.
Исправляйте регистр и ищите дубли отдельно от объединения понятий. Похожие написания оставьте кандидатами на сопоставление: одинаковая форма ещё не доказывает общий смысл.
При подготовке промпта для рабочей задачи задайте материалы, ограничения и формат проверяемого ответа.
Подготовьте определения и примеры употребления
Поручите нейросети сформулировать определения по проверенным фрагментам, отдельно перечислить границы значения и вопросы владельцу понятия. В определении раскройте смысл термина в выбранном процессе, в примере покажите его употребление. Если источник не раскрывает условие, оставьте вопрос открытым. Не переносите догадку в карточку, по которой сотрудник будет выполнять рабочее действие.
Промпт для подготовки черновика:
Для каждой записи предложи определение по указанным фрагментам. Отдели определение от примера употребления. Не добавляй условий, которых нет в источниках. При нехватке сведений укажи, что нужно уточнить у владельца понятия.
Разберём специально сконструированную ошибку. Для продуктовой активации модель могла бы предложить: «Первое создание проекта после приглашения коллеги». Приглашения в исходном фрагменте нет.
Такое условие исключит пользователя, который создал проект самостоятельно.
Исправленный черновик: «Активация пользователя — первое создание проекта пользователем». Пример: «После создания первого проекта в отчёте отмечают активацию пользователя». Вопрос владельцу: «Учитывают ли тестовые проекты?» Условный документ ответа не содержит.
Microsoft Style Guide рекомендует пояснять технические термины в контексте и последовательно использовать выбранные обозначения. Это рекомендации Microsoft для технических текстов, а не обязательный порядок согласования словаря компании.
Не заменяйте локальное значение общим определением из интернета. Проверяйте формулировку по документам выбранного процесса и решениям его владельца.
Прочитайте определение без соседних абзацев. Нет ли объяснения через само себя: «активация — процесс активирования»? Понятны ли сокращения? Соответствует ли пример каждому условию определения?
Для дополнительного условия нужен подтверждающий фрагмент или зафиксированное решение владельца понятия.
Разберите конфликты значений между отделами
Варианты одного понятия, разные значения и пробел в источнике требуют разных решений.
При конфликте значений сопоставьте контексты употребления: объект, действие, условия и область применения. Не объединяйте записи только по совпадению слов. Проверьте, описывают ли документы разные события, используют ли разные названия для одного понятия или противоречат друг другу. Для каждой ситуации сохраните отдельное решение, его основание и ответственного за согласование.
В условном примере продуктовая аналитика описывает создание проекта, поддержка — включение доступа. Обобщённое определение «начало работы пользователя» скроет различие. Оно позволит прочитать сообщение об активации как подтверждение любого из этих событий.
| Обозначение и значение | Контекст и фрагмент | Тип расхождения | Предложение для согласования |
|---|---|---|---|
| Активация: создание проекта | ПРОД: «первое создание проекта пользователем» | Одно слово, разные понятия | Карточка «Активация пользователя»; согласует владелец аналитики |
| Активация: включение доступа | ПОДДЕРЖКА: «включение доступа к оплаченному рабочему пространству» | Одно слово, разные понятия | Карточка «Активация доступа»; согласует владелец поддержки |
Если разные обозначения описывают один объект и одинаковые условия, согласуйте предпочтительный термин. Остальные сохраните как допустимые варианты.
Совпадение значения нужно подтвердить.
Если документы описывают одно событие несовместимо, передайте спор владельцам процесса. Сохраните решение и его основание в карточке. Нейросети поручите подготовить сопоставление, а выбор значения оставьте ответственным за процесс.
Для нашего примера предлагаем отдельные карточки с уточняющими названиями. Это редакционное решение для учебной ситуации, которое ещё нужно согласовать с владельцами понятий.
Проверьте записи и получите согласование
Перед публикацией сверьте каждое определение с цитатой, проверьте источник, версию документа и открытые противоречия. Передайте владельцу понятия текст и границы его применения. Предложите статусы «черновик», «требует уточнения», «согласовано», «устарело» и адаптируйте переходы между ними. В справочнике выделите утверждённые значения так, чтобы читатель мог отличить их от обсуждаемых записей.
Зафиксируйте согласованную редакцию, роль согласующего и дату решения в истории карточки. Ответ «в целом верно» оставляет неопределённость: попросите подтвердить конкретный текст.
Проверяйте ошибки через последствия.
В учебном примере добавленное условие меняет состав учитываемых пользователей. Смешение значений мешает понять, произошло создание проекта или включение доступа. Для каждого замечания запишите, какое действие сотрудника окажется под вопросом.
Затем испытайте глоссарий на новом условном документе: «После оплаты проверьте активацию». Попросите модель найти неоднозначности, используя только согласованные карточки, и назвать идентификатор каждой подходящей записи.
В контексте поддержки предложите уточнение: «После оплаты проверьте включение доступа к рабочему пространству». Свяжите его с карточкой «Активация доступа». Отдельно подтвердите у владельца инструкции, что автор имел в виду именно это действие.
Публикуйте согласованные записи, когда определения проверены, а противоречия разрешены или явно обозначены. Попросите коллегу выполнить поручение по справочнику и отметить места, где пришлось угадывать.
Неразрешённое противоречие сохраните как задачу на согласование. Не скрывайте его за обобщённым определением.
Оформите глоссарий и выберите способ хранения
Выберите таблицу или базу знаний, где сотрудник сможет найти понятие, увидеть статус и открыть источник. Проверьте поиск, права редактирования и историю изменений на своих записях. Сохраняйте карточки вместе с контекстом, владельцем и версией. Отдельно определите, кто публикует согласованный текст и как остальные сотрудники предлагают правки.
Добавьте алфавитный указатель, поиск по сокращениям и допустимым вариантам, фильтр по области применения. Связанные карточки соедините ссылками. Из «Активации пользователя» предусмотрите переход к «Активации доступа».
Старые и нежелательные обозначения тоже включите в поиск.
В результатах поиска показывайте предпочтительный термин и поясняйте, почему найденный вариант не рекомендуют использовать в выбранном контексте. Не удаляйте обозначение, пока по нему ищут нужное понятие в старых документах.
Для табличного обмена рассмотрите CSV. Перед переносом проверьте кодировку, разделители, кавычки и многострочные поля в выбранных инструментах. Сделайте пробную выгрузку карточки с цитатой и переносом строки, затем сравните исходную и импортированную запись по полям.
Если нужен обмен с другой системой, сначала изучите её документацию по импорту и экспорту. Составьте соответствие полей и проверьте перенос идентификаторов, языков, источников и статусов. Не выбирайте формат до проверки этого соответствия.
Не считайте публикацию глоссария подключением базы знаний к ИИ. Здесь принимают карточки значений для людей. Подготовка корпуса для ассистента требует отдельной проверки состава документов и доступа.
Назначьте владельцев и порядок обновления
Повторная проверка затрагивает записи, связанные с изменённым документом.
Закрепите передачу изменений: сотрудник предлагает термин с источником, редактор проверяет материалы, владелец понятия согласует значение, ответственный за публикацию обновляет карточку. Пересмотр запускайте при изменении процесса, продукта или документа. Задайте понятный сигнал, после которого определение снова проходит проверку, и назначьте человека, который доведёт изменение до публикации.
Сохраняйте историю версий и помечайте заменённые записи. При переименовании оставьте поиск по старому термину и переход к действующей карточке. Так читатель сможет сопоставить прежнее обозначение с новым.
Изменение названия не должно обрывать историю понятия.
Нейросети можно передавать разрешённые новые материалы вместе с утверждённым глоссарием. Просите находить кандидатов и расхождения, прикладывая цитаты. Каждое предложение направляйте по тому же маршруту согласования.
В учебном примере результатом станут отдельные карточки для создания проекта и включения доступа. Названия, определения и границы применения нужно согласовать раздельно. Общее слово «активация» сохраните для поиска с указанием подходящих контекстов.
Начните с одного процесса и проверьте результат на поручении новому сотруднику. Нашёл ли он значение, источник и владельца без дополнительных объяснений? Зафиксируйте затруднения как задачи для следующей редакции справочника.
Если команде нужен общий порядок работы с документами и проверки ответов модели, обсудите программу корпоративного обучения по рабочим задачам. Опишите один процесс и затруднение: например, отделы по-разному понимают название одного события. Для первого разговора достаточно описания без закрытых документов.
Частые вопросы
Нужно ли включать произношение сокращений?
Добавьте произношение, если сотрудники используют сокращение устно и разночтения мешают разговорам. Согласуйте вариант с владельцем понятия. Для сокращения, которое встречается только в документах, оставьте расшифровку и определение.
Стоит ли удалять термин, который редко ищут?
Сначала проверьте, встречается ли термин в действующих инструкциях и нужен ли для рабочего действия с серьёзными последствиями ошибки. Не принимайте решение только по частоте поиска. Если запись нужна для разбора исключения, сохраните её и проверьте, понятен ли путь к ней из соответствующей инструкции.
Можно ли дать клиентам доступ к корпоративному глоссарию?
Подготовьте отдельную публичную подборку. Проверьте определения, примеры, названия и ссылки на внутренние документы. Назначьте ответственного за публикацию и отдельно согласуйте раскрытие материалов внешним читателям.
Источники
- W3C — SKOS Reference — раздел 5 о названиях и раздел 7 о документировании понятий.
- Microsoft Style Guide — Use technical terms carefully — контекст определения и последовательное употребление технических терминов.
