正規表現エンティティ

重要

LUIS は 2025 年 10 月 1 日に廃止され、2023 年 4 月 1 日から新しい LUIS リソースを作成できなくなります。 継続的な製品サポートと多言語機能のベネフィットを得るために、LUIS アプリケーションを会話言語理解に移行することをお勧めします。

正規表現エンティティは、指定された正規表現パターンに基づいてエンティティを抽出します。

生の発話テキストには正規表現をお勧めします。 大文字小文字とカルチャのバリアントは無視されます。 正規表現の照合は、トークン レベルでのスペルチェックによる変更後に適用されます。 角かっこが多用されているなど、正規表現が複雑すぎる場合は、このモデルに式を追加できません。 .NET Regex ライブラリの全体ではなく一部が使用されます。

エンティティは、次のような場合に最適です。

• データが一貫して書式設定され、バリエーションにも一貫性がある。
• 正規表現では、2 レベルを超える入れ子は必要ありません。

JSON の例

正規表現エンティティの定義として kb[0-9]{6} を使用したときの、次のクエリに対して返される正規表現エンティティを含む発話の例は、以下の JSON 応答のようになります。

When was kb123456 published?:

V2 予測エンドポイントの応答

"entities": [
  {
    "entity": "kb123456",
    "type": "KB number",
    "startIndex": 9,
    "endIndex": 16
  }
]

V3 予測エンドポイントの応答

これは、クエリ文字列で verbose=false が設定されている場合の JSON です。

"entities": {
    "KB number": [
        "kb123456"
    ]
}

これは、クエリ文字列で verbose=true が設定されている場合の JSON です。

"entities": {
    "KB number": [
        "kb123456"
    ],
    "$instance": {
        "KB number": [
            {
                "type": "KB number",
                "text": "kb123456",
                "startIndex": 9,
                "length": 8,
                "modelTypeId": 8,
                "modelType": "Regex Entity Extractor",
                "recognitionSources": [
                    "model"
                ]
            }
        ]
    }
}

次のステップ

エンティティの詳細を確認します。

• エンティティ型
• エンティティを作成する