Düzenleme iş akışı modeli dağıtma

Modelinizin performansından memnun olduktan sonra dağıtılmaya hazır olur ve konuşmalardan gelen tahminler için sorgular. Modelin dağıtılması, tahmin API'sini kullanarak kullanıma sunulmasını sağlar.

Ön koşullar

• Başarıyla oluşturulmuş bir proje
• Etiketli konuşmalar ve başarıyla eğitilen model

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

Model dağıtma

Modelin performansını gözden geçirdikten ve ortamınızda kullanılmaya uygun olmasına karar verdikten sonra, sorgulayabilmek için modeli 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 adlı bir dağıtım production oluşturmanız ve bunu sisteminizde kullanmanız önerilir. Şu anda üzerinde çalıştığınız modeli test edebilmek için atayabileceğiniz adlı staging 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

   Var olan bir 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. Bir veya daha fazla LUIS uygulamasına veya konuşma dili anlama projesine bağlanıyorsanız dağıtım adını belirtmeniz gerekir.

   • Özel soru yanıtlama veya bağlantısız amaçlar için yapılandırma gerekmez.

   • LUIS projeleri Orchestration dağıtımı sırasında yapılandırılan yuvada yayımlanmalı ve KB'leri yanıtlayan özel soru da Üretim yuvalarında yayımlanmalıdır.

5. Dağıtım işinizi göndermek için Dağıt'ı seçin

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

Düzenleme iş akışı modeli dağıtmaya başlamak için aşağıdaki URL' yi, üst bilgileri ve JSON gövdesini kullanarak bir PUT isteği oluşturun.

İstek URL'si

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-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
{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ü.	2023-04-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

{
  "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 başarılı olduğunu 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-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

Dağıtım işi durumunu almak için bu URL'yi kullanabilirsiniz.

Dağıtım işi durumunu alma

Dağıtım 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-conversations/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, model dağıtım isteğinize yanıt olarak API'den aldığınız üst bilgi değerindedir location .	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}	Çağırdığınız API'nin sürümü.	2023-04-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.

{
    "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 başka bir dağıtıma atamak isteyebilirsiniz. Dağıtımları değiştirme işlemi şunları içerir:

• İlk dağıtıma atanan modeli alma ve ikinci dağıtıma atama.
• ikinci dağıtıma atanan modeli alıp ilk dağıtıma atayın.

Bu, ve dağıtımlarınızı production staging , atanan modeli alıp öğesine atamak istediğinizde değiştirmek için staging productionkullanılabilir.

Language Studio

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

1. Modeli dağıt 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-conversations/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ü.	2023-04-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 Modeli dağıtma sayfasına gidin. Silmek istediğiniz dağıtımı seçin ve üst menüden Dağıtımı sil'i seçin.

REST API'leri

Konuşma dilini anlama dağıtımını 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-conversations/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 adı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ü.	2023-04-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.

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 kimlik doğrulaması belgelerine bakın.

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-conversations/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/12345678-0000-0000-0000-0000abcd1234/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'deki Uç Nokta alanının bir parçası 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ının bir parçası olarak 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-conversations/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. 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"
}

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

Modelinizi sorgulamak için tahmin API'sini kullanma