Связывание сущностей когнитивного навыка (версия 3)

Note

Поиск с использованием ИИ Azure доступна через портал Azure, REST API и Azure SDKs. Он также лежит в основе IQ Foundry, управляемого уровня знаний, который преобразует корпоративное содержимое в многократно используемые базы знаний с поддержкой разрешений для агентов на портале Foundry Microsoft.

Навык связывания сущностей (v3) возвращает список распознанных сущностей со ссылками на статьи в известной база знаний (Википедия).

Note

Этот навык привязан к моделям машинного обучения для связывания сущностей в Azure Vision в средстве Foundry. Для транзакций, превышающих 20 документов в день, требуется оплачиваемый ресурс для транзакций, превышающих 20 документов на индексатор. Выполнение встроенных навыков взимается по существующей цене средств Foundry Standard.

@odata.type

Microsoft.Skills.Text.V3.EntityLinkingSkill

Ограничения данных

Максимальный размер записи — 50 000 знаков по оценке String.Length. Если вам нужно разбить данные перед отправкой для применения навыка "связывание сущностей", используйте навык разделение текста. Если вы используете навык разделения текста, задайте длину страницы равным 5000 для оптимальной производительности.

Параметры навыков

Имена всех параметров чувствительны к регистру и являются необязательными.

Имя параметра Description
defaultLanguageCode Код языка вводимого текста. Если языковой код по умолчанию не указан, английский (en) используется в качестве языкового кода по умолчанию.
Полный список поддерживаемых языков.
minimumPrecision Значение от 0 до 1. Если оценка достоверности (в выходных entities данных) ниже этого значения, сущность не возвращается. По умолчанию установлено значение 0.
modelVersion (Необязательно) Указывает версию модели, используемую при вызове связывания сущностей. По умолчанию используется последняя доступная, если она не указана. Мы рекомендуем не указывать это значение, если это не необходимо.

Входные параметры навыков

Введите имя Description
languageCode Строка, указывающая язык записей. Если этот параметр не указан, код языка по умолчанию используется для анализа записей.
Полный список поддерживаемых языков.
text Текст для анализа.

Выходные данные навыка

Имя результата Description
entities Массив сложных типов, содержащий следующие поля:
  • "name" (Фактическое имя сущности, отображаемого в тексте)
  • "id"
  • "language" (Язык текста, определяемый навыком)
  • "url" (Связанный URL-адрес этой сущности)
  • "bingId" (BingId для этой связанной сущности)
  • "dataSource" (Источник данных, связанный с URL-адресом)
  • "matches"(Массив сложных типов, содержащих: text, offsetlength и confidenceScore)

Пример определения

  {
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityLinkingSkill",
    "context": "/document",
    "defaultLanguageCode": "en", 
    "minimumPrecision": 0.5, 
    "inputs": [
        {
            "name": "text", 
            "source": "/document/content"
        },
        {
            "name": "languageCode", 
            "source": "/document/language"
        }
    ],
    "outputs": [
        {
            "name": "entities", 
            "targetName": "entities" 
        }
    ]
}

Пример ввода

{
    "values": [
      {
        "recordId": "1",
        "data":
           {
             "text": "Microsoft is liked by many.",
             "languageCode": "en"
           }
      }
    ]
}

Пример полученных результатов

{
  "values": [
    {
      "recordId": "1",
      "data" : 
      {
        "entities": [
          {
            "name": "Microsoft", 
            "id": "Microsoft",
            "language": "en", 
            "url": "https://en.wikipedia.org/wiki/Microsoft", 
            "bingId": "a093e9b9-90f5-a3d5-c4b8-5855e1b01f85", 
            "dataSource": "Wikipedia", 
            "matches": [
                {
                    "text": "Microsoft", 
                    "offset": 0, 
                    "length": 9, 
                    "confidenceScore": 0.13 
                }
            ]
          }
        ],
      }
    }
  ]
}

Смещения, возвращаемые для сущностей в выходных данных этого навыка, возвращаются непосредственно из API-интерфейсов языковой службы, что означает, что если вы используете их для индексирования в исходной строке, следует использовать класс StringInfo в .NET для извлечения правильного содержимого. Дополнительные сведения см. в разделе "Поддержка многоязычных и эмодзи" в функциях языковой службы.

Примеры предупреждений

Если код языка для документа не поддерживается, возвращается предупреждение и сущности не извлекаются.

См. также

  • Last updated on