sağlık için özel Metin Analizi modelinizi eğitin

Eğitim, modelin etiketlenmiş verilerinizden öğrendiği işlemdir. Eğitim tamamlandıktan sonra modelinizi geliştirmeniz gerekip gerekmediğini belirlemek için modelin performansını görüntüleyebileceksiniz.

Modeli eğitmek için bir eğitim işi başlatırsınız ve yalnızca başarıyla tamamlanan işler bir model oluşturur. Eğitim işlerinin süresi yedi gün sonra dolar. Bu, bu sürenin sonunda iş ayrıntılarını alamayacağınız anlamına gelir. Eğitim işiniz başarıyla tamamlandıysa ve bir model oluşturulduysa, model etkilenmez. Aynı anda yalnızca bir eğitim işi çalıştırabilirsiniz ve aynı projedeki diğer işleri başlatamazsınız.

Eğitim süreleri, veri kümesi boyutuna ve şemanızın karmaşıklığına bağlı olarak birkaç saate kadar birkaç belgeyle ilgilenirken birkaç dakika içinde olabilir.

Önkoşullar

• Yapılandırılmış bir Azure blob depolama hesabıyla başarıyla oluşturulmuş bir proje
• Depolama hesabınıza yüklenmiş metin verileri.
• Etiketli veriler

Daha fazla bilgi için bkz. proje geliştirme yaşam döngüsü .

Veri bölme

Eğitim işlemine başlamadan önce, projenizdeki etiketli belgeler bir eğitim kümesine ve bir test kümesine bölünür. Her biri farklı bir işleve hizmet eder. Eğitim kümesi modeli eğitmek için kullanılır. Bu küme, modelin etiketlenmiş varlıkları ve hangi metin aralıklarının varlık olarak ayıklandığını öğrendiği kümedir. Test kümesi, eğitim sırasında değil yalnızca değerlendirme sırasında modele tanıtılmayan bir kör kümedir. Model eğitimi başarıyla tamamlandıktan sonra model, testteki belgelerden tahmin yapmak için kullanılır ve bu tahmin değerlendirme ölçümleri temel alınarak hesaplanır. Model eğitimi ve değerlendirmesi yalnızca öğrenilen bileşenlere sahip yeni tanımlanmış varlıklar içindir; bu nedenle, sistem durumu varlıkları için Metin Analizi, önceden oluşturulmuş bileşenlere sahip varlıklar olmaları nedeniyle model eğitimi ve değerlendirmesinin dışında tutulur. Etiketlenmiş tüm varlıklarınızın hem eğitim hem de test kümesinde yeterli şekilde temsil edilmesi önerilir.

Sistem durumu için özel Metin Analizi, veri bölme için iki yöntemi destekler:

• Test kümesini eğitim verilerinden otomatik olarak bölme:Sistem, etiketlenmiş verilerinizi seçtiğiniz yüzdelere göre eğitim ve test kümeleri arasında böler. Önerilen bölme yüzdesi eğitim için %80 ve test için %20'dir.

Not

Test kümesini eğitim verilerinden otomatik olarak bölme seçeneğini belirlerseniz, sağlanan yüzdelere göre yalnızca eğitim kümesine atanan veriler bölünür.

• Eğitim ve test verilerinin el ile bölünmesini kullanın: Bu yöntem kullanıcıların hangi etiketli belgelerin hangi kümeye ait olması gerektiğini tanımlamasını sağlar. Bu adım yalnızca veri etiketleme sırasında test kümenize belge eklediyseniz etkinleştirilir.

Modeli eğitme

Language Studio

Modelinizi Language Studio'dan eğitmeye başlamak için:

1. Sol taraftaki menüden Eğitim işleri'ni seçin.

2. Üstteki menüden Eğitim işi başlat'ı seçin.

3. Yeni model eğit'i seçin ve metin kutusuna model adını yazın. Ayrıca, bu seçeneği belirleyip açılan menüden üzerine yazmak istediğiniz modeli seçerek mevcut modelin üzerine yazabilirsiniz. Eğitilen modelin üzerine yazmak geri alınamaz, ancak yeni modeli dağıtana kadar dağıtılan modellerinizi etkilemez.

   

4. Veri bölme yöntemini seçin. Belirtilen yüzdelere göre, sistemin etiketlenmiş verilerinizi eğitim ve test kümeleri arasında böleceği eğitim verilerinden test kümesini otomatik olarak bölme'yi seçebilirsiniz. Ya da eğitim ve test verilerinin el ile bölünmesini kullanabilirsiniz. Bu seçenek yalnızca test kümenize belge eklediyseniz etkinleştirilir. Veri bölme hakkında bilgi için bkz. veri etiketleme ve modeli eğitme .

5. Eğit düğmesini seçin.

6. Listeden Eğitim İşi Kimliği'ni seçerseniz, bu işin Eğitim ilerleme durumunu, İş durumunu ve diğer ayrıntıları deleyebileceğiniz bir yan bölme görüntülenir.

   Not

   • Yalnızca başarıyla tamamlanan eğitim işleri model oluşturur.
   • Eğitim, etiketlenmiş verilerinizin boyutuna bağlı olarak birkaç dakika ile birkaç saat arasında sürebilir.
   • Aynı anda yalnızca bir eğitim işi çalıştırabilirsiniz. Çalışan iş tamamlanana kadar aynı proje içinde başka bir eğitim işi başlatamazsınız.

REST API'leri

Eğitim işini başlatma

Bir eğitim işi göndermek için aşağıdaki URL' yi, üst bilgileri ve JSON gövdesini kullanarak bir POST isteği gönderin. Yer tutucu değerlerini kendi değerlerinizle değiştirin.

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/:train?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üm içindir. 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.

İstek gövdesi

İstek gövdesinde aşağıdaki JSON'yi kullanın. Eğitim tamamlandıktan sonra modele {MODEL-NAME} verilir. Yalnızca başarılı eğitim işleri model üretir.

{
	"modelLabel": "{MODEL-NAME}",
	"trainingConfigVersion": "{CONFIG-VERSION}",
	"evaluationOptions": {
		"kind": "percentage",
		"trainingSplitPercentage": 80,
		"testingSplitPercentage": 20
	}
}

Anahtar	Yer tutucu	Değer	Örnek
modelLabel	{MODEL-NAME}	Başarıyla eğitildikten sonra modelinize atanan model adı.	myModel
trainingConfigVersion	{CONFIG-VERSION}	Bu, modeli eğitmek için kullanılan model sürümüdür .	2022-05-01
evaluationOptions		Verilerinizi eğitim ve test kümelerine bölme seçeneği.	{}
Tür	percentage	Bölünmüş yöntemler. Olası değerler: percentage veya manual. Daha fazla bilgi için bkz. Modeli eğitme .	percentage
trainingSplitPercentage	80	Etiketli verilerinizin eğitim kümesine dahil edilecek yüzdesi. Önerilen değer: 80.	80
testingSplitPercentage	20	Test kümesine eklenecek etiketli verilerinizin yüzdesi. Önerilen değer: 20.	20

Not

trainingSplitPercentage ve testingSplitPercentage yalnızca olarak ayarlanırsa Kindpercentage gereklidir ve her iki yüzdenin toplamı 100'e eşit olmalıdır.

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 location . Şu şekilde biçimlendirilir:

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/train/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. Eğitim durumunu almak için bu URL'yi kullanabilirsiniz.

Eğitim işi durumunu alma

Eğitim verilerinizin boyutuna ve şemanızın karmaşıklığına bağlı olarak eğitim biraz zaman alabilir. Eğitim işi başarıyla tamamlanana kadar durumunu yoklamayı sürdürmek için aşağıdaki isteği kullanabilirsiniz.

Modelinizin eğitim ilerleme durumunu almak için aşağıdaki GET isteğini kullanın. Aşağıdaki yer tutucu değerlerini kendi değerlerinizle değiştirin.

İstek URL’si

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/train/jobs/{JOB-ID}?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
{JOB-ID}	Modelinizin eğitim durumunu bulma kimliği. Bu değer, önceki adımda aldığınız üst bilgi değerindedir location .	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{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.

Yanıt Gövdesi

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

{
  "result": {
    "modelLabel": "{MODEL-NAME}",
    "trainingConfigVersion": "{CONFIG-VERSION}",
    "estimatedEndDateTime": "2022-04-18T15:47:58.8190649Z",
    "trainingStatus": {
      "percentComplete": 3,
      "startDateTime": "2022-04-18T15:45:06.8190649Z",
      "status": "running"
    },
    "evaluationStatus": {
      "percentComplete": 0,
      "status": "notStarted"
    }
  },
  "jobId": "{JOB-ID}",
  "createdDateTime": "2022-04-18T15:44:44Z",
  "lastUpdatedDateTime": "2022-04-18T15:45:48Z",
  "expirationDateTime": "2022-04-25T15:44:44Z",
  "status": "running"
}

Eğitim işini iptal etme

Language Studio

Language Studio'dan bir eğitim işini iptal etmek için Eğitim işleri sayfasına gidin. İptal etmek istediğiniz eğitim işini seçin ve üstteki menüden İptal'i seçin.

REST API'leri

Bir eğitim işini iptal etmek için aşağıdaki URL' yi, üst bilgileri ve JSON gövdesini kullanarak bir POST isteği oluşturun.

İstek URL’si

API isteğinizi oluştururken 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/{PROJECT-NAME}/train/jobs/{JOB-ID}/:cancel?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.	EmailApp
{JOB-ID}	Bu değer eğitim işi kimliğidir.	XXXXX-XXXXX-XXXX-XX
{API-VERSION}	Çağırdığınız API'nin sürümü. 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.

API isteğinizi gönderdikten sonra, işin durumunu denetlemek için kullanılan üst bilgiyle birlikte bir Operation-Location 202 yanıtı alırsınız.

Sonraki adımlar

Eğitim tamamlandıktan sonra, gerekirse modelinizi isteğe bağlı olarak geliştirmek için modelin performansını görüntüleyebileceksiniz. Modelinizden memnun olduktan sonra, modeli dağıtabilir ve metinden varlıkları ayıklamak için kullanılabilir hale getirebilirsiniz.