Özel metin sınıflandırma projesi oluşturma

Özel metin sınıflandırmasıyla başlamak ve proje oluşturmak için gereksinimleri ayarlamayı öğrenmek için bu makaleyi kullanın.

Önkoşullar

Özel metin sınıflandırması kullanmaya başlamadan önce şunları yapmanız gerekir:

• Azure aboneliği - Ücretsiz bir abonelik oluşturun.

Dil kaynağı oluşturma

Özel metin sınıflandırması kullanmaya başlamadan önce bir Azure Yapay Zeka Dili kaynağına ihtiyacınız olacaktır. Azure portalında Dil kaynağınızı oluşturmanız ve buna bir depolama hesabı bağlamanız önerilir. Azure portalında kaynak oluşturmak, gerekli tüm izinler önceden yapılandırılmış bir Azure depolama hesabı oluşturmanıza olanak tanır. Ayrıca, önceden var olan bir kaynağı kullanmayı öğrenmek ve bunu özel metin sınıflandırmasıyla çalışacak şekilde yapılandırmak için makalede daha fazla bilgi edinebilirsiniz.

Ayrıca, bir modeli metni sınıflandırmak üzere eğitmek için kullanılacak belgelerinizi .txt karşıya yükleyebileceğiniz bir Azure depolama hesabına da ihtiyacınız olacaktır.

Dekont

• Dil kaynağı oluşturmak için kaynak grubunda sahip rolünün atanmış olması gerekir.
• Önceden var olan bir depolama hesabına bağlanacaksanız, bu hesaba atanmış bir sahip rolünüz olmalıdır.

Dil kaynağı oluşturma ve depolama hesabını bağlama

Dekont

Depolama hesabını Dil kaynağıyla ilişkilendirildikten sonra farklı bir kaynak grubuna veya aboneliğe taşımamalısınız.

Azure portalı

Azure portalından yeni kaynak oluşturma

1. Yeni bir Azure Yapay Zeka Dili kaynağı oluşturmak için Azure portalına gidin.

2. Açılan pencerede, özel özelliklerden Özel metin sınıflandırması ve özel adlandırılmış varlık tanıma'yı seçin. Ekranın alt kısmındaki kaynağınızı oluşturmak için Devam'ı seçin.

   

3. Aşağıdaki ayrıntıları içeren bir Dil kaynağı oluşturun.

   Adı	Gerekli değer
   Abonelik	Azure aboneliğiniz.
   Kaynak grubu	Kaynağınızı içerecek bir kaynak grubu. Mevcut bir tane kullanabilir veya yeni bir tane oluşturabilirsiniz.
   Bölge	Desteklenen bölgelerden biri. Örneğin, "Batı ABD 2".
   Adı	Kaynağınız için bir ad.
   Fiyatlandırma katmanı	Desteklenen fiyatlandırma katmanlarından biri. Hizmeti denemek için Ücretsiz (F0) katmanını kullanabilirsiniz.

   "Oturum açma hesabınız seçili depolama hesabının kaynak grubunun sahibi değil" iletisini alırsanız, Dil kaynağı oluşturabilmeniz için önce hesabınızın kaynak grubunda sahip rolü atanmış olması gerekir. Yardım için Azure aboneliğinizin sahibine başvurun.

   Kaynak grubunuzda arama yaparak ve ilişkili aboneliğin bağlantısını izleyerek Azure aboneliğinizin sahibini belirleyebilirsiniz. Ardından:

   1. Erişim Denetimi (IAM) sekmesini seçin
   2. Rol atamalarını seçin
   3. Role göre filtrele:Sahip.

4. Özel metin sınıflandırması & özel adlandırılmış varlık tanıma bölümünde mevcut bir depolama hesabını seçin veya Yeni depolama hesabı'nı seçin. Bu değerlerin, üretim ortamlarında kullanmak isteyeceğiniz depolama hesabı değerlerini değil, kullanmaya başlamanıza yardımcı olduğunu unutmayın. Projenizi oluştururken gecikme süresini önlemek için Dil kaynağınızla aynı bölgedeki depolama hesaplarına bağlanın.

   hesap değerini Depolama	Önerilen değer
   Depolama hesabı adı	Herhangi bir ad
   Storage account type	Standart LRS

5. Sorumlu Yapay Zeka Bildirimi'nin işaretli olduğundan emin olun. Sayfanın alt kısmındaki Gözden geçir ve oluştur'u seçin.

Language Studio

Language Studio'dan yeni bir Dil kaynağı oluşturma

İlk kez oturum açıyorsanız, Language Studio'da var olan bir Dil kaynağını seçmenize veya yeni bir kaynak oluşturmanıza olanak sağlayan bir pencere görürsünüz. Ayrıca sağ üst köşedeki ayarlar simgesine, Kaynaklar'a ve ardından Yeni kaynak oluştur'a tıklayarak da kaynak oluşturabilirsiniz.

Aşağıdaki ayrıntıları içeren bir Dil kaynağı oluşturun.

Örnek ayrıntısı	Gerekli değer
Azure aboneliği	Azure aboneliğiniz
Azure kaynak grubu	Azure kaynak grubunuz
Azure kaynak adı	Azure kaynağınızın adı
Konum	Dil kaynağınızın bulunduğu bölge.
Fiyatlandırma katmanı	Dil kaynağınızın fiyatlandırma katmanı.

Önemli

• Dil kaynağı oluştururken Yönetilen Kimliği etkinleştirdiğinizden emin olun.
• Sorumlu yapay zeka bildirimini okuyun ve onaylayın

Özel metin sınıflandırmasını kullanmak için kaynağınızı bir depolama hesabına bağlamanız gerekir. Hesabınız yoksa bir Azure depolama hesabı oluşturabilirsiniz. İlk projenizi oluşturmak ve depolama hesabınızı bağlamak için aşağıdaki adımları kullanın.

1. Language Studio'da oturum açın. Aboneliğinizi ve Dil kaynağınızı seçmenizi sağlayacak bir pencere görüntülenir. Dil kaynağınızı seçin.

2. Language Studio'nun Metni sınıflandır bölümünde Özel metin sınıflandırması'nı seçin.

   

3. Projeler sayfanızın üst menüsünden Yeni proje oluştur'u seçin. Proje oluşturmak, modellerinizi etiketlemenize, eğitmenize, değerlendirmenize, geliştirmenize ve dağıtmanıza olanak tanır.

   

4. Yeni proje oluştur'a tıkladıktan sonra, depolama hesabınızı bağlamanıza olanak sağlayan bir pencere görüntülenir. Zaten bir depolama hesabı bağladıysanız, hesaplanmış depolamanın bağlı olduğunu görürsünüz. Aksi takdirde, görüntülenen açılan listeden depolama hesabınızı seçin ve Bağlan depolama hesabını seçin; bu işlem depolama hesabınız için gerekli rolleri ayarlar. Depolama hesabında sahip olarak atanmadıysanız bu adım büyük olasılıkla bir hata döndürür.

   Dekont

   • Bu adımı, kullandığınız her yeni dil kaynağı için yalnızca bir kez yapmanız gerekir.
   • Bu işlem geri alınamaz. Bir depolama hesabını Dil kaynağınıza bağlarsanız daha sonra bağlantısını kesemezsiniz.
   • Dil kaynağınızı yalnızca bir depolama hesabına bağlayabilirsiniz.

   

5. Proje türünü seçin. Her belgenin bir veya daha fazla sınıfa ait olabileceği çok etiketli sınıflandırma projesi veya her belgenin yalnızca bir sınıfa ait olabileceği Tek etiketli sınıflandırma projesi oluşturabilirsiniz. Seçili tür daha sonra değiştirilemez. Proje türleri hakkında daha fazla bilgi edinin

   

6. Projenizdeki belgelerin adı, açıklaması ve dili de dahil olmak üzere proje bilgilerini girin. Örnek veri kümesini kullanıyorsanız İngilizce'yi seçin. Projenizin adını daha sonra değiştiremezsiniz. İleri'yi seçin.

   Bahşiş

   Veri kümenizin tamamen aynı dilde olması gerekmez. Her birinde desteklenen farklı dillere sahip birden çok belgeniz olabilir. Veri kümeniz farklı dillerde belgeler içeriyorsa veya çalışma zamanı sırasında farklı dillerden metin bekliyorsanız, projeniz için temel bilgileri girerken çok dilli veri kümesini etkinleştir seçeneğini belirleyin. Bu seçenek daha sonra Proje ayarları sayfasından etkinleştirilebilir.

7. Veri kümenizi yüklediğiniz kapsayıcıyı seçin.

   Dekont

   Verilerinizi zaten etiketlediyseniz desteklenen biçime uydığından emin olun ve Evet, belgelerim zaten etiketlendi ve JSON etiketleri dosyasını biçimlendirdim'i seçin ve aşağıdaki açılan menüden etiketler dosyasını seçin.

   Örnek veri kümelerinden birini kullanıyorsanız, dahil webOfScience_labelsFile edilen veya movieLabels json dosyasını kullanın. Sonra İleri'yi seçin.

8. Girdiğiniz verileri gözden geçirin ve Proje Oluştur'u seçin.

Azure PowerShell’i kullanma

GitHub'da barındırılan aşağıdaki CLI şablonu ve parametre dosyalarını kullanarak yeni bir kaynak ve depolama hesabı oluşturabilirsiniz.

Parametre dosyasında aşağıdaki değerleri düzenleyin:

Parametre adı	Değer, açıklama
name	Dil kaynağınızın adı
location	Kaynağınızın barındırıldığı bölge. Daha fazla bilgi için bkz . bölge desteği .
sku	Kaynağınızın fiyatlandırma katmanı. Daha fazla bilgi için bkz . hizmet sınırları .
storageResourceName	Depolama hesabınızın adı
storageLocation	Depolama hesabınızın barındırıldığı bölge.
storageSkuType	Depolama hesabınızın SKU'su.
storageResourceGroupName	Depolama hesabınızın kaynak grubu

Azure Resource Manager (ARM) şablonunu düzenlediğiniz dosyalarla dağıtmak için aşağıdaki PowerShell komutunu kullanın.

New-AzResourceGroupDeployment -Name ExampleDeployment -ResourceGroupName ExampleResourceGroup `
  -TemplateFile <path-to-arm-template> `
  -TemplateParameterFile <path-to-parameters-file>

Şablonları ve parametre dosyalarını dağıtma hakkında bilgi için ARM şablonu belgelerine bakın.

Dekont

• Bir depolama hesabını Dil kaynağınıza bağlama işlemi geri alınamaz, daha sonra bağlantısı kesilemez.
• Dil kaynağınızı yalnızca bir depolama hesabına bağlayabilirsiniz.

Önceden var olan bir Dil kaynağını kullanma

Gereksinim	Açıklama
Bölgeler	Mevcut kaynağınızın desteklenen bölgelerden birinde sağlandığından emin olun. Kaynağınız yoksa desteklenen bir bölgede yeni bir kaynak oluşturmanız gerekir.
Fiyatlandırma katmanı	Kaynağınızın fiyatlandırma katmanı.
Yönetilen kimlik	Kaynağın yönetilen kimlik ayarının etkinleştirildiğinden emin olun. Aksi takdirde, sonraki bölümü okuyun.

Özel metin sınıflandırmasını kullanmak için , henüz bir Azure depolama hesabınız yoksa bir Azure depolama hesabı oluşturmanız gerekir.

Kaynağınız için kimlik yönetimini etkinleştirme

Azure portalı

Dil kaynağınızın Azure portalını kullanarak etkinleştirmek için kimlik yönetimine sahip olması gerekir:

1. Dil kaynağınıza gidin
2. Sol taraftaki menüden Kaynak Yönetimi bölümü altında Kimlik'i seçin
3. Sistem tarafından atanan sekmesinde Durum'un Açık olarak ayarlandığından emin olun

Language Studio

Language Studio kullanarak etkinleştirmek için Dil kaynağınızın kimlik yönetimi olmalıdır:

1. Ekranın sağ üst köşesindeki ayarlar simgesini seçin
2. Kaynaklar'ı seçin
3. Azure AI Dil kaynağınız için Yönetilen Kimlik onay kutusunu seçin.

Özel metin sınıflandırma özelliğini etkinleştirme

Azure portalından Özel metin sınıflandırması / Özel Adlandırılmış Varlık Tanıma özelliğini etkinleştirdiğinizden emin olun.

1. Azure portalında Dil kaynağınıza gidin
2. Sol taraftaki menüden Kaynak Yönetimi bölümünde Özellikler'i seçin
3. Özel metin sınıflandırmasını etkinleştir / Özel Adlandırılmış Varlık Tanıma özelliği
4. Depolama hesabınızı Bağlan
5. Seçin Uygula

Önemli

• Dil kaynağınızda , bağlanmakta olduğunuz depolama hesabında depolama blobu veri katkıda bulunanı rolü atandığından emin olun.

Azure AI Dil kaynağınız ve depolama hesabınız için rolleri ayarlama

Dil kaynağınız ve depolama hesabınız için gerekli rolleri ayarlamak için aşağıdaki adımları kullanın.

Azure AI Dil kaynağınız için roller

1. Azure portalında depolama hesabınıza veya Dil kaynağınıza gidin.

2. Sol gezinti menüsünde Erişim Denetimi (IAM) öğesini seçin.

3. Rol Atamaları Eklemek için Ekle'yi seçin ve hesabınız için uygun rolü seçin.

   Dil kaynağınızda sahip veya katkıda bulunan rolü atanmış olmalıdır.

4. Erişim ata bölümünde Kullanıcı, grup veya hizmet sorumlusu'na tıklayın

5. Üye seç'i seçin

6. Kullanıcı adınızı seçin. Kullanıcı adlarını Seç alanında arayabilirsiniz . Bunu tüm roller için yineleyin.

7. Bu kaynağa erişmesi gereken tüm kullanıcı hesapları için bu adımları yineleyin.

Depolama hesabınız için roller

1. Azure portalında depolama hesabı sayfanıza gidin.
2. Sol gezinti menüsünde Erişim Denetimi (IAM) öğesini seçin.
3. Rol Atamaları Eklemek için Ekle'yi seçin ve depolama hesabında Depolama blob verileri katkıda bulunan rolünü seçin.
4. Erişim ata'nın içinde Yönetilen kimlik'i seçin.
5. Üye seç'i seçin
6. Aboneliğinizi ve yönetilen kimlik olarak Dil'i seçin. Kullanıcı adlarını Seç alanında arayabilirsiniz .

Önemli

Sanal ağınız veya özel uç noktanız varsa, Güvenilen hizmetler listesindeki Azure hizmetlerinin Azure portalında bu depolama hesabına erişmesine izin ver'i seçtiğinizden emin olun.

Depolama hesabınız için CORS'yi etkinleştirme

Çıkış Noktaları Arası Kaynak Paylaşımı'nı (CORS) etkinleştirirken (GET, PUT, DELETE) yöntemlerine izin verdiğinizden emin olun. İzin verilen çıkış noktaları alanını olarak https://language.cognitive.azure.comayarlayın. İzin verilen üst bilgi değerlerine ekleyerek * tüm üst bilgilere izin verin ve en büyük yaşı olarak 500ayarlayın.

Özel metin sınıflandırma projesi oluşturma

Kaynak ve depolama kapsayıcınız yapılandırıldıktan sonra yeni bir özel metin sınıflandırma projesi oluşturun. Proje, verilerinize göre özel yapay zeka modellerinizi oluşturmaya yönelik bir çalışma alanıdır. Projenize yalnızca siz ve kullanılmakta olan Azure kaynağına erişimi olan diğer kişiler erişebilir. Verileri etiketlediyseniz, kullanmaya başlamak için verileri içeri aktarabilirsiniz.

Language Studio

1. Language Studio'da oturum açın. Aboneliğinizi ve Dil kaynağınızı seçmenizi sağlayacak bir pencere görüntülenir. Dil kaynağınızı seçin.

2. Language Studio'nun Metni sınıflandır bölümünde Özel metin sınıflandırması'nı seçin.

   

3. Projeler sayfanızın üst menüsünden Yeni proje oluştur'u seçin. Proje oluşturmak, modellerinizi etiketlemenize, eğitmenize, değerlendirmenize, geliştirmenize ve dağıtmanıza olanak tanır.

   

4. Yeni proje oluştur'a tıkladıktan sonra, depolama hesabınızı bağlamanıza olanak sağlayan bir pencere görüntülenir. Zaten bir depolama hesabı bağladıysanız, hesaplanmış depolamanın bağlı olduğunu görürsünüz. Aksi takdirde, görüntülenen açılan listeden depolama hesabınızı seçin ve Bağlan depolama hesabını seçin; bu işlem depolama hesabınız için gerekli rolleri ayarlar. Depolama hesabında sahip olarak atanmadıysanız bu adım büyük olasılıkla bir hata döndürür.

   Dekont

   • Bu adımı, kullandığınız her yeni dil kaynağı için yalnızca bir kez yapmanız gerekir.
   • Bu işlem geri alınamaz. Bir depolama hesabını Dil kaynağınıza bağlarsanız daha sonra bağlantısını kesemezsiniz.
   • Dil kaynağınızı yalnızca bir depolama hesabına bağlayabilirsiniz.

   

5. Proje türünü seçin. Her belgenin bir veya daha fazla sınıfa ait olabileceği çok etiketli sınıflandırma projesi veya her belgenin yalnızca bir sınıfa ait olabileceği Tek etiketli sınıflandırma projesi oluşturabilirsiniz. Seçili tür daha sonra değiştirilemez. Proje türleri hakkında daha fazla bilgi edinin

   

6. Projenizdeki belgelerin adı, açıklaması ve dili de dahil olmak üzere proje bilgilerini girin. Örnek veri kümesini kullanıyorsanız İngilizce'yi seçin. Projenizin adını daha sonra değiştiremezsiniz. İleri'yi seçin.

   Bahşiş

   Veri kümenizin tamamen aynı dilde olması gerekmez. Her birinde desteklenen farklı dillere sahip birden çok belgeniz olabilir. Veri kümeniz farklı dillerde belgeler içeriyorsa veya çalışma zamanı sırasında farklı dillerden metin bekliyorsanız, projeniz için temel bilgileri girerken çok dilli veri kümesini etkinleştir seçeneğini belirleyin. Bu seçenek daha sonra Proje ayarları sayfasından etkinleştirilebilir.

7. Veri kümenizi yüklediğiniz kapsayıcıyı seçin.

   Dekont

   Verilerinizi zaten etiketlediyseniz desteklenen biçime uydığından emin olun ve Evet, belgelerim zaten etiketlendi ve JSON etiketleri dosyasını biçimlendirdim'i seçin ve aşağıdaki açılan menüden etiketler dosyasını seçin.

   Örnek veri kümelerinden birini kullanıyorsanız, dahil webOfScience_labelsFile edilen veya movieLabels json dosyasını kullanın. Sonra İleri'yi seçin.

8. Girdiğiniz verileri gözden geçirin ve Proje Oluştur'u seçin.

REST API'leri

Özel metin sınıflandırma modeli oluşturmaya başlamak için bir proje oluşturmanız gerekir. Proje oluşturmak, modellerinizi etiketlemenize, eğitmenize, değerlendirmenize, geliştirmenize ve dağıtmanıza olanak tanır.

Dekont

Proje adı tüm işlemler için büyük/küçük harfe duyarlıdır.

Projenizi oluşturmak için aşağıdaki URL' yi, üst bilgileri ve JSON gövdesini kullanarak bir PATCH isteği oluşturun.

İstek URL'si

Proje oluşturmak için aşağıdaki URL'yi kullanın. Aşağıdaki yer tutucu değerlerini kendi değerlerinizle değiştirin.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}?api-version={API-VERSION}

Yer tutucu	Değer	Örnek
{ENDPOINT}	API isteğinizin kimliğini doğrulamak için uç nokta.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	myProject
{API-VERSION}	Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüme yöneliktir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinmek için bkz . Model yaşam döngüsü .	2022-05-01

Üst Bilgiler

İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.

Anahtar	Değer
Ocp-Apim-Subscription-Key	Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır.

Gövde

İsteğinizde aşağıdaki JSON'yi kullanın. Aşağıdaki yer tutucu değerlerini kendi değerlerinizle değiştirin.

Çok etiketli sınıflandırma

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "customMultiLabelClassification",
  "description": "Project description",
  "multilingual": "True",
  "storageInputContainerName": "{CONTAINER-NAME}"
}

Tuş	Yer tutucu	Değer	Örnek
projectName	{PROJECT-NAME}	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	myProject
dil	{LANGUAGE-CODE}	Projenizde kullanılan belgelerin dil kodunu belirten bir dize. Projeniz çok dilli bir projeyse, belgelerin çoğunun dil kodunu seçin. Desteklenen dil kodları hakkında daha fazla bilgi edinmek için bkz . dil desteği .	en-us
projectKind	customMultiLabelClassification	Proje türünüz.	customMultiLabelClassification
Çok dilli	true	Veri kümenizde birden çok dilde belge olmasını sağlayan boole değeridir ve modeliniz dağıtıldığında modeli desteklenen herhangi bir dilde sorgulayabilirsiniz (eğitim belgelerinize dahil olması gerekmez). Çok dilli destek hakkında daha fazla bilgi edinmek için bkz. dil desteği.	true
storageInputContainerName	{CONTAINER-NAME}	Belgelerinizi yüklediğiniz Azure depolama kapsayıcınızın adı.	myContainer

Tek etiketli sınıflandırma

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "customSingleLabelClassification",
  "description": "Project description",
  "multilingual": "True",
  "storageInputContainerName": "{CONTAINER-NAME}"
}

Tuş	Yer tutucu	Değer	Örnek
projectName	{PROJECT-NAME}	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	myProject
dil	{LANGUAGE-CODE}	Projenizde kullanılan belgelerin dil kodunu belirten bir dize. Projeniz çok dilli bir projeyse, belgelerin çoğunun dil kodunu seçin. Desteklenen dil kodları hakkında daha fazla bilgi edinmek için bkz . dil desteği .	en-us
projectKind	customSingleLabelClassification	Proje türünüz.	customSingleLabelClassification
Çok dilli	true	Veri kümenizde birden çok dilde belge olmasını sağlayan boole değeridir ve modeliniz dağıtıldığında modeli desteklenen herhangi bir dilde sorgulayabilirsiniz (eğitim belgelerinize dahil olması gerekmez). Çok dilli destek hakkında daha fazla bilgi edinmek için bkz. dil desteği.	true
storageInputContainerName	{CONTAINER-NAME}	Belgelerinizi yüklediğiniz Azure depolama kapsayıcınızın adı.	myContainer

Bu istek bir 201 yanıtı döndürür ve bu da projenin oluşturulduğu anlamına gelir.

Bu istek şu durumda bir hata döndürür:

• Seçilen kaynağın depolama hesabı için uygun izni yok.

Özel metin sınıflandırma projesini içeri aktarma

Verileri zaten etiketlediyseniz, hizmeti kullanmaya başlamak için kullanabilirsiniz. Etiketli verilerinizin kabul edilen veri biçimlerini izlediğinden emin olun.

Language Studio

1. Language Studio'da oturum açın. Aboneliğinizi ve Dil kaynağınızı seçmenizi sağlayacak bir pencere görüntülenir. Dil kaynağınızı seçin.

2. Language Studio'nun Metni sınıflandır bölümünde Özel metin sınıflandırması'nı seçin.

   

3. Projeler sayfanızın üst menüsünden Yeni proje oluştur'u seçin. Proje oluşturmak, modellerinizi etiketlemenize, eğitmenize, değerlendirmenize, geliştirmenize ve dağıtmanıza olanak tanır.

   

4. Yeni proje oluştur'u seçtikten sonra, depolama hesabınızı bağlamanıza olanak sağlayan bir ekran görüntülenir. Depolama hesabınızı bulamıyorsanız, önerilen adımları kullanarak bir kaynak oluşturduğunuzdan emin olun. Dil kaynağınıza zaten bir depolama hesabı bağladıysanız depolama hesabınızın bağlı olduğunu görürsünüz.

   Dekont

   • Bu adımı, kullandığınız her yeni dil kaynağı için yalnızca bir kez yapmanız gerekir.
   • Bu işlem geri alınamaz. Bir depolama hesabını Dil kaynağınıza bağlarsanız daha sonra bağlantısını kesemezsiniz.
   • Dil kaynağınızı yalnızca bir depolama hesabına bağlayabilirsiniz.

   

5. Proje türünü seçin. Her belgenin bir veya daha fazla sınıfa ait olabileceği çok etiketli sınıflandırma projesi veya her belgenin yalnızca bir sınıfa ait olabileceği Tek etiketli sınıflandırma projesi oluşturabilirsiniz. Seçili tür daha sonra değiştirilemez.

   

6. Projenizdeki belgelerin adı, açıklaması ve dili de dahil olmak üzere proje bilgilerini girin. Projenizin adını daha sonra değiştiremezsiniz. İleri'yi seçin.

   Bahşiş

   Veri kümenizin tamamen aynı dilde olması gerekmez. Her birinde desteklenen farklı dillere sahip birden çok belgeniz olabilir. Veri kümeniz farklı dillerde belgeler içeriyorsa veya çalışma zamanı sırasında farklı dillerden metin bekliyorsanız, projeniz için temel bilgileri girerken çok dilli veri kümesini etkinleştir seçeneğini belirleyin. Bu seçenek daha sonra Proje ayarları sayfasından etkinleştirilebilir.

7. Veri kümenizi yüklediğiniz kapsayıcıyı seçin.

8. Evet, belgelerim zaten etiketlenmiş ve JSON etiketleri dosyasını biçimlendirdim'i seçin ve JSON etiketleri dosyanızı içeri aktarmak için aşağıdaki açılan menüden etiketler dosyasını seçin. Desteklenen biçime uydığından emin olun.

9. İleri'yi seçin.

10. Girdiğiniz verileri gözden geçirin ve Proje Oluştur'u seçin.

REST API'leri

Etiket dosyanızı içeri aktarmak için aşağıdaki URL'yi, üst bilgileri ve JSON gövdesini kullanarak bir POST isteği gönderin. Etiketler dosyanızın kabul edilen biçime uygun olduğundan emin olun.

Aynı ada sahip bir proje zaten varsa, o projenin verileri değiştirilir.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}/:import?api-version={API-VERSION}

Yer tutucu	Değer	Örnek
{ENDPOINT}	API isteğinizin kimliğini doğrulamak için uç nokta.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	myProject
{API-VERSION}	Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüme yöneliktir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinin	2022-05-01

Üst Bilgiler

İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.

Anahtar	Değer
Ocp-Apim-Subscription-Key	Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır.

Gövde

İsteğinizde aşağıdaki JSON'yi kullanın. Aşağıdaki yer tutucu değerlerini kendi değerlerinizle değiştirin.

Çok etiketli sınıflandırma

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectName": "{PROJECT-NAME}",
    "storageInputContainerName": "{CONTAINER-NAME}",
    "projectKind": "customMultiLabelClassification",
    "description": "Trying out custom multi label text classification",
    "language": "{LANGUAGE-CODE}",
    "multilingual": true,
    "settings": {}
  },
  "assets": {
    "projectKind": "customMultiLabelClassification",
    "classes": [
      {
        "category": "Class1"
      },
      {
        "category": "Class2"
      }
    ],
    "documents": [
      {
        "location": "{DOCUMENT-NAME}",
        "language": "{LANGUAGE-CODE}",
        "dataset": "{DATASET}",
        "classes": [
          {
            "category": "Class1"
          },
          {
            "category": "Class2"
          }
        ]
      },
      {
        "location": "{DOCUMENT-NAME}",
        "language": "{LANGUAGE-CODE}",
        "dataset": "{DATASET}",
        "classes": [
          {
            "category": "Class2"
          }
        ]
      }
    ]
  }
}

Tuş	Yer tutucu	Değer	Örnek
api-sürümü	{API-VERSION}	Çağırdığınız API'nin sürümü. Burada kullanılan sürüm, URL'de aynı API sürümü olmalıdır. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinin	2022-05-01
projectName	{PROJECT-NAME}	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	myProject
projectKind	customMultiLabelClassification	Proje türünüz.	customMultiLabelClassification
dil	{LANGUAGE-CODE}	Projenizde kullanılan belgelerin dil kodunu belirten bir dize. Projeniz çok dilli bir projeyse, belgelerin çoğunun dil kodunu seçin. Çok dilli destek hakkında daha fazla bilgi edinmek için bkz. dil desteği.	en-us
Çok dilli	true	Veri kümenizde birden çok dilde belge olmasını sağlayan boole değeridir ve modeliniz dağıtıldığında modeli desteklenen herhangi bir dilde sorgulayabilirsiniz (eğitim belgelerinize dahil olması gerekmez). Çok dilli destek hakkında daha fazla bilgi edinmek için bkz. dil desteği.	true
storageInputContainerName	{CONTAINER-NAME}	Belgelerinizi yüklediğiniz Azure depolama kapsayıcınızın adı.	myContainer
sınıflar	[]	Projede sahip olduğunuz tüm sınıfları içeren dizi. Bunlar, belgelerinizi sınıflandırmak istediğiniz sınıflardır.	[]
documents	[]	Projenizdeki tüm belgeleri ve bu belge için etiketlenen sınıfları içeren dizi.	[]
konum	{DOCUMENT-NAME}	Depolama kapsayıcısında belgelerin konumu. Tüm belgeler kapsayıcının kökünde olduğundan, belge adı bu olmalıdır.	doc1.txt
veri kümesi	{DATASET}	Eğitimden önce bölündüğünde bu belgenin gideceği test kümesi. Veri bölme hakkında daha fazla bilgi için bkz . Modeli eğitme. Bu alanın olası değerleri ve TestşeklindedirTrain.	Train

Tek etiketli sınıflandırma

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectName": "{PROJECT-NAME}",
    "storageInputContainerName": "{CONTAINER-NAME}",
    "projectKind": "customSingleLabelClassification",
    "description": "Trying out custom multi label text classification",
    "language": "{LANGUAGE-CODE}",
    "multilingual": true,
    "settings": {}
  },
  "assets": {
    "projectKind": "customSingleLabelClassification",
        "classes": [
            {
                "category": "Class1"
            },
            {
                "category": "Class2"
            }
        ],
        "documents": [
            {
                "location": "{DOCUMENT-NAME}",
                "language": "{LANGUAGE-CODE}",
                "dataset": "{DATASET}",
                "class": {
                    "category": "Class2"
                }
            },
            {
                "location": "{DOCUMENT-NAME}",
                "language": "{LANGUAGE-CODE}",
                "dataset": "{DATASET}",
                "class": {
                    "category": "Class1"
                }
            }
        ]
    }
}

Tuş	Yer tutucu	Değer	Örnek
api-sürümü	{API-VERSION}	Çağırdığınız API'nin sürümü. Burada kullanılan sürüm, URL'de aynı API sürümü olmalıdır.	2022-05-01
projectName	{PROJECT-NAME}	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	myProject
projectKind	customSingleLabelClassification	Proje türünüz.	customSingleLabelClassification
dil	{LANGUAGE-CODE}	Projenizde kullanılan belgelerin dil kodunu belirten bir dize. Projeniz çok dilli bir projeyse, belgelerin çoğunun dil kodunu seçin. Desteklenen dil kodları hakkında daha fazla bilgi edinmek için bkz . dil desteği .	en-us
Çok dilli	true	Veri kümenizde birden çok dilde belge olmasını sağlayan boole değeridir ve modeliniz dağıtıldığında modeli desteklenen herhangi bir dilde sorgulayabilirsiniz (eğitim belgelerinize dahil olması gerekmez). Çok dilli destek hakkında daha fazla bilgi edinmek için bkz. dil desteği.	true
storageInputContainerName	{CONTAINER-NAME}	Belgelerinizi yüklediğiniz Azure depolama kapsayıcınızın adı.	myContainer
sınıflar	[]	Projede sahip olduğunuz tüm sınıfları içeren dizi. Bunlar, belgelerinizi sınıflandırmak istediğiniz sınıflardır.	[]
documents	[]	Projenizdeki tüm belgeleri ve bu belgenin hangi sınıfa ait olduğunu içeren dizi.	[]
konum	{DOCUMENT-NAME}	Depolama kapsayıcısında belgelerin konumu. Tüm belgeler kapsayıcının kökünde olduğundan, belge adı bu olmalıdır.	doc1.txt
veri kümesi	{DATASET}	Eğitimden önce bölündüğünde bu belgenin gideceği test kümesi. Veri bölme hakkında daha fazla bilgi edinmek için bkz . Modeli eğitme. Bu alanın olası değerleri ve TestşeklindedirTrain.	Train

API isteğinizi gönderdikten sonra, işin doğru şekilde gönderildiğini belirten bir 202 yanıt alırsınız. Yanıt üst bilgilerinde değeri ayıklayın operation-location . Şu şekilde biçimlendirilir:

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}

{JOB-ID} bu işlem zaman uyumsuz olduğundan isteğinizi tanımlamak için kullanılır. İçeri aktarma işi durumunu almak için bu URL'yi kullanacaksınız.

Bu istek için olası hata senaryoları:

• Seçilen kaynağın depolama hesabı için uygun izinleri yok.
• Belirtilen storageInputContainerName yok.
• Geçersiz dil kodu kullanılır veya dil kodu türü dize değilse.
• multilingual değeri boole değil bir dizedir.

Proje ayrıntılarını alma

Language Studio

1. Language Studio'da proje ayarları sayfanıza gidin.

2. Proje ayrıntılarını görebilirsiniz.

3. Bu sayfada proje açıklaması güncelleştirebilir ve proje ayarlarında Çok dilli veri kümesini etkinleştirebilir/devre dışı bırakabilirsiniz.

4. Dil kaynağınıza bağlı depolama hesabını ve kapsayıcıyı da görüntüleyebilirsiniz.

5. Bu sayfadan kaynak birincil anahtarınızı da alabilirsiniz.

   

REST API'leri

Özel metin sınıflandırma projesi ayrıntılarını almak için aşağıdaki URL'yi ve üst bilgileri kullanarak bir GET isteği gönderin. Yer tutucu değerlerini kendi değerlerinizle değiştirin.

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}?api-version={API-VERSION}

Yer tutucu	Değer	Örnek
{ENDPOINT}	API isteğinizin kimliğini doğrulamak için uç nokta.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	myProject
{API-VERSION}	Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, en son yayımlanan model sürümüne yöneliktir.	2022-05-01

Üst Bilgiler

İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.

Anahtar	Değer
Ocp-Apim-Subscription-Key	Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır.

Yanıt Gövdesi

İsteği gönderdikten sonra aşağıdaki yanıtı alırsınız.

{
  "createdDateTime": "2022-04-23T13:39:09.384Z",
  "lastModifiedDateTime": "2022-04-23T13:39:09.384Z",
  "lastTrainedDateTime": "2022-04-23T13:39:09.384Z",
  "lastDeployedDateTime": "2022-04-23T13:39:09.384Z",
  "projectKind": "customSingleLabelClassification",
  "storageInputContainerName": "{CONTAINER-NAME}",
  "projectName": "{PROJECT-NAME}",
  "multilingual": true,
  "description": "Project description",
  "language": "{LANGUAGE-CODE}"
}

Değer	Yer tutucu	Veri Akışı Açıklaması	Örnek
projectKind	customSingleLabelClassification	Proje türünüz.	Bu değer veya customMultiLabelClassificationolabilircustomSingleLabelClassification.
storageInputContainerName	{CONTAINER-NAME}	Belgelerinizi yüklediğiniz Azure depolama kapsayıcınızın adı.	myContainer
projectName	{PROJECT-NAME}	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	myProject
multilingual		Veri kümenizde birden çok dilde belge olmasını sağlayan boole değeri. Modeliniz dağıtıldığında, modeli desteklenen herhangi bir dilde sorgulayabilirsiniz (eğitim belgelerinize dahil olması gerekmez. Çok dilli destek hakkında daha fazla bilgi için bkz . dil desteği.	true
language	{LANGUAGE-CODE}	Projenizde kullanılan belgelerin dil kodunu belirten bir dize. Projeniz çok dilli bir projeyse, belgelerin çoğunun dil kodunu seçin. Desteklenen dil kodları hakkında daha fazla bilgi edinmek için bkz . dil desteği .	en-us

API isteğinizi gönderdikten sonra, başarılı olduğunu ve proje ayrıntılarınızla birlikte JSON yanıt gövdesini belirten bir 200 yanıt alırsınız.

Projeyi silme

Language Studio

Projenize artık ihtiyacınız olmadığında, Language Studio'yu kullanarak projenizi silebilirsiniz. Üst kısımdaki Özel metin sınıflandırması'nı ve ardından silmek istediğiniz projeyi seçin. Projeyi silmek için üstteki menüden Sil'i seçin.

REST API'leri

Projenize artık ihtiyacınız kalmadığında, aşağıdaki DELETE isteğiyle silebilirsiniz. Yer tutucu değerlerini kendi değerlerinizle değiştirin.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}?api-version={API-VERSION}

Yer tutucu	Değer	Örnek
{ENDPOINT}	API isteğinizin kimliğini doğrulamak için uç nokta.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	myProject
{API-VERSION}	Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüme yöneliktir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinin	2022-05-01

Üst Bilgiler

İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.

Anahtar	Değer
Ocp-Apim-Subscription-Key	Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır.

API isteğinizi gönderdikten sonra başarılı olduğunu belirten bir 202 yanıt alırsınız ve bu da projenizin silindiği anlamına gelir. Başarılı bir arama, işin durumunu denetlemek için kullanılan üst Operation-Location bilgiyle sonuçlanır.

Sonraki adımlar

• Verilerinizi etiketlemek için kullanacağınız proje şeması hakkında bir fikriniz olmalıdır.

• Projeniz oluşturulduktan sonra verilerinizi etiketlemeye başlayabilirsiniz. Bu, metin sınıflandırma modelinize metin yorumlamayı bildirir ve eğitim ve değerlendirme için kullanılır.