Aracılığıyla paylaş

Azure AI Dilinin en son sürümüne geçiş

  • Makale

İpucu

Azure AI Dili'ne yeni mi başlıyorsunuz? API'nin geçerli sürümü hakkında bilgi için hizmet, kullanılabilir özellikler ve hızlı başlangıç bağlantıları hakkında ayrıntılı bilgi için genel bakış makalesine bakın.

Uygulamalarınız hala Metin Analizi API'sini veya istemci kitaplığını kullanıyorsa (kararlı v5.1.0 sürümünden önce), bu makale uygulamalarınızı Azure AI dil özelliklerinin en son sürümünü kullanacak şekilde yükseltmenize yardımcı olur.

Birleşik Dil uç noktası (REST API)

Bu bölüm REST API çağrıları için eski /text/analytics/... uç nokta biçimini kullanan uygulamalar için geçerlidir. Örneğin:

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

Uygulamanız yukarıdaki uç nokta biçimini kullanıyorsa, aşağıdaki Dil hizmeti özellikleri için REST API uç noktası değişmiştir:

Dil hizmeti artık bu özelliklere REST API istekleri göndermek için birleşik bir uç nokta sağlar. Uygulamanız REST API kullanıyorsa, istek uç noktasını geçerli uç noktayı kullanacak şekilde güncelleştirin:

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

Ayrıca JSON istek gövdesinin biçimi de değişmiştir. Uygulamanızın API'ye gönderdiği istek yapısını , örneğin aşağıdaki varlık tanıma JSON gövdesini güncelleştirmeniz gerekir:

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

Kullandığınız özellikler için geçerli örnek REST API çağrılarını ve ilişkili API çıkışını görmek için yukarıdaki bağlantılı hızlı başlangıçları kullanın.

İstemci kitaplıkları

İstemci kitaplığının en son sürümünü kullanmak için ad alanındaki en son yazılım paketini Azure.AI.TextAnalytics indirmeniz gerekir. Yukarıda bağlantı verilen hızlı başlangıç makalelerine bakın. Örneğin, tercih ettiğiniz dilde istemci kitaplığını kullanmaya yönelik kod ve yönergeler.

Sürüm 2.1 işlev değişiklikleri

Bir uygulamayı API'nin v2.1'inden geçiriyorsanız, özellik işlevselliğinde bilmeniz gereken birkaç değişiklik vardır.

Yaklaşım analizi v2.1

Sürüm 2.1'deki Yaklaşım Analizi , API'ye gönderilen her belge için 0 ile 1 arasındaki yaklaşım puanlarını döndürür ve 1'e yakın puanlar daha olumlu yaklaşımı gösterir. Bu özelliğin geçerli sürümü, hem tümceler hem de belgenin tamamı için yaklaşım etiketlerini ("pozitif" veya "negatif" gibi) ve ilişkili güvenilirlik puanlarını döndürür.

V2.1'i bağlayan NER, PII ve varlık

Sürüm 2.1'de Metin Analizi API'sinde Adlandırılmış Varlık Tanıma (NER) ve varlık bağlama için bir uç nokta kullanılmıştır. Bu özelliğin geçerli sürümü genişletilmiş adlandırılmış varlık algılaması sağlar ve NER ve varlık bağlama istekleri için ayrı uç noktaları vardır. Ayrıca, Dil hizmetinde sunulan ve kişisel (PII) ve sistem durumu (PHI) bilgilerini algılamanızı sağlayan başka bir özelliği de kullanabilirsiniz.

Api'nin yanıtında döndürülen varlık kategorilerini kullanmak için uygulamanızı güncelleştirmeniz de gerekir.

Sürüm 2.1 varlık kategorileri

Aşağıdaki tabloda NER v2.1 için döndürülen varlık kategorileri listelenir.

Kategori Açıklama
Kişi İnsanların isimleri.
Konum Doğal ve insan yapımı yer işaretleri, yapılar, coğrafi özellikler ve jeopolitik varlıklar
Kuruluş Şirketler, siyasi gruplar, müzik grupları, spor kulüpleri, kamu kuruluşları ve kamu kuruluşları. Milliyetler ve dinler bu varlık türüne dahil değildir.
PhoneNumber Telefon numaraları (yalnızca ABD ve AB telefon numaraları).
E-posta E-posta adresleri.
URL Web sitelerine URL'ler.
IP Ağ IP adresleri.
DateTime Günün tarihleri ve saatleri.
Tarih Takvim tarihleri.
Saat Günün saatleri
DateRange Tarih aralıkları.
TimeRange Zaman aralıkları.
Süre Süre.
Ayarla Tekrarlanan zamanları ayarlayın.
Miktar Sayılar ve sayısal miktarlar.
Sayı Sayılar.
Yüzde Yüzde.
Sıralı Sıra numaraları.
Yaş Yaş.
Para birimi Para.
Boyut Boyutlar ve ölçümler.
Sıcaklık Sıcaklık.

Dil algılama v2.1

Dil algılama özelliği çıkışı geçerli sürümde değişti. JSON yanıtı yerine scoreöğesini içerirConfidenceScore. Geçerli sürüm ayrıca her belge için yalnızca bir dil döndürür.

Anahtar ifade ayıklama v2.1

Anahtar tümcecik ayıklama özelliği işlevselliği şu anda uç nokta ve istek biçiminin dışında değişmemiştir.

Ayrıca bkz.