キー フレーズ抽出コグニティブ スキル

キー フレーズ抽出スキルは、非構造化テキストを評価し、各レコードに対してキー フレーズのリストを返します。 このスキルでは、Azure AI Language で提供されるキー フレーズ機械学習モデルが使用されます。

この機能は、レコード内の要点をすばやく特定する必要がある場合に便利です。 たとえば、「食べ物はおいしくて、すばらしいスタッフがいた」というテキストを入力すると、 "食べ物" と "すばらしいスタッフ" がサービスによって返されます。

@odata.type

Microsoft.Skills.Text.KeyPhraseExtractionSkill

データ制限

レコードのサイズは、String.Length で測定して 50,000 文字以下にする必要があります。 データをキー フレーズ エクストラクターに送信する前に分割する必要がある場合は、テキスト分割スキルの使用を検討してください。 テキスト分割スキルを使用する場合は、最適なパフォーマンスを得るためにページの長さを 5000 に設定します。

スキルのパラメーター

パラメーターの大文字と小文字は区別されます。

スキルの入力

スキルの出力

定義例

次のフィールドを持つ 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 文字のみが分析され、警告が発行されます。

関連項目

• 組み込みのスキル
• スキルセットの定義方法
• 出力フィールドのマッピングを定義する方法