Sistem durumu projesi için özel Metin Analizi oluşturma

Sistem durumu için özel metin analiziyle başlama gereksinimlerini ayarlamayı ve proje oluşturmayı öğrenmek için bu makaleyi kullanın.

Önkoşullar

Sistem durumu için özel metin analizini kullanmaya başlamadan önce şunları yapmanız gerekir:

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

Dil kaynağı oluşturma

Sistem durumu için özel metin analizini kullanmaya başlamadan önce bir Azure Yapay Zeka Dili kaynağı gerekir. 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 sistem durumu için özel metin analiziyle çalışacak şekilde yapılandırmak için makalede daha fazla bilgi edinebilirsiniz.

Ayrıca, varlıkları ayıklamak için bir modeli eğitmek için kullanılacak belgelerinizi .txt karşıya yükleyebileceğiniz bir Azure depolama hesabına da ihtiyacınız olacaktır.

Not

• 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

Aşağıdaki yollarla kaynak oluşturabilirsiniz:

• Azure portal
• Language Studio
• PowerShell

Not

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

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 bu hizmeti 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.

   Veri Akışı Adı	Açıklama
   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	Dil kaynağınızın bölgesi. Örneğin, "Batı ABD 2".
   Veri Akışı Adı	Kaynağınız için bir ad.
   Fiyatlandırma katmanı	Dil kaynağınızın fiyatlandırma katmanı. Hizmeti denemek için Ücretsiz (F0) katmanını kullanabilirsiniz.

   Not

   "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.

4. Bu hizmetin bölümünde mevcut bir depolama hesabını seçin veya Yeni depolama hesabı'yı seçin. Bu değerler, üretim ortamlarında kullanmak isteyeceğiniz depolama hesabı değerlerini değil, kullanmaya başlamanıza yardımcı olmak için kullanılır. 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 + oluştur'u ve ardından Oluştur'u seçin.

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	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

Bu hizmeti kullanmak için, henüz bir Azure depolama hesabınız yoksa bir Azure depolama hesabı oluşturmanız gerekir.

PowerShell kullanarak yeni bir Dil kaynağı oluşturma

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.
sku	Kaynağınızın fiyatlandırma katmanı.
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.

Not

• 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

Bu kaynak aşağıdaki gereksinimleri karşılıyorsa, özel NER kullanmaya başlamak için mevcut bir Dil kaynağını kullanabilirsiniz:

Gereksinim	Açıklama
Bölgeler	Mevcut kaynağınızın desteklenen bölgelerden birinde sağlandığından emin olun. Aksi takdirde, bu bölgelerden birinde 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.

Sistem durumu için özel metin analizi 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 kimlik yönetimi olmalıdır. Azure portalını kullanarak etkinleştirmek için:

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.

Sistem durumu için özel metin analizini etkinleştirme

Azure portalından Özel metin sınıflandırması / Özel Adlandırılmış Varlık Tanıma / Sistem durumu için özel metin analizi ö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ı / Özel Adlandırılmış Varlık Tanıma / Özel metin analizi özelliğini etkinleştirme
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.

Gerekli rolleri ekleme

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.

Sistem durumu projesi için özel Metin Analizi oluşturma

Kaynak ve depolama kapsayıcınız yapılandırıldıktan sonra sistem durumu projesi için yeni bir özel metin analizi 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, projeyi içeri aktararak kullanmaya başlamak için bu verileri kullanabilirsiniz.

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. Yukarıdaki adımda oluşturduğunuz Dil kaynağını seçin.

2. Language Studio'nun Bilgileri ayıkla bölümünde Sistem durumu için Özel Metin Analizi'ı seçin.

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

   

4. Projenizdeki dosyaların 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

   İpucu

   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.

5. Yeni proje oluştur'u seçtikten 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.

   Not

   • Bu adımı, kullandığınız her yeni kaynak 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.

   

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

7. Verileri zaten etiketlediyseniz desteklenen biçime uydığından emin olun ve Evet, dosyalarım zaten etiketlendi ve JSON etiketleri dosyasını biçimlendirdim'i seçin ve açılan menüden etiketler dosyasını seçin. İleri'yi seçin. Hızlı Başlangıç'tan veri kümesini kullanıyorsanız JSON etiketleri dosyasının biçimlendirmesini gözden geçirmeniz gerekmez.

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

REST API'leri

Sistem durumu modeli için özel Metin Analizi 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.

Not

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.

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

Anahtar	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	CustomHealthcare	Proje türünüz.	CustomHealthcare
Çok dilli	true	Veri kümenizde birden çok dilde belgenizin olmasını sağlayan boole değeridir ve modeliniz dağıtıldığında modeli desteklenen herhangi bir dilde sorgulayabilirsiniz (eğitim belgelerinize dahil olmak zorunda değildir). Ç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.

Projeyi 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 Bilgileri ayıkla bölümünde Sistem durumu için özel metin analizi'ni 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.

   Not

   • 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. Projenizdeki dosyaların adı, açıklaması ve dili de dahil olmak üzere proje bilgilerini girin. Projenizin adını daha sonra değiştiremezsiniz. İleri'yi seçin.

   İpucu

   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.

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

7. Evet, dosyalarım 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.

8. İleri'yi seçin.

9. 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 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.

{
	"projectFileVersion": "{API-VERSION}",
	"stringIndexType": "Utf16CodeUnit",
	"metadata": {
		"projectName": "{PROJECT-NAME}",
		"projectKind": "CustomHealthcare",
		"description": "Trying out custom Text Analytics for health",
		"language": "{LANGUAGE-CODE}",
		"multilingual": true,
		"storageInputContainerName": "{CONTAINER-NAME}",
		"settings": {}
	},
	"assets": {
		"projectKind": "CustomHealthcare",
		"entities": [
			{
				"category": "Entity1",
				"compositionSetting": "{COMPOSITION-SETTING}",
				"list": {
					"sublists": [
						{
							"listKey": "One",
							"synonyms": [
								{
									"language": "en",
									"values": [
										"EntityNumberOne",
										"FirstEntity"
									]
								}
							]
						}
					]
				}
			},
			{
				"category": "Entity2"
			},
			{
				"category": "MedicationName",
				"list": {
					"sublists": [
						{
							"listKey": "research drugs",
							"synonyms": [
								{
									"language": "en",
									"values": [
										"rdrug a",
										"rdrug b"
									]
								}
							]

						}
					]
				}
				"prebuilts": "MedicationName"
			}
		],
		"documents": [
			{
				"location": "{DOCUMENT-NAME}",
				"language": "{LANGUAGE-CODE}",
				"dataset": "{DATASET}",
				"entities": [
					{
						"regionOffset": 0,
						"regionLength": 500,
						"labels": [
							{
								"category": "Entity1",
								"offset": 25,
								"length": 10
							},
							{
								"category": "Entity2",
								"offset": 120,
								"length": 8
							}
						]
					}
				]
			},
			{
				"location": "{DOCUMENT-NAME}",
				"language": "{LANGUAGE-CODE}",
				"dataset": "{DATASET}",
				"entities": [
					{
						"regionOffset": 0,
						"regionLength": 100,
						"labels": [
							{
								"category": "Entity2",
								"offset": 20,
								"length": 5
							}
						]
					}
				]
			}
		]
	}
}

Anahtar	Yer tutucu	Değer	Örnek
multilingual	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
projectName	{PROJECT-NAME}	Proje adı	myproject
storageInputContainerName	{CONTAINER-NAME}	Kapsayıcı adı	mycontainer
entities		Projede sahip olduğunuz tüm varlık türlerini içeren dizi. Bunlar, belgelerinizden içine ayıklanacak varlık türleridir.
category		Yeni varlık tanımları için kullanıcı tanımlı veya önceden oluşturulmuş varlıklar için önceden tanımlanmış olabilecek varlık türünün adı.
compositionSetting	{COMPOSITION-SETTING}	Varlığınızdaki birden çok bileşenin nasıl yönetileceğini tanımlayan kural. Seçenekler veya separateComponentsşeklindedircombineComponents.	combineComponents
list		Belirli bir varlık için projede sahip olduğunuz tüm alt listeleri içeren dizi. Listeler önceden oluşturulmuş varlıklara veya öğrenilen bileşenlere sahip yeni varlıklara eklenebilir.
sublists	[]	Alt listeleri içeren dizi. Her alt liste bir anahtar ve ilişkili değerleridir.	[]
listKey	One	Tahminde eşlenmiş eş anlamlılar listesi için normalleştirilmiş bir değer.	One
synonyms	[]	Tüm eş anlamlıları içeren dizi	Eşanlamlı
language	{LANGUAGE-CODE}	Alt listenizdeki eş anlamlının dil kodunu belirten bir dize. Projeniz çok dilli bir projeyse ve projenizdeki tüm diller için eş anlamlılar listenizi desteklemek istiyorsanız, eş anlamlılarınızı her dile açıkça eklemeniz gerekir. Desteklenen dil kodları hakkında daha fazla bilgi için bkz . Dil desteği .	en
values	"EntityNumberone", "FirstEntity"	Ayıklama için tam olarak eşleştirilecek ve liste anahtarıyla eşlenecek virgülle ayrılmış dizelerin listesi.	"EntityNumberone", "FirstEntity"
prebuilts	MedicationName	Önceden oluşturulmuş varlığı dolduran önceden oluşturulmuş bileşenin adı. Önceden oluşturulmuş varlıklar varsayılan olarak projenize otomatik olarak yüklenir, ancak bunları etiket dosyanızdaki liste bileşenleriyle genişletebilirsiniz.	MedicationName
documents		Projenizdeki tüm belgeleri ve her belge içinde etiketlenmiş varlıkların listesini içeren dizi.	[]
location	{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
dataset	{DATASET}	Eğitimden önce bölündüğünde bu dosyanın gideceği test kümesi . Bu alanın olası değerleri ve TestşeklindedirTrain.	Train
regionOffset		Metnin başlangıcının kapsayıcı karakter konumu.	0
regionLength		SıNıRlayıcı kutunun UTF16 karakterleri cinsinden uzunluğu. Eğitim yalnızca bu bölgedeki verileri dikkate alır.	500
category		Belirtilen metnin yayılma alanıyla ilişkilendirilmiş varlık türü.	Entity1
offset		Varlık metninin başlangıç konumu.	25
length		Varlığın UTF16 karakterleri cinsinden uzunluğu.	20
language	{LANGUAGE-CODE}	Projenizde kullanılan belgenin dil kodunu belirten dize. Projeniz çok dilli bir projeyse, belgelerin çoğunun dil kodunu seçin. Desteklenen dil kodları hakkında daha fazla bilgi için bkz . Dil desteği .	en

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ını 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 birincil kaynak anahtarınızı da alabilirsiniz.

   

REST API'leri

Proje ayrıntılarınızı almak için aşağıdaki GET isteğini kullanın. Aşağıdaki 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ü. 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.

Yanıt gövdesi

    {
        "createdDateTime": "2021-10-19T23:24:41.572Z",
        "lastModifiedDateTime": "2021-10-19T23:24:41.572Z",
        "lastTrainedDateTime": "2021-10-19T23:24:41.572Z",
        "lastDeployedDateTime": "2021-10-19T23:24:41.572Z",
        "projectKind": "CustomHealthcare",
        "storageInputContainerName": "{CONTAINER-NAME}",
        "projectName": "{PROJECT-NAME}",
        "multilingual": false,
        "description": "Project description",
        "language": "{LANGUAGE-CODE}"
    }

Değer	Yer tutucu	Veri Akışı Açıklaması	Örnek
projectKind	CustomHealthcare	Proje türünüz.	CustomHealthcare
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	true	Veri kümenizde birden çok dilde belgenizin olmasını sağlayan boole değeridir ve modeliniz dağıtıldığında modeli desteklenen herhangi bir dilde sorgulayabilirsiniz (eğitim belgelerinize dahil olmak zorunda değildir). Ç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.	en

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.

1. Sayfanın üst kısmında kullanmakta olduğunuz Dil hizmeti özelliğini
2. Silmek istediğiniz projeyi seçin
3. Üst 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 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.

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 çağrı, işin durumunu denetlemek için kullanılan operation-location üst bilgisi ile sonuçlanır.

Sonraki adımlar

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

• Şemanızı tanımladıktan sonra, model eğitimi, değerlendirme ve son olarak tahminlerde bulunmak için kullanılacak olan verilerinizi etiketlemeye başlayabilirsiniz.