Workflow Editor — Документация Entity Enricher

Редактор рабочих процессов

Страница, на которой вы полностью собираете одно обогащение: образец данных, схема, модели, результаты. В её центре — дерево схемы: визуальный редактор с изменением порядка перетаскиванием, редактированием на месте, навигацией с клавиатуры и изменениями с помощью ИИ.

Обзор

Дерево схемы позволяет просматривать и изменять ваши схемы обогащения, не набирая JSON вручную. Свойства отображаются в виде интерактивного дерева, сгруппированного по областям экспертизы, поэтому сразу видно, какие поля относятся к какой специализации. Каждое изменение фиксируется в истории отмены/повтора и автоматически сохраняется после 2-секундной задержки.

Ключевые возможности

Группировка по экспертизе

Свойства сгруппированы по области экспертизы со сворачиваемыми разделами. Включайте и отключайте группировку.

Перетаскивание

Когда режим «Отсортировано» выключен, вы можете менять порядок свойств внутри групп и между ними перетаскиванием — расположение сохраняется в схеме. Визуальные индикаторы места вставки показывают, куда попадёт элемент.

Встроенное редактирование

Нажмите на любое свойство, чтобы изменить его имя, тип, описание и примеры прямо в дереве.

Навигация с клавиатуры

Стрелки — навигация, свёртывание и развёртывание, Enter — редактирование, Delete — удаление, Ctrl+A — выделить всё. Отмена и повтор действий — кнопки на панели инструментов; история сохраняется при смене схемы и перезагрузке страницы.

Поиск и фильтрация

Текстовый поиск для нахождения полей в больших схемах: сначала по именам свойств, а при отсутствии совпадений — по описаниям и примерам. Вложенные совпадения раскрываются только вместе с путём, ведущим к ним.

Отменить / Повторить

Полная история изменений для ручного редактирования. Изменения, сгенерированные ИИ, заменяют данные без добавления записей в историю отмен.

Типы и наборы значений

Вкладки вверху содержат именованные типы схемы. Кнопка + создаёт либо Объект (вложенную сущность со своими свойствами), либо Enum (закрытый список допустимых значений, на который можно указать любое текстовое свойство).

Режим диаграммы

Режим ДИАГРАММА рядом с режимами СХЕМА и JSON отображает схему в виде диаграммы сущностей: именованные сущности — как карточки с заголовком, вложенные объекты — как обычные карточки, названные по их связи, а ссылки (1–1) и связи (1–N) — как пунктирные рёбра. Диаграмма обновляется по мере ваших правок, а щелчок по карточке сущности открывает её в режиме СХЕМА.

Дерево свойств

Каждая строка в редакторе представляет свойство схемы, ключевые атрибуты которого видны с первого взгляда:

ВыбИмя свойстваТипОписание
□company_name
🔍
stringЮридическое наименование компании
□revenuenumberГодовой доход в долларах США
□headquartersobjectШтаб-квартира компании
□ citystringНазвание муниципалитета
□ country
🔍
stringСтрана, где расположена штаб-квартира
□gmp_statusbooleanСтатус сертификации GMP

Вложенные свойства (например, city внутри headquarters) имеют отступ, отражающий иерархию. Значок лупы отмечает ключи поиска — поля, используемые для идентификации сущности.

Наборы значений (перечисления)

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

Работа с наборами значений

Создать

Нажмите + на вкладках типов, выберите Enum и задайте ему имя. Новая вкладка откроет список его элементов.

Редактировать элементы

Добавляйте, переименовывайте, меняйте порядок или удаляйте значения. Добавьте элементу примечание, если его смысл не очевиден из названия.

Использовать

Задайте типу любого текстового свойства этот набор значений (или его массив) из группы «Наборы значений» в выпадающем списке типов.

Отменить

Верните тип свойства обратно на string или удалите набор значений — использующие его свойства снова станут обычными текстовыми свойствами.

Используйте набор значений только для словаря, который можно перечислить полностью. Если реальной сущности нужно значение, которое вы не включили, модель вынуждена выбрать ближайшее неверное вместо того, чтобы сообщить о проблеме — поэтому поля с открытым набором вариантов (имя, описание, произвольная категория) должны оставаться обычным текстом. По той же причине генерация схемы предлагает наборы значений осторожно, и всё предложенное здесь можно отредактировать.

Редактирование свойств

Нажмите на строку свойства или клавишу Enter, чтобы перейти в режим редактирования. В режиме редактирования вы можете изменить:

НазваниеКлюч свойства в выводе JSON. Используйте snake_case для единообразия.
ТипВыберите string, number, integer, boolean, array или object. Изменение типа обновляет формат вывода обогащения.
ОписаниеКонтекстное описание, которое направляет ИИ во время enrichment. Чем больше деталей, тем лучше результат.
ПримерыДва или три реалистичных примера значений. Они помогают ИИ понять ожидаемый формат и содержание.
ЭкспертизаКакой отраслевой эксперт предоставляет это значение. Определяет группировку при обогащении с несколькими экспертными областями.
Допускает nullМожет ли реальный экземпляр действительно не иметь этого значения. Поля, не допускающие null, обязательны для внесения в базу данных — обогащение, которое не может их заполнить, отклоняется контролем качества. Недоступно для ключа базы данных (значение null не идентифицирует ни одну строку) и для сохранённого поля (ваши входные данные всегда его предоставляют).
МногоязычныйДолжно ли поле обогащаться на нескольких языках.
СохранитьОпределяет, следует ли сохранять исходное входное значение без изменений. Для значений, которыми владеет ваша собственная система, — идентификатора в базе данных, внутреннего SKU, ссылки на клиента, — но не для публичных идентификаторов (CAS, ISBN, EAN, тикер), которые обогащение может найти за вас. В этом случае каждое обогащение должно предоставлять для него значение.

Сочетания клавиш

Редактор схем поддерживает полностью управляемый с клавиатуры рабочий процесс для эффективного редактирования:

Сочетание клавишДействие
Arrow Up / DownПереход между свойствами (удерживайте Shift, чтобы расширить выделение)
Arrow Left / RightСвернуть или развернуть выбранный объект
Home / EndПерейти к первому или последнему свойству
EnterПереключить режим редактирования выбранного свойства
Delete / BackspaceУдалить выбранное свойство
Ctrl+A / Cmd+AВыбрать все свойства
EscapeВыйти из режима редактирования или снять выделение

Изменение порядка перетаскиванием

Чтобы менять порядок вручную, выключите переключатель Сортировка. По умолчанию редактор перечисляет свойства по алфавиту, и перетаскивание там отключено: ручной порядок, который настройка отображения может незаметно перекрыть, мало чего стоит. Снятие флажка «Сортировка» переключает на собственный порядок схемы и включает перетаскивание; линия вставки показывает, куда именно попадёт свойство, а итоговый порядок сохраняется вместе со схемой. Перетаскивать можно как внутри группы экспертизы, так и между группами — чтобы изменить назначенный домен.

Когда включена группировка по экспертизе, перетаскивание свойства в другую группу автоматически обновляет назначенную ему область экспертизы. Это делает реорганизацию больших схем интуитивной — просто перетащите поле из «Финансового аналитика» в «Регуляторного эксперта», и его область экспертизы обновится соответствующим образом.

Панель редактирования ИИ

Под деревом свойств панель ИИ-редактирования позволяет изменять схему на естественном языке. Введите инструкцию вроде «добавь ссылку parent_company», и ИИ применит изменение, сохранив вашу существующую структуру.

Предложения ИИ

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

Узнайте больше о редактировании схем с помощью ИИ в руководстве Генерация схем с помощью ИИ.

Значки неоднозначности

Прочитайте имя свойства в контексте родительского объекта: сколько разных вещей оно может запрашивать? Ровно одна — всё ясно. Две или больше — и свойство получает значок неоднозначно: янтарный, когда прочтения в основном совпадают и различаются лишь пограничные случаи, и красный, когда они дадут существенно разные данные. Наведите курсор на значок, чтобы увидеть конкурирующие интерпретации, которые допускает имя, и переписанное описание, закрепляющее ровно одну из них. Имя, на которое родителю нечем ответить, помечается тоже: там подсказка перечисляет рассмотренные и отклонённые прочтения, а исправление — переименование или удаление, ведь никакое описание не даст сущности свойство, которого у неё нет.

Кнопка повторной проверки

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

Здесь решением будет описание

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

Устаревшие аннотации

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

Переключатель для каждой схемы

Отключите проверку для схемы из дополнительного меню — значки и предупреждения исчезнут, а повторное включение для ни разу не анализировавшейся схемы запускает проверку автоматически.

Полный механизм — два вердикта, стоящие за каждым из них трактовки и почему до создания схемы решением является переименование, а после её запуска — описание, — разобран в руководстве Проверка неоднозначности.

Управление схемами

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

Автосохранение

Изменения сохраняются автоматически после 2-секундной паузы с дедупликацией по хэшу содержимого во избежание лишних записей.

Закрепить схемы

Закрепляйте часто используемые схемы, чтобы они оставались вверху списка выбора.

Дублировать

Создайте копию любой схемы, чтобы экспериментировать с изменениями, не затрагивая оригинал.

Мягкое удаление

Удалённые схемы можно восстановить. Безвозвратное удаление — отдельное действие.

Дальнейшие шаги