Modelinize metin sınıflandırma istekleri gönderme

Bir modeli başarıyla dağıttıktan sonra, dağıtımı sorgulayabilir ve metni dağıtıma atadığınız modele göre sınıflandırabilirsiniz. Dağıtımı program aracılığıyla Tahmin API'sini veya istemci kitaplıkları (Azure SDK) aracılığıyla sorgulayabilirsiniz.

Dağıtılan modeli test etme

Özel metin sınıflandırma görevini göndermek ve sonuçları görselleştirmek için Language Studio'yu kullanabilirsiniz.

Dağıtılan modellerinizi Language Studio'dan test etmek için:

1. Sol taraftaki menüden Dağıtımları test etme'yi seçin.

2. Test etmek istediğiniz dağıtımı seçin. Yalnızca dağıtımlara atanan modelleri test edebilirsiniz.

3. Çok dilli projeler için dil açılan listesinden test ettiğiniz metnin dilini seçin.

4. Açılan listeden sorgulamak/test etmek istediğiniz dağıtımı seçin.

5. İsteğe göndermek istediğiniz metni girebilir veya kullanmak üzere bir .txt dosya yükleyebilirsiniz.

6. Üstteki menüden Testi çalıştır'ı seçin.

7. Sonuç sekmesinde, metninizden ve bunların türlerinden ayıklanan varlıkları görebilirsiniz. JSON yanıtını JSON sekmesinin altında da görüntüleyebilirsiniz.

Modelinize metin sınıflandırma isteği gönderme

İpucu

Modelinizi sınıflandırmak için örnek metin göndererek Language Studio'da test edebilirsiniz.

Language Studio

1. Dağıtım işi başarıyla tamamlandıktan sonra, kullanmak istediğiniz dağıtımı seçin ve üst menüden Tahmin URL'sini al'ı seçin.

   

2. Açılan pencerede, Gönder özetinin altında örnek istek URL'sini ve gövdesini kopyalayın. ve YOUR_DOCUMENT_LANGUAGE_HERE gibi YOUR_DOCUMENT_HERE yer tutucu değerlerini işlemek istediğiniz gerçek metin ve dille değiştirin.

3. POST Terminalinizde veya komut isteminizde cURL isteğini gönderin. İstek başarılı olursa API sonuçlarını içeren bir 202 yanıtı alırsınız.

4. Yanıt üst bilgisinde, biçiminde olan dosyasından operation-locationayıkla {JOB-ID} alırsınız:{ENDPOINT}/language/analyze-text/jobs/<JOB-ID}>

5. Language Studio'ya dön; Daha önce aldığınız örnek isteği aldığınız pencerede Özet al'ı seçin ve örnek isteği bir metin düzenleyicisine kopyalayın.

6. Önceki adımda ayıkladığınız kimliği kullanarak iş kimliğinizi url'ye ekleyin /jobs/ .

7. GET Terminalinizde veya komut isteminizde cURL isteğini gönderin.

REST API

İlk olarak kaynak anahtarınızı ve uç noktanızı almanız gerekir:

1. Azure portalında kaynağınıza genel bakış sayfasına gidin

2. Sol taraftaki menüden Anahtarlar ve Uç Nokta'yı seçin. API istekleri için uç noktayı ve anahtarı kullanacaksınız

   

Özel metin sınıflandırma görevi gönderme

Metin sınıflandırma görevi başlatmak için bu POST isteğini kullanın.

{ENDPOINT}/language/analyze-text/jobs?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
{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

Anahtar	Değer
Ocp-Apim-Subscription-Key	Bu API'ye erişim sağlayan anahtarınız.

Gövde

Çok etiketli sınıflandırma

{
  "displayName": "Classifying documents",
  "analysisInput": {
    "documents": [
      {
        "id": "1",
        "language": "{LANGUAGE-CODE}",
        "text": "Text1"
      },
      {
        "id": "2",
        "language": "{LANGUAGE-CODE}",
        "text": "Text2"
      }
    ]
  },
  "tasks": [
     {
      "kind": "CustomMultiLabelClassification",
      "taskName": "Multi Label Classification",
      "parameters": {
        "projectName": "{PROJECT-NAME}",
        "deploymentName": "{DEPLOYMENT-NAME}"
      }
    }
  ]
}

Anahtar	Yer tutucu	Değer	Örnek
displayName	{JOB-NAME}	İş adınız.	MyJobName
documents	[{},{}]	Görevlerin çalıştırılacak belgelerin listesi.	[{},{}]
id	{DOC-ID}	Belge adı veya kimliği.	doc1
language	{LANGUAGE-CODE}	Belgenin dil kodunu belirten bir dize. Bu anahtar belirtilmezse, hizmet proje oluşturma sırasında seçilen projenin varsayılan dilini kabul eder. Desteklenen dil kodlarının listesi için bkz . dil desteği .	en-us
text	{DOC-TEXT}	Görevlerin çalıştırılacak belge görevi.	Lorem ipsum dolor sit amet
tasks		Gerçekleştirmek istediğimiz görevlerin listesi.	[]
taskName	CustomMultiLabelClassification	Görev adı	CustomMultiLabelClassification
parameters		Göreve geçirecek parametrelerin listesi.
project-name	{PROJECT-NAME}	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	myProject
deployment-name	{DEPLOYMENT-NAME}	Dağıtımınızın adı. Bu değer büyük/küçük harfe duyarlıdır.	prod

Tek etiketli sınıflandırma

{
  "displayName": "Classifying documents",
  "analysisInput": {
    "documents": [
      {
        "id": "1",
        "language": "{LANGUAGE-CODE}",
        "text": "Text1"
      },
      {
        "id": "2",
        "language": "{LANGUAGE-CODE}",
        "text": "Text2"
      }
    ]
  },
  "tasks": [
    {
      "kind": "CustomSingleLabelClassification",
      "taskName": "Single Classification Label",
      "parameters": {
        "projectName": "{PROJECT-NAME}",
        "deploymentName": "{DEPLOYMENT-NAME}"
      }
    }
  ]
}

Anahtar	Yer tutucu	Değer	Örnek
displayName	{JOB-NAME}	İş adınız.	MyJobName
documents		Görevlerin çalıştırılacak belgelerin listesi.
id	{DOC-ID}	Belge adı veya kimliği.	doc1
language	{LANGUAGE-CODE}	Belgenin dil kodunu belirten bir dize. Bu anahtar belirtilmezse, hizmet proje oluşturma sırasında seçilen projenin varsayılan dilini kabul eder. Desteklenen dil kodlarının listesi için bkz . dil desteği .	en-us
text	{DOC-TEXT}	Görevlerin çalıştırılacak belge görevi.	Lorem ipsum dolor sit amet
taskName	CustomSingleLabelClassification	Görev adı	CustomSingleLabelClassification
tasks	[]	Gerçekleştirmek istediğimiz görev dizisi.	[]
parameters		Göreve geçirecek parametrelerin listesi.
project-name	{PROJECT-NAME}	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	myProject
deployment-name	{DEPLOYMENT-NAME}	Dağıtımınızın adı. Bu değer büyük/küçük harfe duyarlıdır.	prod

Response

Başarılı olduğunu belirten bir 202 yanıtı alırsınız. Yanıt üst bilgilerinde ayıklayın operation-location. operation-location şu şekilde biçimlendirilir:

{ENDPOINT}/language/analyze-text/jobs/{JOB-ID}?api-version={API-VERSION}

Görev tamamlanma durumunu sorgulamak ve görev tamamlandığında sonuçları almak için bu URL'yi kullanabilirsiniz.

Görev sonuçlarını alma

Metin sınıflandırma görevinin durumunu/sonuçlarını sorgulamak için aşağıdaki GET isteğini kullanın.

{ENDPOINT}/language/analyze-text/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
{API-VERSION}	Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, en son yayınlanan model sürümü sürümüne yöneliktir.	2022-05-01

Üst Bilgiler

Anahtar	Değer
Ocp-Apim-Subscription-Key	Bu API'ye erişim sağlayan anahtarınız.

Yanıt gövdesi

Yanıt, aşağıdaki parametrelere sahip bir JSON belgesi olacaktır.

Çok etiketli sınıflandırma

{
  "createdDateTime": "2021-05-19T14:32:25.578Z",
  "displayName": "MyJobName",
  "expirationDateTime": "2021-05-19T14:32:25.578Z",
  "jobId": "xxxx-xxxxxx-xxxxx-xxxx",
  "lastUpdateDateTime": "2021-05-19T14:32:25.578Z",
  "status": "succeeded",
  "tasks": {
    "completed": 1,
    "failed": 0,
    "inProgress": 0,
    "total": 1,
    "items": [
      {
        "kind": "customMultiClassificationTasks",
        "taskName": "Classify documents",
        "lastUpdateDateTime": "2020-10-01T15:01:03Z",
        "status": "succeeded",
        "results": {
          "documents": [
            {
              "id": "{DOC-ID}",
              "classes": [
                  {
                      "category": "Class_1",
                      "confidenceScore": 0.0551877357
                  }
              ],
              "warnings": []
            }
          ],
          "errors": [],
          "modelVersion": "2020-04-01"
        }
      }
    ]
  }
}

Tek etiketli sınıflandırma

{
  "createdDateTime": "2021-05-19T14:32:25.578Z",
  "displayName": "MyJobName",
  "expirationDateTime": "2021-05-19T14:32:25.578Z",
  "jobId": "xxxx-xxxxxx-xxxxx-xxxx",
  "lastUpdateDateTime": "2021-05-19T14:32:25.578Z",
  "status": "succeeded",
  "tasks": {
    "completed": 1,
    "failed": 0,
    "inProgress": 0,
    "total": 1,
    "items": [
      {
        "kind": "customSingleClassificationTasks",
        "taskName": "Classify documents",
        "lastUpdateDateTime": "2020-10-01T15:01:03Z",
        "status": "succeeded",
        "results": {
          "documents": [
            {
              "id": "{DOC-ID}",
              "class": [
                  {
                      "category": "Class_1",
                      "confidenceScore": 0.0551877357
                  }
              ],
              "warnings": []
            }
          ],
          "errors": [],
          "modelVersion": "2020-04-01"
        }
      }
    ]
  }
}

İstemci kitaplıkları (Azure SDK)

İlk olarak kaynak anahtarınızı ve uç noktanızı almanız gerekir:

• Azure portalında kaynağınıza genel bakış sayfasına gidin

• Sol taraftaki menüden Anahtarlar ve Uç Nokta'yı seçin. API istekleri için uç noktayı ve anahtarı kullanacaksınız

3. seçtiğiniz dil için istemci kitaplığı paketini indirin ve yükleyin:

   Dil	Paket sürümü
   .NET	5.2.0-beta.3
   Java	5.2.0-beta.3
   JavaScript	6.0.0-beta.1
   Python	5.2.0b4

4. İstemci kitaplığını yükledikten sonra, API'yi çağırmaya başlamak için GitHub'da aşağıdaki örnekleri kullanın.

   Tek etiketli sınıflandırma:

   • C#
   • Java
   • JavaScript
   • Python

   Çoklu etiket sınıflandırması:

   • C#
   • Java
   • JavaScript
   • Python

5. İstemci ve dönüş nesnesi hakkında daha fazla bilgi için aşağıdaki başvuru belgelerine bakın:

   • C#
   • Java
   • JavaScript
   • Python

Sonraki adımlar

• Özel metin sınıflandırmasına genel bakış