Типы сущностей и теги

Используйте эту статью, чтобы получить общие сведения о новых изменениях API, начиная с версии 2024-11-01. Это изменение API в основном представляет две новые концепции (entity types и entity tags) замены category полей subcategory в текущем общедоступном API. Подробный обзор каждого параметра API и соответствующих поддерживаемых версий API приведен на странице [параметров навыка][../how-to/skill-parameters.md].

Так как сущность, например "Сиэтл", может быть классифицирована как город, GPE (геополитическая сущность) и расположение, type атрибут используется для определения наиболее детализированной классификации, в данном случае City. Атрибут tags в выходных данных службы — это список всех возможных классификаций (Город, GPE и Расположение) и их соответствующая оценка достоверности. Перечислены полные сопоставления возможных тегов для каждого из них. Атрибуты metadata в выходных данных службы содержат дополнительные сведения об сущности, например целочисленном значении, связанном с сущностью.

Типы сущностей

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

Теги сущностей

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

Изменения от версий и 2022-05-01 API версий 2023-04-012024-11-01

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

Обновляет структуру входных форматов:

• Список включения
• Список исключений
• Политика совмещения

Обновляет обработку форматов выходных данных:

• Более детализированные выходные данные распознавания сущностей с помощью представления списка тегов, в котором сущность помечена несколькими тегами сущности.
• Перекрывающиеся сущности, в которых сущности могут быть распознаны как несколько типов сущностей, и если да, эта сущность будет возвращена дважды. Если сущность была признана принадлежащей двум тегам сущности при одном и том же типе сущности, оба тега сущности возвращаются в списке тегов.
• Фильтрация сущностей с помощью тегов сущностей: дополнительные сведения см. в разделе"Выбор возвращаемых сущностей".
• Объекты метаданных, содержащие дополнительные сведения об сущности, но в настоящее время служат оболочкой для существующей функции разрешения сущностей. Дополнительные сведения об этой новой функции см. здесь.

Версии 2022-05-01 и 2023-04-01 к текущим сопоставлениям сущностей API с актуальной версией

Вы можете увидеть сравнение структуры категорий и типов сущностей в статье о поддерживаемых категориях сущностей распознавания именованных сущностей (NER) и типах сущностей. В следующей таблице представлены сопоставления между результатами из текущей версии API, которые ожидается увидеть в версиях 2022-05-01 и 2023-04-01.