CLU projesi oluşturma

Makale
10/16/2024

Bu gereksinimleri ayarlamayı ve proje oluşturmayı öğrenmek için bu makaleyi kullanın.

Önkoşullar

CLU 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

CLU kullanmaya başlamadan önce bir Azure AI Dili kaynağına ihtiyacınız olacaktır.

Not

Dil kaynağı oluşturmak için kaynak grubunda sahip rolünün atanmış olması gerekir.

Azure portalından yeni kaynak oluşturma

Yeni bir Azure AI Dili kaynağı oluşturmak için Azure portalında oturum açın.
Yeni kaynak oluştur'u seçin
Görüntülenen pencerede Dil hizmeti için arama yapın
Oluştur'u seçin

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

Örnek ayrıntısı	Gerekli değer
Bölge	Dil kaynağınız için desteklenen bölgelerden biri.
Veri Akışı Adı	Dil kaynağınız için gerekli ad
Fiyatlandırma katmanı	Dil kaynağınız için 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ı	Dil kaynağınızın adı
Konum	Dil kaynağınız için desteklenen bölgeler.
Fiyatlandırma katmanı	Dil kaynağınız için desteklenen fiyatlandırma katmanları.

Önemli

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

Language Studio'ya gidin ve Azure hesabınızla oturum açın.

Görüntülenen Dil kaynağı seçin penceresinde Azure aboneliğinizi bulun ve Dil kaynağınızı seçin. Kaynağınız yoksa yeni bir kaynak oluşturabilirsiniz.

Örnek ayrıntısı	Gerekli değer
Azure aboneliği	Azure aboneliğiniz.
Azure kaynak grubu	Azure kaynak grubu adınız.
Azure kaynak adı	Azure kaynak adınız.
Konum	Dil kaynağınız için desteklenen bölgelerden biri. Örneğin, "Batı ABD 2".
Fiyatlandırma katmanı	Dil kaynağınız için geçerli fiyatlandırma katmanlarından biri. Hizmeti denemek için Ücretsiz (F0) katmanını kullanabilirsiniz.

Konuşma projesi oluşturma

Bir Dil kaynağı oluşturduktan sonra bir Konuşma Dili Anlama projesi oluşturun.

Language Studio
REST API'leri

Language Studio'da Soruları ve konuşma dilini anlama adlı bölümü bulun ve Konuşma dilini anlama'yı seçin.
Bu sizi Konuşma dilini anlama projeleri sayfasına götürür. Yeni proje oluştur'u seçin.

Yeni bir proje oluşturmak için aşağıdaki ayrıntıları sağlamanız gerekir:

Value	Açıklama
Ad	Projeniz için bir ad. Oluşturulduktan sonra değiştirilemez
Açıklama	İsteğe bağlı proje açıklaması.
Konuşmalar birincil dili	Projenizin birincil dili. Eğitim verileriniz öncelikli olarak bu dilde olmalıdır.
Birden çok dili etkinleştirme	Projenizin aynı anda birden çok dili desteklemesini sağlamak isteyip istemediğiniz.

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

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.
`Content-Type`	'application/merge-patch+json'

Gövde

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

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "Conversation",
  "description": "Project description",
  "multilingual": true
}

Anahtar	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`
`multilingual`	`true`	Veri kümenizde birden çok dilde belge olmasını sağlayan boole değeridir ve modeliniz dağıtıldığında modeli desteklenen herhangi bir dilde sorgulayabilirsiniz (eğitim belgelerinize dahil olması gerekmez). Çok dilli destek hakkında daha fazla bilgi edinmek için bkz. Dil desteği.	`true`

Konuşma projeleri sayfasına gidip bir proje seçerek ve üst menüden Dışarı Aktar'a tıklayarak Konuşma Dili Anlama projesini istediğiniz zaman 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.

Mevcut bir LUIS uygulamanız varsa, LUIS uygulaması JSON'unu doğrudan Konuşma Dili Anlama'ya aktarabilirsiniz ve şu anda kullanılabilir olan tüm parçaları içeren bir Konuşma projesi oluşturur: Amaçlar, ML varlıkları ve konuşmalar. Daha fazla bilgi için LUIS geçiş makalesine bakın.

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

CLU JSON hizmetini 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. 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 ve içeri aktardığınız JSON dosyasındaki proje adıyla eşleşmelidir.	`EmailAppDemo`
`{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önderdiğiniz JSON gövdesi aşağıdaki örneğe benzer. JSON nesnesi hakkında daha fazla ayrıntı için başvuru belgelerine bakın.

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectKind": "Conversation",
    "settings": {
      "confidenceThreshold": 0.7
    },
    "projectName": "{PROJECT-NAME}",
    "multilingual": true,
    "description": "Trying out CLU",
    "language": "{LANGUAGE-CODE}"
  },
  "assets": {
    "projectKind": "Conversation",
    "intents": [
      {
        "category": "intent1"
      },
      {
        "category": "intent2"
      }
    ],
    "entities": [
      {
        "category": "entity1"
      }
    ],
    "utterances": [
      {
        "text": "text1",
        "dataset": "{DATASET}",
        "intent": "intent1",
        "entities": [
          {
            "category": "entity1",
            "offset": 5,
            "length": 5
          }
        ]
      },
      {
        "text": "text2",
        "language": "{LANGUAGE-CODE}",
        "dataset": "{DATASET}",
        "intent": "intent2",
        "entities": []
      }
    ]
  }
}

Anahtar	Yer tutucu	Değer	Örnek
`{API-VERSION}`	Çağırdığınız API'nin sürümü.	`2023-04-01`
`projectName`	`{PROJECT-NAME}`	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	`EmailAppDemo`
`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`
`multilingual`	`true`	Veri kümenizde birden çok dilde belge olmasını sağlayan boole değeri. Modeliniz dağıtıldığında, modeli eğitim belgelerinize dahil olmayan diller de dahil olmak üzere desteklenen herhangi bir dilde sorgulayabilirsiniz.	`true`
`dataset`	`{DATASET}`	Verilerinizi test ve eğitim kümesi arasında bölme hakkında bilgi için modeli eğitme bölümüne bakın. Bu alanın olası değerleri ve `Test`şeklindedir`Train`.	`Train`

Başarılı bir istek üzerine API yanıtı, içeri aktarma işinin durumunu denetlemek için kullanabileceğiniz URL'ye sahip bir üst bilgi içerir operation-location . Şu şekilde biçimlendirilir:

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}

Projeyi dışarı aktarma

Language Studio
REST API'leri

Konuşma projeleri sayfasına gidip bir proje seçip Dışarı Aktar'a basarak istediğiniz zaman Konuşma Dili Anlama projesini JSON dosyası olarak dışarı aktarabilirsiniz.

Bir Konuşma Dili Anlama projesini 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.

CLU proje ayrıntılarını alma

Language Studio
REST API'leri

Language Studio'da proje ayarları sayfanıza gidin.
Proje ayrıntılarını görebilirsiniz.
Bu sayfada proje açıklamasını güncelleştirebilir ve proje ayarlarında Çok dilli veri kümesini etkinleştirebilir/devre dışı bırakabilirsiniz.
Bu sayfadan kaynak birincil anahtarınızı da alabilirsiniz.

Proje ayrıntılarınızı 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": "Conversation",
  "projectName": "{PROJECT-NAME}",
  "multilingual": true,
  "description": "This is a sample conversation 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
REST API'leri

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.

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

Aracılığıyla paylaş

CLU projesi oluşturma

Önkoşullar

Dil kaynağı oluşturma

Azure portalından yeni kaynak oluşturma

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

Konuşma projesi oluşturma

İstek URL’si

Üst Bilgiler

Gövde

Projeyi içeri aktarma

İstek URL’si

Üst Bilgiler

Gövde

Projeyi dışarı aktarma

İstek URL’si

Üst Bilgiler

CLU proje ayrıntılarını alma

Üst Bilgiler

Yanıt Gövdesi

Projeyi silme

İstek URL’si

Üst Bilgiler

Sonraki Adımlar

Geri Bildirim

Ek kaynaklar

Aracılığıyla paylaş

CLU projesi oluşturma

Önkoşullar

Dil kaynağı oluşturma

Azure portalından yeni kaynak oluşturma

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

Language Studio'da oturum açın

Konuşma projesi oluşturma

Projeyi içeri aktarma

Projeyi dışarı aktarma

CLU proje ayrıntılarını alma

Projeyi silme

Sonraki Adımlar

Geri Bildirim

Ek kaynaklar