Özel modelinizi sorgulama

Dağıtım başarıyla eklendikten sonra, dağıtıma atadığınız modeli temel alarak metninizdeki varlıkları ayıklamak için dağıtımı sorgulayabilirsiniz. Tahmin API'sini kullanarak veya istemci kitaplıkları (Azure SDK) aracılığıyla dağıtımı program aracılığıyla sorgulayabilirsiniz.

Dağıtılan modeli test etme

Language Studio'yu kullanarak özel varlık tanıma görevini gönderebilir ve sonuçları görselleştirebilirsiniz.

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 varlık tanıma isteği gönderme

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

{
  "displayName": "Extracting entities",
  "analysisInput": {
    "documents": [
      {
        "id": "1",
        "language": "{LANGUAGE-CODE}",
        "text": "Text1"
      },
      {
        "id": "2",
        "language": "{LANGUAGE-CODE}",
        "text": "Text2"
      }
    ]
  },
  "tasks": [
     {
      "kind": "CustomEntityRecognition",
      "taskName": "Entity Recognition",
      "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	CustomEntityRecognition	Görev adı	CustomEntityRecognition
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

Görevinizin başarıyla gönderildiğini 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

Özel varlık tanıma 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, 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.

Yanıt Gövdesi

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

{
  "createdDateTime": "2021-05-19T14:32:25.578Z",
  "displayName": "MyJobName",
  "expirationDateTime": "2021-05-19T14:32:25.578Z",
  "jobId": "xxxx-xxxx-xxxxx-xxxxx",
  "lastUpdateDateTime": "2021-05-19T14:32:25.578Z",
  "status": "succeeded",
  "tasks": {
    "completed": 1,
    "failed": 0,
    "inProgress": 0,
    "total": 1,
    "items": [
      {
        "kind": "EntityRecognitionLROResults",
        "taskName": "Recognize Entities",
        "lastUpdateDateTime": "2020-10-01T15:01:03Z",
        "status": "succeeded",
        "results": {
          "documents": [
            {
              "entities": [
                {
                  "category": "Event",
                  "confidenceScore": 0.61,
                  "length": 4,
                  "offset": 18,
                  "text": "trip"
                },
                {
                  "category": "Location",
                  "confidenceScore": 0.82,
                  "length": 7,
                  "offset": 26,
                  "subcategory": "GPE",
                  "text": "Seattle"
                },
                {
                  "category": "DateTime",
                  "confidenceScore": 0.8,
                  "length": 9,
                  "offset": 34,
                  "subcategory": "DateRange",
                  "text": "last week"
                }
              ],
              "id": "1",
              "warnings": []
            }
          ],
          "errors": [],
          "modelVersion": "2020-04-01"
        }
      }
    ]
  }
}

İstemci kitaplıkları (Azure SDK)

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

Anahtarınızı ve uç noktanızı alma

Ardından uygulamanızı API'ye bağlamak için kaynağın anahtarına ve uç noktasına ihtiyacınız olacak. Anahtarınızı ve uç noktanızı hızlı başlangıcın ilerleyen bölümlerinde koda yapıştıracaksınız.

1. Dil kaynağı başarıyla dağıtıldıktan sonra, Sonraki Adımlar'ın altındaki Kaynağa Git düğmesine tıklayın.

   

2. Kaynağınızın ekranında, sol gezinti menüsünde Anahtarlar ve uç nokta'yı seçin. Aşağıdaki adımlarda anahtarlarınızdan birini ve uç noktanızı 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.

   • 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

• Sık sorulan sorular