Извлечение ключевых фраз — когнитивный навык

Note

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

Навык извлечения ключевых фраз оценивает неструктурированный текст и для каждой записи возвращает список ключевых фраз. Этот навык использует модели машинного обучения Key Phrase предоставленные Azure Language in Foundry Tools.

Эта возможность полезна, если нужно быстро определить основные ключевые темы в записи. Например, если ввести текст «Еда была вкусной, и персонал был замечательным», сервис отвечает «еда» и «замечательный персонал».

Note

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

@odata.type

Microsoft.Skills.Text.KeyPhraseExtractionSkill

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

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

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

Параметры чувствительны к регистру.

Inputs Description
defaultLanguageCode (По желанию) Языковой код, который применяется к документам, где язык не указывается явно. Если код языка по умолчанию не указан, используется английский (en) как код по умолчанию.
Смотрите полный список поддерживаемых языков.
maxKeyPhraseCount (По желанию) Максимальное количество ключевых фраз для произведения.
modelVersion (По желанию) Указывает версию модели для вызова API ключевой фразы. По умолчанию он устанавливает последнюю доступность, если не указана. Мы рекомендуем не указывать это значение, если это не необходимо.

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

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

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

Выходные данные Description
keyPhrases Список ключевых фраз, извлечённых из входного текста. Ключевые фразы возвращаются в порядке важности.

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

Рассмотрим SQL-запись, содержащую следующие поля:

{
    "content": "Glaciers are huge rivers of ice that ooze their way over land, powered by gravity and their own sheer weight. They accumulate ice from snowfall and lose it through melting. As global temperatures have risen, many of the world’s glaciers have already started to shrink and retreat. Continued warming could see many iconic landscapes – from the Canadian Rockies to the Mount Everest region of the Himalayas – lose almost all their glaciers by the end of the century.",
    "language": "en"
}

Тогда ваше определение навыка может выглядеть так:

 {
    "@odata.type": "#Microsoft.Skills.Text.KeyPhraseExtractionSkill",
    "inputs": [
      {
        "name": "text",
        "source": "/document/content"
      },
      {
        "name": "languageCode",
        "source": "/document/language" 
      }
    ],
    "outputs": [
      {
        "name": "keyPhrases",
        "targetName": "myKeyPhrases"
      }
    ]
  }

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

В предыдущем примере вывод вашего навыка записывается в новый узел в обогащённом дереве под названием «document/myKeyPhrases», так как именно этот targetName узел мы указали. Если не указать targetName, то это будет «document/keyPhrases».

document/myKeyPhrases

[
  "world’s glaciers", 
  "huge rivers of ice", 
  "Canadian Rockies", 
  "iconic landscapes",
  "Mount Everest region",
  "Continued warming"
]

Вы можете использовать «document/myKeyPhrases» как ввод для других навыков или как источник отображения выходных полей.

Warnings

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

См. также

  • Last updated on