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

  • Makale

İpucu

Azure Yapay Zeka Dilini kullanmaya 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'a geçmeden ö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ı güncelleştirmeniz gerekir, örneğin aşağıdaki varlık tanıma JSON gövdesi:

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

Kullandığınız özelliklerin 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ında 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, kod ve istemci kitaplığını tercih ettiğiniz dilde kullanma yönergeleri.

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 cümleler hem de belgenin tamamı için yaklaşım etiketlerini ("pozitif" veya "negatif" gibi) ve ilişkili güvenilirlik puanlarını döndürür.

NER, PII ve v2.1'i bağlayan 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ılama sağlar ve NER ile varlık bağlama istekleri için ayrı uç noktalara sahiptir. 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ı da güncelleştirmeniz 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 adları.
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 adresleri Email.
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ı Numara.
Yüzde Yüzde.
Sıralı Sıralı sayılar.
Yaş Yaş.
Para Birimi Para.
Boyut Boyutlar ve ölçüler.
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 ifade ayıklama özelliği işlevselliği şu anda uç nokta ve istek biçiminin dışında değişmemiştir.

Ayrıca bkz.