Çalışma zamanı API'sini kullanarak bir model dağıtma ve metinden varlıkları ayıklama

Modelinizin performansından memnun olduğunuzda, dağıtılmaya hazır olur ve metindeki varlıkları tanımak için kullanılır. Modelin dağıtılması, tahmin API'sini kullanarak kullanıma sunulmasını sağlar.

Ön koşullar

• Yapılandırılmış bir Azure depolama hesabıyla başarıyla oluşturulmuş bir proje .
• Depolama hesabınıza yüklenen metin verileri.
• Etiketlenmiş veriler ve başarıyla eğitilen model
• Modelinizin nasıl performans sergilediğini belirlemek için model değerlendirme ayrıntılarını gözden geçirdiniz.

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

Model dağıtma

Modelinizin performansını gözden geçirdikten ve ortamınızda kullanılabilmeye karar verdikten sonra bunu bir dağıtıma atamanız gerekir. Modeli bir dağıtıma atamak, tahmin API'si aracılığıyla kullanılabilir hale getirir. Şimdiye kadar oluşturduğunuz en iyi modeli atadığınız üretim adlı bir dağıtım oluşturmanız ve bunu sisteminizde kullanmanız önerilir. Şu anda üzerinde çalıştığınız modeli test edebilmek için atayabileceğiniz hazırlama adlı başka bir dağıtım oluşturabilirsiniz. Projenizde en fazla 10 dağıtım olabilir.

Language Studio

Modelinizi Language Studio'dan dağıtmak için:

1. Sol taraftaki menüden Model dağıtma'ya tıklayın.

2. Yeni bir dağıtım işi başlatmak için Dağıtım ekle'yi seçin.

   

3. Yeni bir dağıtım oluşturmak ve aşağıdaki açılan listeden eğitilmiş bir model atamak için Yeni dağıtım oluştur'u seçin. Ayrıca bu seçeneği belirleyerek ve aşağıdaki açılan listeden bu dağıtıma atamak istediğiniz eğitilmiş modeli seçerek mevcut dağıtımın üzerine yazabilirsiniz.

   Dekont

   Mevcut dağıtımın üzerine yazmak için tahmin API çağrınızda değişiklik yapılması gerekmez, ancak elde ettiğiniz sonuçlar yeni atanan modeli temel alır.

   

4. Dağıtım işini başlatmak için Dağıt'ı seçin.

5. Dağıtım başarılı olduktan sonra, yanında bir sona erme tarihi görüntülenir. Dağıtım süre sonu, dağıtılan modelinizin tahmin için kullanılamadığı zamandır ve bu durum genellikle eğitim yapılandırmasının süresi dolduktan on iki ay sonra gerçekleşir.

REST API'leri

Dağıtım işini gönderme

Bir dağıtım işi göndermek için aşağıdaki URL' yi, üst bilgileri ve JSON gövdesini kullanarak bir PUT isteği gönderin. Aşağıdaki yer tutucu değerlerini kendi değerlerinizle değiştirin.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}?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
{DEPLOYMENT-NAME}	Dağıtımınızın adı. Bu değer büyük/küçük harfe duyarlıdır.	staging
{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.

Request body

İsteğinizin gövdesinde aşağıdaki JSON'yi kullanın. Dağıtıma atamak için modelin adını kullanın.

{
  "trainedModelLabel": "{MODEL-NAME}"
}

Tuş	Yer tutucu	Değer	Örnek
trainedModelLabel	{MODEL-NAME}	Dağıtımınıza atanacak model adı. Yalnızca başarıyla eğitilmiş modeller atayabilirsiniz. Bu değer büyük/küçük harfe duyarlıdır.	myModel

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}/deployments/{DEPLOYMENT-NAME}/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. Dağıtım durumunu almak için bu URL'yi kullanabilirsiniz.

Dağıtım işi durumunu alma

Dağıtım işinin durumunu sorgulamak için aşağıdaki GET isteğini kullanın. Önceki adımda aldığınız URL'yi kullanabilir veya aşağıdaki yer tutucu değerleri kendi değerlerinizle değiştirebilirsiniz.

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/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
{DEPLOYMENT-NAME}	Dağıtımınızın adı. Bu değer büyük/küçük harfe duyarlıdır.	staging
{JOB-ID}	Modelinizin eğitim durumunu bulma kimliği. Bu, ö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. Durum parametresi "başarılı" olarak değişene kadar bu uç noktayı yoklamayı sürdürebilirsiniz. İsteğin başarısını belirten bir 200 kod almalısınız.

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

Dağıtımları değiştirme

Bir dağıtıma atanan modeli test ettikten sonra ve bu modeli başka bir dağıtıma atamak istiyorsanız, bu iki dağıtımı değiştirebilirsiniz. Dağıtımları değiştirme, ilk dağıtıma atanan modeli almayı ve ikinci dağıtıma atamayı içerir. Ardından ikinci dağıtıma atanan modeli alıp ilk dağıtıma atayın. Hazırlamaya atanan modeli alıp üretime atamak istediğinizde üretim ve hazırlama dağıtımlarınızı değiştirmek için bu işlemi kullanabilirsiniz.

Language Studio

Language Studio'dan dağıtımları değiştirmek için:

1. Model dağıtma sayfasında değiştirmek istediğiniz iki dağıtımı seçin ve üstteki menüden Dağıtımları değiştir'i seçin.

2. Görüntülenen pencerede değiştirmek istediğiniz dağıtımların adlarını seçin.

REST API'leri

Değiştirme dağıtımları işini başlatmak için aşağıdaki URL'yi, üst bilgileri ve JSON gövdesini kullanarak bir POST isteği oluşturun.

İstek URL'si

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/:swap?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 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.

İstek Gövdesi

{
  "firstDeploymentName": "{FIRST-DEPLOYMENT-NAME}",
  "secondDeploymentName": "{SECOND-DEPLOYMENT-NAME}"
}

Tuş	Yer tutucu	Değer	Örnek
firstDeploymentName	{FIRST-DEPLOYMENT-NAME}	İlk dağıtımınızın adı. Bu değer büyük/küçük harfe duyarlıdır.	production
secondDeploymentName	{SECOND-DEPLOYMENT-NAME}	İkinci dağıtımınızın adı. Bu değer büyük/küçük harfe duyarlıdır.	staging

API isteğinizi gönderdikten sonra başarılı olduğunu belirten bir 202 yanıt alırsınız.

Dağıtımı silme

Language Studio

Language Studio'dan bir dağıtımı silmek için Model dağıtma sayfasına gidin. Silmek istediğiniz dağıtımı seçin ve üstteki menüden Dağıtımı sil'i seçin.

REST API'leri

Bir dağıtımı silmek için aşağıdaki URL'yi, üst bilgileri ve JSON gövdesini kullanarak bir DELETE isteği oluşturun.

İstek URL'si

{Endpoint}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{deploymentName}?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
{DEPLOYMENT-NAME}	Dağıtım adınızın adı. Bu değer büyük/küçük harfe duyarlıdır.	prod
{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 dağıtımınızın 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.

Dağıtım kaynakları atama

Farklı bölgelerde bulunan farklı Dil kaynaklarını atayarak projenizi birden çok bölgeye dağıtabilirsiniz.

Language Studio

Language Studio'daki diğer bölgelerde dağıtım kaynakları atamak için:

1. Projeyi oluştururken kullandığınız kaynağa Bilişsel Hizmetler Dil Sahibi olarak kendinizi atadığınızdan emin olun.
2. Language Studio'da Model dağıtma sayfasına gidin.
3. Bölgeler sekmesini seçin.
4. Dağıtım kaynağı ekle'yi seçin.
5. Başka bir bölgedeki Dil kaynağını seçin.

Artık projenizi kaynakları atadığınız bölgelere dağıtmaya hazırsınız.

REST API'leri

Dağıtım kaynaklarını program aracılığıyla atamak için Microsoft Entra kimlik doğrulaması gerekir. Microsoft Entra Id, çok bölgeli dağıtım için projenize atamak istediğiniz kaynaklara erişiminizin olduğunu onaylamak için kullanılır. REST API çağrıları yaparken Microsoft Entra kimlik doğrulamasını program aracılığıyla kullanmak için Azure AI hizmetleri belgelerinden daha fazla bilgi edinin.

Kaynak atama

Dağıtım kaynaklarını atamak için aşağıdaki URL'yi, üst bilgileri ve JSON gövdesini kullanarak bir POST isteği gönderin.

İ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}/resources/:assign?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ü.	2022-10-01-preview

Üst Bilgiler

Bu API'nin kimliğini doğrulamak için Microsoft Entra kimlik doğrulamasını kullanın.

Gövde

Gövdeniz olarak aşağıdaki örnek JSON'yi kullanın.

{
  "resourcesMetadata": [
    {
      "azureResourceId": "{AZURE-RESOURCE-ID}",
      "customDomain": "{CUSTOM-DOMAIN}",
      "region": "{REGION-CODE}"
    }
  ]
}

Tuş	Yer tutucu	Değer	Örnek
azureResourceId	{AZURE-RESOURCE-ID}	Atamak istediğiniz tam kaynak kimliği yolu. Azure portalında kaynağın Özellikler sekmesinin altında, Kaynak Kimliği alanında bulunur.	/subscriptions/d73a1925-0000-0000-0000-0000c5fe888e/resourceGroups/ContosoResourceGroup/providers/Microsoft.CognitiveServices/accounts/ContosoResource
customDomain	{CUSTOM-DOMAIN}	Atamak istediğiniz kaynağın özel alt etki alanı. Azure portalında kaynağın Anahtarlar ve Uç Nokta sekmesinin altında, URL'de Uç Nokta alanı olarak bulunurhttps://<your-custom-subdomain>.cognitiveservices.azure.com/	contosoresource
region	{REGION-CODE}	Atamak istediğiniz kaynağın bölgesini belirten bölge kodu. Azure portalında kaynağın Anahtarlar ve Uç Nokta sekmesinin altında, Konum/Bölge alanında bulunur.	eastus

Kaynak atama durumunu alma

Dağıtım kaynağı atama işinizin 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}/resources/assign/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}	Atama dağıtım durumunuzu almak için iş kimliği. Bu, atama dağıtım kaynağı isteğinize yanıt olarak API'den aldığınız üst bilgi değerindedir operation-location .	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}	Çağırdığınız API'nin sürümü.	2022-10-01-preview

Ü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. Parametresi olarak değişene status succeededkadar bu uç noktayı yoklamayı sürdürebilirsiniz.

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

Dağıtım kaynaklarının atamasını kaldırma

Bir projedeki dağıtım kaynağının atamasını kaldırırken veya kaldırırken, bu kaynağın bölgesine dağıtılan tüm dağıtımları da silersiniz.

Language Studio

Language Studio kullanarak diğer bölgelerdeki dağıtım kaynaklarının atamasını kaldırmak veya kaldırmak için:

1. Model dağıtma sayfasındaki Bölgeler sekmesine gidin.
2. Atamasını silmek istediğiniz kaynağı seçin.
3. Ödevi kaldır düğmesini seçin.
4. Görüntülenen pencerede, kaldırmak istediğiniz kaynağın adını yazın.

REST API'leri

Kaynağın atamasını kaldırma

Projenizdeki dağıtım kaynaklarının atamasını kaldırmak veya kaldırmak için aşağıdaki URL' yi, üst bilgileri ve JSON gövdesini kullanarak bir POST isteği gönderin.

İ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}/resources/:unassign?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ü.	2022-10-01-preview

Ü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

Gövdeniz olarak aşağıdaki örnek JSON'yi kullanın.

{
  "assignedResourceIds": [
    "{AZURE-RESOURCE-ID}"
  ]
}

Tuş	Yer tutucu	Değer	Örnek
assignedResourceIds	{AZURE-RESOURCE-ID}	Atamasını kaldırmasını istediğiniz tam kaynak kimliği yolu. Azure portalında kaynağın Özellikler sekmesinin altında Kaynak Kimliği alanı olarak bulunur.	/subscriptions/d73a1925-0000-0000-0000-0000c5fe888e/resourceGroups/ContosoResourceGroup/providers/Microsoft.CognitiveServices/accounts/ContosoResource

Kaynak durumunun atamasını kaldırma

Atamasını kaldırma dağıtım kaynakları işinizin 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}/resources/unassign/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}	Atama dağıtım durumunuzu almak için iş kimliği. Bu, atamasını operation-location kaldırma dağıtım kaynak isteğinize yanıt olarak API'den aldığınız üst bilgi değerindedir.	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}	Çağırdığınız API'nin sürümü.	2022-10-01-preview

Ü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. Durum parametresi "başarılı" olarak değişene kadar bu uç noktayı yoklamayı sürdürebilirsiniz.

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

Sonraki adımlar

Bir dağıtımınız olduktan sonra, metinden varlıkları ayıklamak için bunu kullanabilirsiniz.