Düzenleme iş akışında proje oluşturma

Orchestration iş akışı, uygulamalarınızı şu bağlantılara bağlayan projeler oluşturmanıza olanak tanır:

• Özel Language Understanding
• Soru Yanıtlama
• LUIS

Önkoşullar

Düzenleme iş akışını kullanmaya başlamadan önce birkaç şeye ihtiyacınız olacaktır:

• Azure aboneliği - Ücretsiz bir abonelik oluşturun.
• Azure AI Dil kaynağı

Dil kaynağı oluşturma

Düzenleme iş akışını kullanmaya başlamadan önce bir Azure Yapay Zeka Dili kaynağına ihtiyacınız olacaktır.

Dekont

• Dil kaynağı oluşturmak için kaynak grubunda sahip rolünün atanmış olması gerekir.
• Soru yanıtlamayı kullanmayı planlıyorsanız, kaynak oluşturma işleminde soru yanıtlamayı etkinleştirmeniz gerekir

Azure portalından yeni kaynak oluşturma

1. Yeni bir Azure Yapay Zeka Dili kaynağı oluşturmak için Azure portalına gidin.

2. Kaynağınızı oluşturmak için Devam'ı seçin

3. Aşağıdaki ayrıntıları içeren bir Dil kaynağı oluşturun.

   Örnek ayrıntısı	Gerekli değer
   Bölge	Desteklenen bölgelerden biri.
   Veri Akışı Adı	Dil kaynağınız için bir ad.
   Fiyatlandırma katmanı	Desteklenen fiyatlandırma katmanlarından biri.

Language Studio'dan yeni bir Dil kaynağı oluşturma

İlk kez oturum açıyorsanız, Language Studio'da var olan bir Dil kaynağını seçmenize veya yeni bir kaynak oluşturmanıza olanak sağlayan bir pencere görürsünüz. Ayrıca sağ üst köşedeki ayarlar simgesine, Kaynaklar'a ve ardından Yeni kaynak oluştur'a tıklayarak da kaynak oluşturabilirsiniz.

Aşağıdaki ayrıntıları içeren bir Dil kaynağı oluşturun.

Örnek ayrıntısı	Gerekli değer
Azure aboneliği	Azure aboneliğiniz
Azure kaynak grubu	Azure kaynak grubunuz
Azure kaynak adı	Azure kaynağınızın adı
Konum	Desteklenen bölgeler hakkında daha fazla bilgi edinin.
Fiyatlandırma katmanı	Desteklenen fiyatlandırma katmanları hakkında daha fazla bilgi edinin.

Önemli

• Dil kaynağı oluştururken Yönetilen Kimliği etkinleştirdiğinizden emin olun.
• Sorumlu yapay zeka bildirimini okuyun ve onaylayın

Language Studio'da oturum açın

Yeni bir amaç oluşturmak için +Ekle düğmesi'ni seçin ve amacınıza bir ad vererek başlayın. Bir projeye bağlanmak için veya bağlanmamak için iki seçenek görürsünüz. (LUIS, soru yanıtlama veya Konuşma Dili Anlama) projelerine bağlanabilir veya hayır seçeneğini belirleyebilirsiniz.

Düzenleme iş akışı projesi oluşturma

Bir Dil kaynağı oluşturduktan sonra bir düzenleme iş akışı projesi oluşturun.

Language Studio

1. Language Studio'da Soruları ve konuşma dilini anlama etiketli bölümü bulun ve Orchestration İş Akışı'nı seçin.

   

2. Bu işlem sizi Orchestration iş akışı proje sayfasına getirir. Yeni proje oluştur'u seçin. Proje oluşturmak için aşağıdaki ayrıntıları sağlamanız gerekir:

Değer	Açıklama
Kuruluş adı	Projeniz için bir ad.
Tanım	İsteğe bağlı proje açıklaması.
Konuşmalar birincil dili	Projenizin birincil dili. Eğitim verileriniz öncelikli olarak bu dilde olmalıdır.

İşiniz bittiğinde İleri'yi seçin ve ayrıntıları gözden geçirin. İşlemi tamamlamak için Proje oluştur'u seçin. Şimdi projenizde Şema Oluştur ekranını görmeniz gerekir.

REST API'leri

Yeni bir proje oluşturmak için aşağıdaki URL' yi, üst bilgileri ve JSON gövdesini kullanarak bir PATCH 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}?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.

Gövde

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

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "Orchestration",
  "description": "Project description"
 }

Tuş	Yer tutucu	Değer	Örnek
projectName	{PROJECT-NAME}	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	EmailApp
language	{LANGUAGE-CODE}	Projenizde kullanılan konuşmaların dil kodunu belirten bir dize. Projeniz çok dilli bir projeyse, konuşmaların çoğunluğunun dil kodunu seçin.	en-us

Düzenleme iş akışı projelerini içeri aktarma

Language Studio

Düzenleme iş akışı projelerini düzenleme iş akışı projeleri sayfasına gidip bir proje seçerek ve üst menüden Dışarı Aktar'a tıklayarak istediğiniz zaman bir düzenleme iş akışı projesini JSON dosyası olarak dışarı aktarabilirsiniz.

Bu proje yeni bir proje olarak yeniden aktarılabilir. Tam olarak aynı ada sahip bir projeyi içeri aktarırsanız, proje verilerini yeni içeri aktarılan projenin verileriyle değiştirir.

Projeyi içeri aktarmak için Yeni proje oluştur'un yanındaki ok düğmesini seçin ve İçeri Aktar'ı ve ardından JSON dosyasını seçin.

REST API'leri

Düzenleme iş akışı JSON'unu hizmete aktarabilirsiniz

Projenizi içeri aktarmak 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}/:import?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.

Gövde

Dekont

Her amaç yalnızca (CLU, LUIS ve qna) türünde olmalıdır

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

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectKind": "Orchestration",
    "settings": {
      "confidenceThreshold": 0
    },
    "projectName": "{PROJECT-NAME}",
    "description": "Project description",
    "language": "{LANGUAGE-CODE}"
  },
  "assets": {
    "projectKind": "Orchestration",
    "intents": [
      {
        "category": "string",
        "orchestration": {
          "kind": "luis",
          "luisOrchestration": {
            "appId": "00000000-0000-0000-0000-000000000000",
            "appVersion": "string",
            "slotName": "string"
          },
          "cluOrchestration": {
            "projectName": "string",
            "deploymentName": "string"
          },
          "qnaOrchestration": {
            "projectName": "string"
          }
        }
      }
    ],
    "utterances": [
      {
        "text": "Trying orchestration",
        "language": "{LANGUAGE-CODE}",
        "intent": "string"
      }
    ]
  }
}

Tuş	Yer tutucu	Değer	Örnek
api-version	{API-VERSION}	Çağırdığınız API'nin sürümü. Burada kullanılan sürüm, URL'de aynı API sürümü olmalıdır.	2022-03-01-preview
projectName	{PROJECT-NAME}	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	EmailApp
language	{LANGUAGE-CODE}	Projenizde kullanılan konuşmaların dil kodunu belirten bir dize. Projeniz çok dilli bir projeyse, konuşmaların çoğunluğunun dil kodunu seçin.	en-us

Projeyi dışarı aktarma

Language Studio

Düzenleme iş akışı projeleri sayfasına gidip bir proje seçip Dışarı Aktar'a basarak düzenleme iş akışı projesini istediğiniz zaman JSON dosyası olarak dışarı aktarabilirsiniz.

REST API'leri

Düzenleme iş akışı projelerini istediğiniz zaman JSON dosyası olarak dışarı aktarabilirsiniz.

Projenizi dışarı aktarmak 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-conversations/projects/{PROJECT-NAME}/:export?stringIndexType=Utf16CodeUnit&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
{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. Yanıt üst bilgilerinde değeri ayıklayın operation-location . Şu şekilde biçimlendirilir:

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-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. Aynı kimlik doğrulama yöntemini kullanarak dışarı aktarılan proje JSON'unu almak için bu URL'yi kullanın.

Düzenleme projesi ayrıntılarını alma

Language Studio

1. Language Studio'da proje ayarları sayfanıza gidin.

2. Proje ayrıntılarını görebilirsiniz.

3. Bu sayfada proje açıklamasını güncelleştirebilirsiniz.

4. Bu sayfadan kaynak birincil anahtarınızı da alabilirsiniz.

   

REST API'leri

Bir düzenleme iş akışı projesinin ayrıntılarını almak için aşağıdaki URL'yi ve üst bilgileri kullanarak bir GET isteği gönderin. Yer tutucu değerlerini kendi değerlerinizle değiştirin.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-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
{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.

{
  "createdDateTime": "2022-04-18T13:53:03Z",
  "lastModifiedDateTime": "2022-04-18T13:53:03Z",
  "lastTrainedDateTime": "2022-04-18T14:14:28Z",
  "lastDeployedDateTime": "2022-04-18T14:49:01Z",
  "projectKind": "Orchestration",
  "projectName": "{PROJECT-NAME}",
  "description": "This is a sample orchestration project.",
  "language": "{LANGUAGE-CODE}"
}

API isteğinizi gönderdikten sonra, başarılı olduğunu ve proje ayrıntılarınızla birlikte JSON yanıt gövdesini belirten bir 200 yanıt alırsınız.

Projeyi silme

Language Studio

Projenize artık ihtiyacınız olmadığında, Language Studio'yu kullanarak projenizi silebilirsiniz. Sol gezinti menüsünden Projeler'i seçin, silmek istediğiniz projeyi seçin ve ardından üstteki menüden Sil'i seçin.

REST API'leri

Projenize artık ihtiyacınız olmadığında API'leri kullanarak projenizi silebilirsiniz.

Konuşma dilini anlama projesini 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/{PROJECT-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
{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 projenizin silindiği anlamına gelir.

Sonraki Adımlar

Şema oluşturma