Özel NER projesi oluşturma

Özel NER ile başlama ve proje oluşturma gereksinimlerini ayarlamayı öğrenmek için bu makaleyi kullanın.

Önkoşullar

Özel NER kullanmaya başlamadan önce şunları yapmanız gerekir:

• Azure aboneliği - Ücretsiz bir abonelik oluşturun.

Dil kaynağı oluşturma

Özel NER kullanmaya başlamadan önce bir Azure AI Dili kaynağına ihtiyacınız olacaktır. Azure portalında Dil kaynağınızı oluşturmanız ve buna bir depolama hesabı bağlamanız önerilir. Azure portalında kaynak oluşturmak, gerekli tüm izinler önceden yapılandırılmış bir Azure depolama hesabı oluşturmanıza olanak tanır. Ayrıca, önceden var olan bir kaynağı kullanmayı öğrenmek ve özel adlandırılmış varlık tanıma ile çalışacak şekilde yapılandırmak için makalede daha fazla bilgi edinebilirsiniz.

Ayrıca, varlıkları ayıklamak için bir modeli eğitmek için kullanılacak belgelerinizi .txt karşıya yükleyebileceğiniz bir Azure depolama hesabına da ihtiyacınız olacaktır.

Not

• Dil kaynağı oluşturmak için kaynak grubunda sahip rolünün atanmış olması gerekir.
• Önceden var olan bir depolama hesabına bağlanacaksanız, bu hesaba atanmış bir sahip rolünüz olmalıdır.

Dil kaynağı oluşturma ve depolama hesabını bağlama

Aşağıdaki yollarla kaynak oluşturabilirsiniz:

• Azure portal
• Language Studio
• PowerShell

Not

Depolama hesabını Dil kaynağıyla ilişkilendirildikten sonra farklı bir kaynak grubuna veya aboneliğe taşımamalısınız.

Azure portalından yeni kaynak oluşturma

1. Yeni bir Azure AI Dili kaynağı oluşturmak için Azure portalında oturum açın.

2. Açılan pencerede, özel özelliklerden Özel metin sınıflandırması ve özel adlandırılmış varlık tanıma'yı seçin. Ekranın alt kısmındaki kaynağınızı oluşturmak için Devam'ı seçin.

   

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

   Veri Akışı Adı	Açıklama
   Abonelik	Azure aboneliğiniz.
   Kaynak grubu	Kaynağınızı içerecek bir kaynak grubu. Mevcut bir tane kullanabilir veya yeni bir tane oluşturabilirsiniz.
   Bölge	Dil kaynağınızın bölgesi. Örneğin, "Batı ABD 2".
   Veri Akışı Adı	Kaynağınız için bir ad.
   Fiyatlandırma katmanı	Dil kaynağınızın fiyatlandırma katmanı. Hizmeti denemek için Ücretsiz (F0) katmanını kullanabilirsiniz.

   Not

   "Oturum açma hesabınız seçili depolama hesabının kaynak grubunun sahibi değil" iletisini alırsanız, Dil kaynağı oluşturabilmeniz için önce hesabınızın kaynak grubunda sahip rolü atanmış olması gerekir. Yardım için Azure aboneliğinizin sahibine başvurun.

4. Özel metin sınıflandırması & özel adlandırılmış varlık tanıma bölümünde mevcut bir depolama hesabını seçin veya Yeni depolama hesabı'nı seçin. Bu değerler, üretim ortamlarında kullanmak isteyeceğiniz depolama hesabı değerlerini değil, kullanmaya başlamanıza yardımcı olmak için kullanılır. Projenizi oluştururken gecikme süresini önlemek için Dil kaynağınızla aynı bölgedeki depolama hesaplarına bağlanın.

   hesap değerini Depolama	Önerilen değer
   Depolama hesabı adı	Herhangi bir ad
   Storage account type	Standart LRS

5. Sorumlu Yapay Zeka Bildirimi'nin işaretli olduğundan emin olun. Sayfanın alt kısmındaki Gözden geçir + oluştur'u ve ardından Oluştur'u seçin.

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	Dil kaynağınızın bölgesi.
Fiyatlandırma katmanı	Dil kaynağınızın fiyatlandırma katmanı.

Önemli

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

Özel adlandırılmış varlık tanımayı kullanmak için , henüz bir Azure depolama hesabınız yoksa bir Azure depolama hesabı oluşturmanız gerekir.

PowerShell kullanarak yeni bir Dil kaynağı oluşturma

GitHub'da barındırılan aşağıdaki CLI şablonu ve parametre dosyalarını kullanarak yeni bir kaynak ve depolama hesabı oluşturabilirsiniz.

Parametre dosyasında aşağıdaki değerleri düzenleyin:

Parametre adı	Değer, açıklama
name	Dil kaynağınızın adı
location	Kaynağınızın barındırıldığı bölge. daha fazla bilgi için bkz . Hizmet sınırları.
sku	Kaynağınızın fiyatlandırma katmanı .
storageResourceName	Depolama hesabınızın adı
storageLocation	Depolama hesabınızın barındırıldığı bölge.
storageSkuType	Depolama hesabınızın SKU'su.
storageResourceGroupName	Depolama hesabınızın kaynak grubu

Azure Resource Manager (ARM) şablonunu düzenlediğiniz dosyalarla dağıtmak için aşağıdaki PowerShell komutunu kullanın.

New-AzResourceGroupDeployment -Name ExampleDeployment -ResourceGroupName ExampleResourceGroup `
  -TemplateFile <path-to-arm-template> `
  -TemplateParameterFile <path-to-parameters-file>

Şablonları ve parametre dosyalarını dağıtma hakkında bilgi için ARM şablonu belgelerine bakın.

Not

• Bir depolama hesabını Dil kaynağınıza bağlama işlemi geri alınamaz, daha sonra bağlantısı kesilemez.
• Dil kaynağınızı yalnızca bir depolama hesabına bağlayabilirsiniz.

Önceden var olan bir Dil kaynağını kullanma

Bu kaynak aşağıdaki gereksinimleri karşılıyorsa, özel NER kullanmaya başlamak için mevcut bir Dil kaynağını kullanabilirsiniz:

Gereksinim	Açıklama
Bölgeler	Mevcut kaynağınızın desteklenen bölgelerden birinde sağlandığından emin olun. Aksi takdirde, bu bölgelerden birinde yeni bir kaynak oluşturmanız gerekir.
Fiyatlandırma katmanı	Desteklenen fiyatlandırma katmanları hakkında daha fazla bilgi edinin.
Yönetilen kimlik	Kaynağın yönetilen kimlik ayarının etkinleştirildiğinden emin olun. Aksi takdirde, sonraki bölümü okuyun.

Özel adlandırılmış varlık tanımayı kullanmak için , henüz bir Azure depolama hesabınız yoksa bir Azure depolama hesabı oluşturmanız gerekir.

Kaynağınız için kimlik yönetimini etkinleştirme

Azure portalı

Dil kaynağınızın Azure portalını kullanarak etkinleştirmek için kimlik yönetimine sahip olması gerekir:

1. Dil kaynağınıza gidin
2. Sol taraftaki menüden Kaynak Yönetimi bölümü altında Kimlik'i seçin
3. Sistem tarafından atanan sekmesinde Durum'un Açık olarak ayarlandığından emin olun

Language Studio

Language Studio kullanarak etkinleştirmek için Dil kaynağınızın kimlik yönetimi olmalıdır:

1. Ekranın sağ üst köşesindeki ayarlar simgesini seçin
2. Kaynaklar'ı seçin
3. Azure AI Dil kaynağınız için Yönetilen Kimlik onay kutusunu seçin.

Özel adlandırılmış varlık tanıma özelliğini etkinleştirme

Azure portalından Özel metin sınıflandırması / Özel Adlandırılmış Varlık Tanıma özelliğini etkinleştirdiğinizden emin olun.

1. Azure portalında Dil kaynağınıza gidin.
2. Sol taraftaki menüden Kaynak Yönetimi bölümünde Özellikler'i seçin.
3. Özel metin sınıflandırmasını / Özel Adlandırılmış Varlık Tanıma özelliğini etkinleştirin.
4. Depolama hesabınızı Bağlan.
5. Uygula’yı seçin.

Önemli

• Dil kaynağınızda , bağlanmakta olduğunuz depolama hesabında depolama blobu veri katkıda bulunanı rolü atandığından emin olun.

Gerekli rolleri ekleme

Dil kaynağınız ve depolama hesabınız için gerekli rolleri ayarlamak için aşağıdaki adımları kullanın.

Azure AI Dil kaynağınız için roller

1. Azure portalında depolama hesabınıza veya Dil kaynağınıza gidin.

2. Sol gezinti menüsünde Erişim Denetimi (IAM) öğesini seçin.

3. Rol Atamaları Eklemek için Ekle'yi seçin ve hesabınız için uygun rolü seçin.

   Dil kaynağınızda sahip veya katkıda bulunan rolü atanmış olmalıdır.

4. Erişim ata bölümünde Kullanıcı, grup veya hizmet sorumlusu'na tıklayın

5. Üye seç'i seçin

6. Kullanıcı adınızı seçin. Kullanıcı adlarını Seç alanında arayabilirsiniz . Bunu tüm roller için yineleyin.

7. Bu kaynağa erişmesi gereken tüm kullanıcı hesapları için bu adımları yineleyin.

Depolama hesabınız için roller

1. Azure portalında depolama hesabı sayfanıza gidin.
2. Sol gezinti menüsünde Erişim Denetimi (IAM) öğesini seçin.
3. Rol Atamaları Eklemek için Ekle'yi seçin ve depolama hesabında Depolama blob verileri katkıda bulunan rolünü seçin.
4. Erişim ata'nın içinde Yönetilen kimlik'i seçin.
5. Üye seç'i seçin
6. Aboneliğinizi ve yönetilen kimlik olarak Dil'i seçin. Kullanıcı adlarını Seç alanında arayabilirsiniz .

Önemli

Sanal ağınız veya özel uç noktanız varsa, Güvenilen hizmetler listesindeki Azure hizmetlerinin Azure portalında bu depolama hesabına erişmesine izin ver'i seçtiğinizden emin olun.

Depolama hesabınız için CORS'yi etkinleştirme

Çıkış Noktaları Arası Kaynak Paylaşımı'nı (CORS) etkinleştirirken (GET, PUT, DELETE) yöntemlerine izin verdiğinizden emin olun. İzin verilen çıkış noktaları alanını olarak https://language.cognitive.azure.comayarlayın. İzin verilen üst bilgi değerlerine ekleyerek * tüm üst bilgilere izin verin ve en büyük yaşı olarak 500ayarlayın.

Özel adlandırılmış varlık tanıma projesi oluşturma

Kaynak ve depolama kapsayıcınız yapılandırıldıktan sonra yeni bir özel NER projesi oluşturun. Proje, verilerinize göre özel yapay zeka modellerinizi oluşturmaya yönelik bir çalışma alanıdır. Projenize yalnızca siz ve kullanılmakta olan Azure kaynağına erişimi olan diğer kişiler erişebilir. Verileri etiketlediyseniz, projeyi içeri aktararak kullanmaya başlamak için bu verileri kullanabilirsiniz.

Language Studio

1. Language Studio'da oturum açın. Aboneliğinizi ve Dil kaynağınızı seçmenizi sağlayacak bir pencere görüntülenir. Yukarıdaki adımda oluşturduğunuz Dil kaynağını seçin.

2. Language Studio'nun Bilgileri ayıkla bölümünde Özel adlandırılmış varlık tanıma'yı seçin.

   

3. Projeler sayfanızın üst menüsünden Yeni proje oluştur'u seçin. Proje oluşturmak, modellerinizi etiketlemenize, eğitmenize, değerlendirmenize, geliştirmenize ve dağıtmanıza olanak tanır.

   

4. Yeni proje oluştur'a tıkladıktan sonra, depolama hesabınızı bağlamanıza olanak sağlayan bir pencere görüntülenir. Zaten bir depolama hesabı bağladıysanız, hesaplanmış depolamanın bağlı olduğunu görürsünüz. Aksi takdirde, görüntülenen açılan listeden depolama hesabınızı seçin ve Bağlan depolama hesabını seçin; bu işlem depolama hesabınız için gerekli rolleri ayarlar. Depolama hesabında sahip olarak atanmadıysanız bu adım büyük olasılıkla bir hata döndürür.

   Not

   • Bu adımı, kullandığınız her yeni kaynak için yalnızca bir kez yapmanız gerekir.
   • Bu işlem geri alınamaz. Bir depolama hesabını Dil kaynağınıza bağlarsanız daha sonra bağlantısını kesemezsiniz.
   • Dil kaynağınızı yalnızca bir depolama hesabına bağlayabilirsiniz.

   

5. Projenizdeki dosyaların adı, açıklaması ve dili de dahil olmak üzere proje bilgilerini girin. Örnek veri kümesini kullanıyorsanız İngilizce'yi seçin. Projenizin adını daha sonra değiştiremezsiniz. İleri'yi seçin

   İpucu

   Veri kümenizin tamamen aynı dilde olması gerekmez. Her birinde desteklenen farklı dillere sahip birden çok belgeniz olabilir. Veri kümeniz farklı dillerde belgeler içeriyorsa veya çalışma zamanı sırasında farklı dillerden metin bekliyorsanız, projeniz için temel bilgileri girerken çok dilli veri kümesini etkinleştir seçeneğini belirleyin. Bu seçenek daha sonra Proje ayarları sayfasından etkinleştirilebilir.

6. Veri kümenizi yüklediğiniz kapsayıcıyı seçin. Verileri zaten etiketlediyseniz desteklenen biçime uydığından emin olun ve Evet, dosyalarım zaten etiketlendi ve JSON etiketleri dosyasını biçimlendirdim'i seçin ve açılan menüden etiketler dosyasını seçin. İleri'yi seçin.

7. Girdiğiniz verileri gözden geçirin ve Proje Oluştur'u seçin.

REST API'leri

Özel adlandırılmış varlık tanıma modeli oluşturmaya başlamak için bir proje oluşturmanız gerekir. Proje oluşturmak, modellerinizi etiketlemenize, eğitmenize, değerlendirmenize, geliştirmenize ve dağıtmanıza olanak tanır.

Not

Proje adı tüm işlemler için büyük/küçük harfe duyarlıdır.

Projenizi oluşturmak için aşağıdaki URL' yi, üst bilgileri ve JSON gövdesini kullanarak bir PATCH isteği oluşturun.

İstek URL’si

Proje oluşturmak için 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/{projectName}?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 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.

Gövde

İsteğinizde aşağıdaki JSON'yi kullanın. Aşağıdaki yer tutucu değerlerini kendi değerlerinizle değiştirin.

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "CustomEntityRecognition",
  "description": "Project description",
  "multilingual": "True",
  "storageInputContainerName": "{CONTAINER-NAME}"
}

Anahtar	Yer tutucu	Değer	Örnek
projectName	{PROJECT-NAME}	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	myProject
dil	{LANGUAGE-CODE}	Projenizde kullanılan belgelerin dil kodunu belirten bir dize. Projeniz çok dilli bir projeyse, belgelerin çoğunun dil kodunu seçin. Desteklenen dil kodları hakkında daha fazla bilgi edinmek için bkz . dil desteği .	en-us
projectKind	CustomEntityRecognition	Proje türünüz.	CustomEntityRecognition
Çok dilli	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
storageInputContainerName	{CONTAINER-NAME	Belgelerinizi yüklediğiniz Azure depolama kapsayıcınızın adı.	myContainer

Bu istek bir 201 yanıtı döndürür ve bu da projenin oluşturulduğu anlamına gelir.

Bu istek şu durumda bir hata döndürür:

• Seçilen kaynağın depolama hesabı için uygun izni yok.

Projeyi içeri aktarma

Verileri zaten etiketlediyseniz, hizmeti kullanmaya başlamak için kullanabilirsiniz. Etiketli verilerinizin kabul edilen veri biçimlerini izlediğinden emin olun.

Language Studio

1. Language Studio'da oturum açın. Aboneliğinizi ve Dil kaynağınızı seçmenizi sağlayacak bir pencere görüntülenir. Dil kaynağınızı seçin.

2. Language Studio'nun Bilgileri ayıkla bölümünde Özel adlandırılmış varlık tanıma'yı seçin.

   

3. Projeler sayfanızın üst menüsünden Yeni proje oluştur'u seçin. Proje oluşturmak, modellerinizi etiketlemenize, eğitmenize, değerlendirmenize, geliştirmenize ve dağıtmanıza olanak tanır.

   

4. Yeni proje oluştur'u seçtikten sonra, depolama hesabınızı bağlamanıza olanak sağlayan bir ekran görüntülenir. Depolama hesabınızı bulamıyorsanız, önerilen adımları kullanarak bir kaynak oluşturduğunuzdan emin olun. Dil kaynağınıza zaten bir depolama hesabı bağladıysanız depolama hesabınızın bağlı olduğunu görürsünüz.

   Not

   • Bu adımı, kullandığınız her yeni dil kaynağı için yalnızca bir kez yapmanız gerekir.
   • Bu işlem geri alınamaz. Bir depolama hesabını Dil kaynağınıza bağlarsanız daha sonra bağlantısını kesemezsiniz.
   • Dil kaynağınızı yalnızca bir depolama hesabına bağlayabilirsiniz.

   

5. Projenizdeki dosyaların adı, açıklaması ve dili de dahil olmak üzere proje bilgilerini girin. Projenizin adını daha sonra değiştiremezsiniz. İleri'yi seçin.

   İpucu

   Veri kümenizin tamamen aynı dilde olması gerekmez. Her birinde desteklenen farklı dillere sahip birden çok belgeniz olabilir. Veri kümeniz farklı dillerde belgeler içeriyorsa veya çalışma zamanı sırasında farklı dillerden metin bekliyorsanız, projeniz için temel bilgileri girerken çok dilli veri kümesini etkinleştir seçeneğini belirleyin. Bu seçenek daha sonra Proje ayarları sayfasından etkinleştirilebilir.

6. Veri kümenizi yüklediğiniz kapsayıcıyı seçin.

7. Evet, dosyalarım zaten etiketlenmiş ve JSON etiketleri dosyasını biçimlendirdim'i seçin ve JSON etiketleri dosyanızı içeri aktarmak için aşağıdaki açılan menüden etiketler dosyasını seçin. Desteklenen biçime uydığından emin olun.

8. İleri'yi seçin.

9. Girdiğiniz verileri gözden geçirin ve Proje Oluştur'u seçin.

REST API'leri

Etiket dosyanızı içeri aktarmak için aşağıdaki URL'yi, üst bilgileri ve JSON gövdesini kullanarak bir POST isteği gönderin. Etiketler dosyanızın kabul edilen biçime uygun olduğundan emin olun.

Aynı ada sahip bir proje zaten varsa, o projenin verileri değiştirilir.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}/: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ü. 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.

Gövde

İsteğinizde aşağıdaki JSON'yi kullanın. Aşağıdaki yer tutucu değerlerini kendi değerlerinizle değiştirin.

{
    "projectFileVersion": "{API-VERSION}",
    "stringIndexType": "Utf16CodeUnit",
    "metadata": {
        "projectName": "{PROJECT-NAME}",
        "projectKind": "CustomEntityRecognition",
        "description": "Trying out custom NER",
        "language": "{LANGUAGE-CODE}",
        "multilingual": true,
        "storageInputContainerName": "{CONTAINER-NAME}",
        "settings": {}
    },
    "assets": {
    "projectKind": "CustomEntityRecognition",
        "entities": [
            {
                "category": "Entity1"
            },
            {
                "category": "Entity2"
            }
        ],
        "documents": [
            {
                "location": "{DOCUMENT-NAME}",
                "language": "{LANGUAGE-CODE}",
                "dataset": "{DATASET}",
                "entities": [
                    {
                        "regionOffset": 0,
                        "regionLength": 500,
                        "labels": [
                            {
                                "category": "Entity1",
                                "offset": 25,
                                "length": 10
                            },
                            {
                                "category": "Entity2",
                                "offset": 120,
                                "length": 8
                            }
                        ]
                    }
                ]
            },
            {
                "location": "{DOCUMENT-NAME}",
                "language": "{LANGUAGE-CODE}",
                "dataset": "{DATASET}",
                "entities": [
                    {
                        "regionOffset": 0,
                        "regionLength": 100,
                        "labels": [
                            {
                                "category": "Entity2",
                                "offset": 20,
                                "length": 5
                            }
                        ]
                    }
                ]
            }
        ]
    }
}

Anahtar	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. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinin	2022-03-01-preview
projectName	{PROJECT-NAME}	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	myProject
projectKind	CustomEntityRecognition	Proje türünüz.	CustomEntityRecognition
language	{LANGUAGE-CODE}	Projenizde kullanılan belgelerin dil kodunu belirten bir dize. Projeniz çok dilli bir projeyse, belgelerin çoğ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 bilgi için bkz. dil desteği.	true
storageInputContainerName	{CONTAINER-NAME}	Belgelerinizi yüklediğiniz Azure depolama kapsayıcınızın adı.	myContainer
entities		Projede sahip olduğunuz tüm varlık türlerini içeren dizi. Bunlar, belgelerinizden içine ayıklanacak varlık türleridir.
documents		Projenizdeki tüm belgeleri ve her belge içinde etiketlenmiş varlıkların listesini içeren dizi.	[]
location	{DOCUMENT-NAME}	Depolama kapsayıcısında belgelerin konumu. Tüm belgeler kapsayıcının kökünde olduğundan, belge adı bu olmalıdır.	doc1.txt
dataset	{DATASET}	Eğitimden önce bölündüğünde bu dosyanın gideceği test kümesi. Verilerinizin nasıl bölündüğü hakkında daha fazla bilgi için bkz . Modeli eğitma. Bu alanın olası değerleri ve TestşeklindedirTrain.	Train

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}/import/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. İçeri aktarma işi durumunu almak için bu URL'yi kullanacaksınız.

Bu istek için olası hata senaryoları:

• Seçilen kaynağın depolama hesabı için uygun izinleri yok.
• Belirtilen storageInputContainerName yok.
• Geçersiz dil kodu kullanılır veya dil kodu türü dize değilse.
• multilingual değeri boole değil bir dizedir.

Proje 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ştirebilir ve proje ayarlarında Çok dilli veri kümesini etkinleştirebilir/devre dışı bırakabilirsiniz.

4. Dil kaynağınıza bağlı depolama hesabını ve kapsayıcıyı da görüntüleyebilirsiniz.

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

   

REST API'leri

Proje ayrıntılarınızı almak için aşağıdaki GET isteğini kullanın. Aşağıdaki yer tutucu değerlerini kendi değerlerinizle değiştirin.

{ENDPOINT}/language/authoring/analyze-text/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ü. 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

    {
        "createdDateTime": "2021-10-19T23:24:41.572Z",
        "lastModifiedDateTime": "2021-10-19T23:24:41.572Z",
        "lastTrainedDateTime": "2021-10-19T23:24:41.572Z",
        "lastDeployedDateTime": "2021-10-19T23:24:41.572Z",
        "projectKind": "CustomEntityRecognition",
        "storageInputContainerName": "{CONTAINER-NAME}",
        "projectName": "{PROJECT-NAME}",
        "multilingual": false,
        "description": "Project description",
        "language": "{LANGUAGE-CODE}"
    }

Değer	Yer tutucu	Veri Akışı Açıklaması	Örnek
projectKind	CustomEntityRecognition	Proje türünüz.	CustomEntityRecognition
storageInputContainerName	{CONTAINER-NAME}	Belgelerinizi yüklediğiniz Azure depolama kapsayıcınızın adı.	myContainer
projectName	{PROJECT-NAME}	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	myProject
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 için bkz . Dil desteği.	true
language	{LANGUAGE-CODE}	Projenizde kullanılan belgelerin dil kodunu belirten bir dize. Projeniz çok dilli bir projeyse, belgelerin çoğunun dil kodunu seçin.	en-us

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. Üst kısımdan Özel adlandırılmış varlık tanıma (NER) öğesini 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 kalmadığında, aşağıdaki DELETE isteğiyle silebilirsiniz. Yer tutucu değerlerini kendi değerlerinizle değiştirin.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}?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 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 projenizin silindiği anlamına gelir. Başarılı bir çağrı, işin durumunu denetlemek için kullanılan operation-location üst bilgisi ile sonuçlanır.

Sonraki adımlar

• Verilerinizi etiketlemek için kullanacağınız proje şeması hakkında bir fikriniz olmalıdır.

• Projeniz oluşturulduktan sonra verilerinizi etiketlemeye başlayabilirsiniz. Bu, varlık ayıklama modelinize metni nasıl yorumlayabileceğinizi bildirir ve eğitim ve değerlendirme için kullanılır.