共用方式為

移轉至最新版的 Azure AI 語言

  • 發行項

提示

剛開始使用 Azure AI 語言？ 如需有關目前 API 版本的詳細資訊，請參閱概觀文章以取得服務、可用功能和快速入門的連結。

如果您的應用程式仍使用文字分析 API 或用戶端程式庫 (5.1.0 之前的穩定版本)，此文章將協助您會應用程式升級到使用最新版本的 Azure AI 語言功能。

統一語言端點 (REST API)

本節適用於使用舊版 /text/analytics/... 端點格式進行 REST API 呼叫的應用程式。 例如：

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 版本中，文字分析 API 會將一個端點用於具名實體辨識 (NER) 和實體連結。 此功能的最新版本提供擴充的具名實體偵測，並針對 NER 和實體連結要求使用不同的端點。 此外，您可以使用語言服務中提供的另一個功能，讓您偵測個人 (PII) 和健康情況 (PHI) 資訊。

您也必須更新應用程式，以使用 API 回應中傳回的實體類別。

2.1 版實體類別

下表列出針對 NER 2.1 版傳回的實體類別。

類別 描述
個人 人名。
Location 自然和人為地標、結構、地理功能和地緣政治實體
Organization 公司、政治群組、樂團、運動俱樂部、政府機構和公共組織。 國籍和宗教不包含在此實體類型中。
PhoneNumber 電話號碼 (僅美國和歐洲的電話號碼)。
電子郵件 電子郵件地址。
URL 網站的 URL。
IP 網路 IP 位址。
Datetime 當日的日期和時間。
Date 行事曆日期。
Time 當日時間
DateRange 日期範圍。
TimeRange 時間範圍。
期間 持續時間。
設定 已設定、重複的時間。
數量 數字和數值數量。
數字 數字。
百分比 百分比。
序數 序數。
年齡 年齡。
貨幣 貨幣。
維度 尺寸和測量值。
溫度 溫度。

語言偵測 v2.1

語言偵測功能輸出已在最新版本中變更。 JSON 回應將包含 ConfidenceScore，而不是 score。 最新版本在每份文件中也只會傳回一種語言。

關鍵片語擷取 v2.1

關鍵片語擷取功能目前未在端點和要求格式版本之外變更。

另請參閱