Azure AI Language の最新バージョンに移行する

  • [アーティクル]

ヒント

Azure AI Language を使い始めたばかりですか? サービスの詳細と利用可能な機能のほか、最新バージョンの API についての情報が掲載されたクイックスタートへのリンクについては、概要記事を参照してください。

以前のバージョンの Text Analytics API またはクライアント ライブラリ (安定版の v5.1.0 より前) を現在もアプリケーションに使っている場合、この記事を参照すると、アプリケーションをアップグレードして Azure AI language の最新バージョンの機能を使用できるようになります。

統合言語エンドポイント (REST API)

このセクションは、REST API 呼び出しに古い /text/analytics/... エンドポイント形式を使用するアプリケーションが対象です。 次に例を示します。

https://<your-custom-subdomain>.cognitiveservices.azure.com/text/analytics/<version>/<feature>

アプリケーションで上記のエンドポイント形式を使用している場合、次の言語サービス機能の REST API エンドポイントが変更されました。

これらの機能に REST API 要求を送信するための統合エンドポイントが、言語サービスで新たに提供されます。 アプリケーションで REST API が使用される場合は、その要求エンドポイントを、現在のエンドポイントを使用するように更新します。

https://<your-language-resource-endpoint>/language/:analyze-text?api-version=2022-05-01

さらに、JSON 要求本文の形式が変更されました。 アプリケーションが API に送信する要求構造 (たとえば、次のエンティティ認識 JSON 本文) を更新する必要があります。

{
    "kind": "EntityRecognition",
    "parameters": {
        "modelVersion": "latest"
    },
    "analysisInput":{
        "documents":[
            {
                "id":"1",
                "language": "en",
                "text": "I had a wonderful trip to Seattle last week."
            }
        ]
    }
}

上記のリンク先のクイック スタートを使用して、現在使用している機能の REST API 呼び出しの例と、関連する API 出力を確認します。

クライアント ライブラリ

クライアント ライブラリの最新バージョンを使用するには、Azure.AI.TextAnalytics 名前空間で最新のソフトウェア パッケージをダウンロードする必要があります。 上記のリンク先のクイック スタート記事を参照してください。コードの例と、お好みの言語でクライアント ライブラリを使用する手順を参照してください。

バージョン 2.1 の機能の変更

API の v2.1 からアプリケーションを移行する場合に注意が必要な機能変更がいくつかあります。

感情分析 v2.1

バージョン 2.1 の感情分析では、API に送信された各ドキュメントに対するセンチメント スコアが 0 から 1 の間で返されます。この場合、スコアは 1 に近いほど、より肯定的な感情を示します。 この機能の現在のバージョンでは、文とドキュメント全体の両方に対するセンチメント ラベル ("肯定的" や "否定的" など) と、それらに関連付けられた信頼度スコアが返されます。

NER、PII、エンティティ リンク設定 v2.1

バージョン 2.1 の Text Analytics API では、固有表現認識 (NER) とエンティティ リンク設定に 1 つのエンドポイントが使用されます。 この機能の現在のバージョンでは、名前付きエンティティの検出が拡張され、NER とエンティティ リンク設定の要求に個別のエンドポイントが用意されています。 さらに、個人 (PII) と医療 (PHI) の情報を検出できる言語サービスで提供される他の機能も使用できます。

また、API の応答で返されるエンティティ カテゴリを使用するようアプリケーションを更新することも必要になります。

バージョン 2.1 でのエンティティのカテゴリ

次の表に、NER v2.1 で返されるエンティティのカテゴリを示します。

カテゴリ 説明
Person 人の名前。
場所 自然および人工のランドマーク、構造、地物、地政学的実体
Organization 企業、政治団体、音楽バンド、スポーツ クラブ、政府機関、および公的機関。 国籍と宗教は、このエンティティ型には含まれていません。
PhoneNumber 電話番号 (米国および EU の電話番号のみ)。
Email メール アドレス。
URL Web サイトへの URL。
IP ネットワーク IP アドレス。
DateTime 日付と時刻。
Date カレンダーの日付。
Time 時間帯
DateRange 日付の範囲。
TimeRange 時間の範囲。
Duration 期間。
オン 設定された繰り返し時間。
Quantity 数値と数量です。
Number 数値
パーセント パーセント。
Ordinal 序数。
Age 年齢。
Currency 通貨。
Dimension ディメンションと測定。
気温 気温。

言語検出 v2.1

現在のバージョンでは言語検出機能の出力が変更されました。 JSON 応答には、score の代わりに ConfidenceScore が含まれます。 また、現在のバージョンでは、各ドキュメントで 1 つの言語のみが返されます。

キー フレーズ抽出 v2.1

現在、キー フレーズ抽出機能は、エンドポイントと要求の形式以外に変更されていません。

関連項目