Jak utworzyć niestandardowe analiza tekstu dla projektu kondycji

Skorzystaj z tego artykułu, aby dowiedzieć się, jak skonfigurować wymagania dotyczące rozpoczynania pracy z niestandardową analizą tekstu na potrzeby kondycji i tworzenia projektu.

Wymagania wstępne

Przed rozpoczęciem korzystania z niestandardowej analizy tekstu na potrzeby kondycji potrzebne są następujące elementy:

• Subskrypcja platformy Azure — utwórz bezpłatnie.

Tworzenie zasobu języka

Przed rozpoczęciem korzystania z niestandardowej analizy tekstu na potrzeby kondycji potrzebny będzie zasób języka sztucznej inteligencji platformy Azure. Zaleca się utworzenie zasobu Language i połączenie z nim konta magazynu w witrynie Azure Portal. Utworzenie zasobu w witrynie Azure Portal umożliwia jednoczesne utworzenie konta usługi Azure Storage ze wszystkimi wymaganymi uprawnieniami wstępnie skonfigurowanymi. Możesz również przeczytać więcej w artykule, aby dowiedzieć się, jak używać istniejącego zasobu i skonfigurować go do pracy z niestandardową analizą tekstu pod kątem kondycji.

Potrzebne będzie również konto usługi Azure Storage, na którym zostaną przekazane .txt dokumenty, które będą używane do trenowania modelu w celu wyodrębniania jednostek.

Uwaga

• Aby utworzyć zasób języka, musisz mieć przypisaną rolę właściciela w grupie zasobów.
• Jeśli połączysz istniejące wcześniej konto magazynu, musisz mieć przypisaną rolę właściciela.

Tworzenie zasobu języka i łączenie konta magazynu

Zasób można utworzyć na następujące sposoby:

• Azure Portal
• Language Studio
• PowerShell

Uwaga

Nie należy przenosić konta magazynu do innej grupy zasobów lub subskrypcji po połączeniu z zasobem Language.

Tworzenie nowego zasobu w witrynie Azure Portal

1. Przejdź do witryny Azure Portal, aby utworzyć nowy zasób języka sztucznej inteligencji platformy Azure.

2. W wyświetlonym oknie wybierz tę usługę z funkcji niestandardowych. Wybierz pozycję Kontynuuj, aby utworzyć zasób w dolnej części ekranu.

   

3. Utwórz zasób języka, postępując zgodnie z poniższymi szczegółami.

   Nazwa/nazwisko	opis
   Subskrypcja	Swoją subskrypcję platformy Azure.
   Grupa zasobów	Grupa zasobów, która będzie zawierać zasób. Możesz użyć istniejącej lub utworzyć nową.
   Region (Region)	Region zasobu Language. Na przykład "Zachodnie stany USA 2".
   Nazwisko	Nazwa zasobu.
   Warstwa cenowa	Warstwa cenowa zasobu Language. Aby wypróbować usługę, możesz użyć warstwy Bezpłatna (F0).

   Uwaga

   Jeśli zostanie wyświetlony komunikat "Twoje konto logowania nie jest właścicielem wybranej grupy zasobów konta magazynu", twoje konto musi mieć przypisaną rolę właściciela w grupie zasobów, zanim będzie można utworzyć zasób językowy. Skontaktuj się z właścicielem subskrypcji platformy Azure, aby uzyskać pomoc.

4. W sekcji tej usługi wybierz istniejące konto magazynu lub wybierz pozycję Nowe konto magazynu. Te wartości ułatwiają rozpoczęcie pracy, a niekoniecznie wartości konta magazynu, których chcesz użyć w środowiskach produkcyjnych. Aby uniknąć opóźnień podczas kompilowania projektu, połącz się z kontami magazynu w tym samym regionie co zasób języka.

   Wartość konta magazynu	Zalecana wartość
   Nazwa konta magazynu	Dowolna nazwa
   Storage account type	Standardowa LRS

5. Upewnij się, że zaznaczono powiadomienie o odpowiedzialnej sztucznej inteligencji . Wybierz pozycję Przejrzyj i utwórz w dolnej części strony, a następnie wybierz pozycję Utwórz.

Tworzenie nowego zasobu językowego z poziomu programu Language Studio

Jeśli po raz pierwszy się zalogujesz, zostanie wyświetlone okno w programie Language Studio , które pozwoli wybrać istniejący zasób języka lub utworzyć nowy. Zasób można również utworzyć, klikając ikonę ustawień w prawym górnym rogu, wybierając pozycję Zasoby, a następnie klikając pozycję Utwórz nowy zasób.

Utwórz zasób języka, postępując zgodnie z poniższymi szczegółami.

Szczegóły wystąpienia	Wartość wymagana
Subskrypcja platformy Azure	Subskrypcja platformy Azure
Grupa zasobów platformy Azure	Grupa zasobów platformy Azure
Nazwa zasobu platformy Azure	Nazwa zasobu platformy Azure
Lokalizacja	Region
Warstwa cenowa	Warstwa cenowa zasobu Language.

Ważne

• Pamiętaj, aby włączyć tożsamość zarządzaną podczas tworzenia zasobu language.
• Przeczytaj i potwierdź powiadomienie o odpowiedzialnej sztucznej inteligencji

Aby korzystać z tej usługi, musisz utworzyć konto usługi Azure Storage, jeśli jeszcze go nie masz.

Tworzenie nowego zasobu językowego przy użyciu programu PowerShell

Nowy zasób i konto magazynu można utworzyć przy użyciu następujących plików szablonu interfejsu wiersza polecenia i parametrów, które są hostowane w usłudze GitHub.

Edytuj następujące wartości w pliku parametrów:

Nazwa parametru	Opis wartości
name	Nazwa zasobu language
location	Region, w którym jest hostowany zasób.
sku	Warstwa cenowa zasobu.
storageResourceName	Nazwa konta magazynu
storageLocation	Region, w którym jest hostowane konto magazynu.
storageSkuType	Jednostka SKU konta magazynu.
storageResourceGroupName	Grupa zasobów konta magazynu

Użyj następującego polecenia programu PowerShell, aby wdrożyć szablon usługi Azure Resource Manager (ARM) przy użyciu edytowanych plików.

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

Zapoznaj się z dokumentacją szablonu usługi ARM, aby uzyskać informacje na temat wdrażania szablonów i plików parametrów.

Uwaga

• Proces łączenia konta magazynu z zasobem języka jest nieodwracalny. Nie można go później odłączyć.
• Zasób językowy można połączyć tylko z jednym kontem magazynu.

Korzystanie z istniejącego zasobu języka

Możesz użyć istniejącego zasobu języka, aby rozpocząć pracę z niestandardowym modułem NER, o ile ten zasób spełnia następujące wymagania:

Wymaganie	opis
Regiony	Upewnij się, że istniejący zasób jest aprowizowany w jednym z obsługiwanych regionów. Jeśli nie, musisz utworzyć nowy zasób w jednym z tych regionów.
Warstwa cenowa	Warstwa cenowa zasobu.
Tożsamość zarządzana	Upewnij się, że ustawienie tożsamości zarządzanej zasobu jest włączone. W przeciwnym razie przeczytaj następną sekcję.

Aby użyć niestandardowej analizy tekstu na potrzeby kondycji, musisz utworzyć konto usługi Azure Storage, jeśli jeszcze go nie masz.

Włączanie zarządzania tożsamościami dla zasobu

Witryna Azure Portal

Zasób języka musi mieć zarządzanie tożsamościami. Aby ją włączyć przy użyciu witryny Azure Portal:

1. Przejdź do zasobu Language
2. W menu po lewej stronie w sekcji Zarządzanie zasobami wybierz pozycję Tożsamość
3. Na karcie Przypisane przez system upewnij się, że ustawiono opcję Stan na Włączone

Language Studio

Aby umożliwić korzystanie z programu Language Studio, zasób języka musi mieć zarządzanie tożsamościami:

1. Wybierz ikonę ustawień w prawym górnym rogu ekranu
2. Wybieranie zasobów
3. Zaznacz pole wyboru Tożsamość zarządzana dla zasobu języka sztucznej inteligencji platformy Azure.

Włączanie niestandardowej analizy tekstu na potrzeby kondycji

Upewnij się, że włączono niestandardową klasyfikację tekstu/niestandardowe rozpoznawanie nazwanych jednostek/niestandardową analizę tekstu dla funkcji kondycji w witrynie Azure Portal.

1. Przejdź do zasobu Language w witrynie Azure Portal.
2. W menu po lewej stronie w sekcji Zarządzanie zasobami wybierz pozycję Funkcje
3. Włączanie niestandardowej klasyfikacji tekstu/niestandardowej funkcji rozpoznawania jednostek nazwanych/niestandardowej analizy tekstu
4. Połączenie konta magazynu
5. Wybierz Zastosuj

Ważne

• Upewnij się, że zasób języka ma przypisaną rolę współautora danych obiektu blob magazynu na połączonym koncie magazynu.

Dodawanie wymaganych ról

Wykonaj poniższe kroki, aby ustawić wymagane role dla zasobu języka i konta magazynu.

Role dla zasobu języka sztucznej inteligencji platformy Azure

1. Przejdź do swojego konta magazynu lub zasobu językowego w witrynie Azure Portal.

2. Wybierz pozycję Kontrola dostępu (Zarządzanie dostępem i tożsamościami) w menu nawigacji po lewej stronie.

3. Wybierz pozycję Dodaj, aby dodać przypisania ról, a następnie wybierz odpowiednią rolę dla twojego konta.

   Musisz mieć przypisaną rolę właściciela lub współautora w zasobie Język.

4. W obszarze Przypisz dostęp do wybierz pozycję Użytkownik, grupa lub jednostka usługi

5. Wybierz pozycję Wybierz członków

6. Wybierz nazwę użytkownika. Nazwy użytkowników można wyszukać w polu Wybierz . Powtórz to dla wszystkich ról.

7. Powtórz te kroki dla wszystkich kont użytkowników, które potrzebują dostępu do tego zasobu.

Role dla konta magazynu

1. Przejdź do strony konta magazynu w witrynie Azure Portal.
2. Wybierz pozycję Kontrola dostępu (Zarządzanie dostępem i tożsamościami) w menu nawigacji po lewej stronie.
3. Wybierz pozycję Dodaj, aby dodać przypisania ról, a następnie wybierz rolę Współautor danych obiektu blob usługi Storage na koncie magazynu.
4. W obszarze Przypisz dostęp do wybierz pozycję Tożsamość zarządzana.
5. Wybierz pozycję Wybierz członków
6. Wybierz swoją subskrypcję i język jako tożsamość zarządzaną. Nazwy użytkowników można wyszukać w polu Wybierz .

Ważne

Jeśli masz sieć wirtualną lub prywatny punkt końcowy, wybierz pozycję Zezwalaj usługom platformy Azure na liście zaufanych usług, aby uzyskać dostęp do tego konta magazynu w witrynie Azure Portal.

Włączanie mechanizmu CORS dla konta magazynu

Upewnij się, że metody (GET, PUT, DELETE) są dozwolone podczas włączania współużytkowania zasobów między źródłami (CORS). Ustaw pole dozwolonych źródeł na https://language.cognitive.azure.comwartość . Zezwalaj na wszystkie nagłówki przez dodanie * do dozwolonych wartości nagłówka i ustaw maksymalny wiek na 500wartość .

Tworzenie niestandardowego analiza tekstu dla projektu kondycji

Po skonfigurowaniu zasobu i kontenera magazynu utwórz nową niestandardową analizę tekstu dla projektu kondycji. Projekt to obszar roboczy umożliwiający tworzenie niestandardowych modeli sztucznej inteligencji na podstawie danych. Dostęp do projektu można uzyskać tylko do Ciebie i innych osób, które mają dostęp do używanego zasobu platformy Azure. Jeśli masz etykiety danych, możesz użyć ich do rozpoczęcia pracy, importując projekt.

Language Studio

1. Zaloguj się do programu Language Studio. Zostanie wyświetlone okno umożliwiające wybranie subskrypcji i zasobu językowego. Wybierz zasób języka utworzony w powyższym kroku.

2. W sekcji Wyodrębnij informacje programu Language Studio wybierz pozycję Niestandardowe analiza tekstu dla kondycji.

3. Wybierz pozycję Utwórz nowy projekt z górnego menu na stronie projektów. Tworzenie projektu umożliwia etykietowanie danych, trenowanie, ocenianie, ulepszanie i wdrażanie modeli.

   

4. Wprowadź informacje o projekcie, w tym nazwę, opis i język plików w projekcie. Jeśli używasz przykładowego zestawu danych, wybierz pozycję Angielski. Nie można później zmienić nazwy projektu. Wybierz Dalej

   Napiwek

   Zestaw danych nie musi być całkowicie w tym samym języku. Można mieć wiele dokumentów, z których każda ma różne obsługiwane języki. Jeśli zestaw danych zawiera dokumenty różnych języków lub jeśli oczekujesz tekstu z różnych języków w czasie wykonywania, wybierz opcję Włącz zestaw danych wielojęzyczny po wprowadzeniu podstawowych informacji dla projektu. Tę opcję można włączyć później na stronie Ustawienia projektu.

5. Po wybraniu pozycji Utwórz nowy projekt zostanie wyświetlone okno umożliwiające nawiązanie połączenia z kontem magazynu. Jeśli masz już połączone konto magazynu, zobaczysz połączone konto magazynu. Jeśli nie, wybierz konto magazynu z wyświetlonej listy rozwijanej i wybierz pozycję Połączenie konto magazynu. Spowoduje to ustawienie wymaganych ról dla konta magazynu. Ten krok może spowodować zwrócenie błędu, jeśli nie masz przypisanego jako właściciel konta magazynu.

   Uwaga

   • Ten krok należy wykonać tylko raz dla każdego nowego zasobu, którego używasz.
   • Ten proces jest nieodwracalny, jeśli połączysz konto magazynu z zasobem języka, nie możesz go odłączyć później.
   • Zasób języka można połączyć tylko z jednym kontem magazynu.

   

6. Wybierz kontener, w którym został przekazany zestaw danych.

7. Jeśli dane zostały już oznaczone etykietą, upewnij się, że jest on zgodny z obsługiwanym formatem i wybierz pozycję Tak, moje pliki są już oznaczone etykietami, a plik etykiet JSON został sformatowany i wybierz plik etykiet z menu rozwijanego. Wybierz Dalej. Jeśli używasz zestawu danych z przewodnika Szybki start, nie trzeba przeglądać formatowania pliku etykiet JSON.

8. Przejrzyj wprowadzone dane i wybierz pozycję Utwórz projekt.

Interfejsy API REST

Aby rozpocząć tworzenie niestandardowych analiza tekstu dla modelu kondycji, należy utworzyć projekt. Utworzenie projektu umożliwi etykietowanie danych, trenowanie, ocenianie, ulepszanie i wdrażanie modeli.

Uwaga

Nazwa projektu uwzględnia wielkość liter dla wszystkich operacji.

Utwórz żądanie PATCH przy użyciu następującego adresu URL, nagłówków i treści JSON, aby utworzyć projekt.

Adres URL żądania

Użyj następującego adresu URL, aby utworzyć projekt. Zastąp poniższe wartości symboli zastępczych własnymi wartościami.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}?api-version={API-VERSION}

Symbol zastępczy	Wartość	Przykład
{ENDPOINT}	Punkt końcowy do uwierzytelniania żądania interfejsu API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nazwa projektu. Ta wartość jest uwzględniana w wielkości liter.	myProject
{API-VERSION}	Wersja wywoływanego interfejsu API. Wartość, do których odwołuje się tutaj, dotyczy najnowszej wersji wydanej. Zobacz Cykl życia modelu, aby dowiedzieć się więcej o innych dostępnych wersjach interfejsu API.	2022-05-01

Nagłówki

Użyj następującego nagłówka, aby uwierzytelnić żądanie.

Key	Wartość
Ocp-Apim-Subscription-Key	Klucz do zasobu. Służy do uwierzytelniania żądań interfejsu API.

Treść

Użyj następującego kodu JSON w żądaniu. Zastąp poniższe wartości symboli zastępczych własnymi wartościami.

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

Klucz	Symbol zastępczy	Wartość	Przykład
projectName	{PROJECT-NAME}	Nazwa projektu. Ta wartość jest uwzględniana w wielkości liter.	myProject
język	{LANGUAGE-CODE}	Ciąg określający kod języka dokumentów używanych w projekcie. Jeśli projekt jest projektem wielojęzycznym, wybierz kod języka większości dokumentów. Zobacz Obsługa języka, aby dowiedzieć się więcej na temat obsługiwanych kodów języków.	en-us
projectKind	CustomHealthcare	Rodzaj projektu.	CustomHealthcare
Wielojęzycznych	true	Wartość logiczna, która umożliwia posiadanie dokumentów w wielu językach w zestawie danych, a po wdrożeniu modelu można wykonywać zapytania względem modelu w dowolnym obsługiwanym języku (niekoniecznie w dokumentach szkoleniowych). Zobacz Obsługa języków, aby dowiedzieć się więcej o obsłudze wielojęzycznej.	true
storageInputContainerName	{CONTAINER-NAME	Nazwa kontenera usługi Azure Storage, w którym zostały przekazane dokumenty.	myContainer

To żądanie zwróci odpowiedź 201, co oznacza, że projekt zostanie utworzony.

To żądanie zwróci błąd, jeśli:

• Wybrany zasób nie ma odpowiednich uprawnień dla konta magazynu.

Importowanie projektu

Jeśli masz już oznaczone dane, możesz użyć ich do rozpoczęcia pracy z usługą. Upewnij się, że dane oznaczone etykietami są zgodne z akceptowanymi formatami danych.

Language Studio

1. Zaloguj się do programu Language Studio. Zostanie wyświetlone okno umożliwiające wybranie subskrypcji i zasobu językowego. Wybierz zasób języka.

2. W sekcji Wyodrębnianie informacji w programie Language Studio wybierz pozycję Analiza tekstu niestandardowego dla kondycji.

3. Wybierz pozycję Utwórz nowy projekt z górnego menu na stronie projektów. Utworzenie projektu umożliwi tagowanie danych, trenowanie, ocenianie, ulepszanie i wdrażanie modeli.

4. Po wybraniu pozycji Utwórz nowy projekt zostanie wyświetlony ekran umożliwiający nawiązanie połączenia z kontem magazynu. Jeśli nie możesz znaleźć konta magazynu, upewnij się, że utworzono zasób, wykonując zalecane kroki. Jeśli masz już połączone konto magazynu z zasobem language, zobaczysz połączone konto magazynu.

   Uwaga

   • Ten krok należy wykonać tylko raz dla każdego nowego zasobu językowego, którego używasz.
   • Ten proces jest nieodwracalny, jeśli połączysz konto magazynu z zasobem języka, nie możesz go odłączyć później.
   • Zasób języka można połączyć tylko z jednym kontem magazynu.

   

5. Wprowadź informacje o projekcie, w tym nazwę, opis i język plików w projekcie. Nie będzie można później zmienić nazwy projektu. Wybierz Dalej.

   Napiwek

   Zestaw danych nie musi być całkowicie w tym samym języku. Można mieć wiele dokumentów, z których każda ma różne obsługiwane języki. Jeśli zestaw danych zawiera dokumenty różnych języków lub jeśli oczekujesz tekstu z różnych języków w czasie wykonywania, wybierz opcję Włącz zestaw danych wielojęzyczny po wprowadzeniu podstawowych informacji dla projektu. Tę opcję można włączyć później na stronie Ustawienia projektu.

6. Wybierz kontener, w którym został przekazany zestaw danych.

7. Wybierz pozycję Tak, moje pliki są już oznaczone etykietami i sformatowano plik etykiet JSON i wybierz plik etykiet z menu rozwijanego poniżej, aby zaimportować plik etykiet JSON. Upewnij się, że jest zgodny z obsługiwanym formatem.

8. Wybierz Dalej.

9. Przejrzyj wprowadzone dane i wybierz pozycję Utwórz projekt.

Interfejsy API REST

Prześlij żądanie POST przy użyciu następującego adresu URL, nagłówków i treści JSON, aby zaimportować plik etykiet. Upewnij się, że plik etykiet jest zgodne z akceptowanym formatem.

Jeśli projekt o tej samej nazwie już istnieje, dane tego projektu zostaną zastąpione.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}/:import?api-version={API-VERSION}

Symbol zastępczy	Wartość	Przykład
{ENDPOINT}	Punkt końcowy do uwierzytelniania żądania interfejsu API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nazwa projektu. Ta wartość jest uwzględniana w wielkości liter.	myProject
{API-VERSION}	Wersja wywoływanego interfejsu API. Wartość, do których odwołuje się tutaj, dotyczy najnowszej wersji wydanej. Zobacz Cykl życia modelu, aby dowiedzieć się więcej o innych dostępnych wersjach interfejsu API.	2022-05-01

Nagłówki

Użyj następującego nagłówka, aby uwierzytelnić żądanie.

Key	Wartość
Ocp-Apim-Subscription-Key	Klucz do zasobu. Służy do uwierzytelniania żądań interfejsu API.

Treść

Użyj następującego kodu JSON w żądaniu. Zastąp poniższe wartości symboli zastępczych własnymi wartościami.

{
	"projectFileVersion": "{API-VERSION}",
	"stringIndexType": "Utf16CodeUnit",
	"metadata": {
		"projectName": "{PROJECT-NAME}",
		"projectKind": "CustomHealthcare",
		"description": "Trying out custom Text Analytics for health",
		"language": "{LANGUAGE-CODE}",
		"multilingual": true,
		"storageInputContainerName": "{CONTAINER-NAME}",
		"settings": {}
	},
	"assets": {
		"projectKind": "CustomHealthcare",
		"entities": [
			{
				"category": "Entity1",
				"compositionSetting": "{COMPOSITION-SETTING}",
				"list": {
					"sublists": [
						{
							"listKey": "One",
							"synonyms": [
								{
									"language": "en",
									"values": [
										"EntityNumberOne",
										"FirstEntity"
									]
								}
							]
						}
					]
				}
			},
			{
				"category": "Entity2"
			},
			{
				"category": "MedicationName",
				"list": {
					"sublists": [
						{
							"listKey": "research drugs",
							"synonyms": [
								{
									"language": "en",
									"values": [
										"rdrug a",
										"rdrug b"
									]
								}
							]

						}
					]
				}
				"prebuilts": "MedicationName"
			}
		],
		"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
							}
						]
					}
				]
			}
		]
	}
}

Klucz	Symbol zastępczy	Wartość	Przykład
multilingual	true	Wartość logiczna, która umożliwia posiadanie dokumentów w wielu językach w zestawie danych, a po wdrożeniu modelu można wykonywać zapytania dotyczące modelu w dowolnym obsługiwanym języku (niekoniecznie zawarte w dokumentach szkoleniowych). Zobacz Obsługa języków, aby dowiedzieć się więcej o obsłudze wielojęzycznej.	true
projectName	{PROJECT-NAME}	Nazwa projektu	myproject
storageInputContainerName	{CONTAINER-NAME}	Nazwa kontenera	mycontainer
entities		Tablica zawierająca wszystkie typy jednostek, które znajdują się w projekcie. Są to typy jednostek, które zostaną wyodrębnione z dokumentów.
category		Nazwa typu jednostki, który może być zdefiniowany przez użytkownika dla nowych definicji jednostek lub wstępnie zdefiniowany dla wstępnie utworzonych jednostek.
compositionSetting	{COMPOSITION-SETTING}	Reguła definiująca sposób zarządzania wieloma składnikami w jednostce. Opcje to combineComponents lub separateComponents.	combineComponents
list		Tablica zawierająca wszystkie listy podrzędne, które znajdują się w projekcie dla określonej jednostki. Listy można dodawać do wstępnie utworzonych jednostek lub nowych jednostek ze poznanymi składnikami.
sublists	[]	Tablica zawierająca listy podrzędne. Każda lista podrzędna jest kluczem i skojarzonymi z nimi wartościami.	[]
listKey	One	Znormalizowana wartość listy synonimów, które mają być mapowane z powrotem na w przewidywaniu.	One
synonyms	[]	Tablica zawierająca wszystkie synonimy	Synonim
language	{LANGUAGE-CODE}	Ciąg określający kod języka synonimu na liście podrzędnej. Jeśli projekt jest wielojęzycznym projektem i chcesz obsługiwać listę synonimów dla wszystkich języków w projekcie, musisz jawnie dodać synonimy do każdego języka. Aby uzyskać więcej informacji na temat obsługiwanych kodów języków, zobacz Obsługa języka.	en
values	"EntityNumberone", "FirstEntity"	Lista ciągów rozdzielonych przecinkami, które będą dokładnie dopasowane do wyodrębniania i mapowania na klucz listy.	"EntityNumberone", "FirstEntity"
prebuilts	MedicationName	Nazwa wstępnie utworzonego składnika wypełniającego wstępnie utworzoną jednostkę. Wstępnie utworzone jednostki są domyślnie ładowane do projektu, ale można je rozszerzać za pomocą składników listy w pliku etykiet.	MedicationName
documents		Tablica zawierająca wszystkie dokumenty w projekcie i listę jednostek oznaczonych w każdym dokumencie.	[]
location	{DOCUMENT-NAME}	Lokalizacja dokumentów w kontenerze magazynu. Ponieważ wszystkie dokumenty znajdują się w katalogu głównym kontenera, powinien to być nazwa dokumentu.	doc1.txt
dataset	{DATASET}	Zestaw testowy, do którego ten plik zostanie podzielony przed rozpoczęciem trenowania. Możliwe wartości dla tego pola to Train i Test.	Train
regionOffset		Położenie znaku inkluzywnego początku tekstu.	0
regionLength		Długość pola ograniczenia pod względem znaków UTF16. Szkolenie uwzględnia tylko dane w tym regionie.	500
category		Typ jednostki skojarzonej z określonym zakresem tekstu.	Entity1
offset		Pozycja początkowa tekstu jednostki.	25
length		Długość jednostki pod względem znaków UTF16.	20
language	{LANGUAGE-CODE}	Ciąg określający kod języka dokumentu używanego w projekcie. Jeśli projekt jest projektem wielojęzycznym, wybierz kod języka większości dokumentów. Aby uzyskać więcej informacji na temat obsługiwanych kodów języków, zobacz Obsługa języka.	en

Po wysłaniu żądania interfejsu API otrzymasz odpowiedź wskazującą 202 , że zadanie zostało przesłane poprawnie. W nagłówkach odpowiedzi wyodrębnij operation-location wartość. Zostanie on sformatowany w następujący sposób:

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

{JOB-ID} służy do identyfikowania żądania, ponieważ ta operacja jest asynchroniczna. Użyjesz tego adresu URL, aby uzyskać stan zadania importu.

Możliwe scenariusze błędów dla tego żądania:

• Wybrany zasób nie ma odpowiednich uprawnień dla konta magazynu.
• Określona storageInputContainerName wartość nie istnieje.
• Jest używany nieprawidłowy kod języka lub jeśli typ kodu języka nie jest ciągiem.
• multilingual wartość jest ciągiem, a nie wartością logiczną.

Pobieranie szczegółów projektu

Language Studio

1. Przejdź do strony ustawień projektu w programie Language Studio.

2. Możesz wyświetlić szczegóły projektu.

3. Na tej stronie można zaktualizować opis projektu i włączyć/wyłączyć wielojęzyczny zestaw danych w ustawieniach projektu.

4. Możesz również wyświetlić połączone konto magazynu i kontener do zasobu Language.

5. Możesz również pobrać klucz zasobu podstawowego z tej strony.

   

Interfejsy API REST

Użyj następującego żądania GET , aby uzyskać szczegóły projektu. Zastąp poniższe wartości symboli zastępczych własnymi wartościami.

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}?api-version={API-VERSION}

Symbol zastępczy	Wartość	Przykład
{ENDPOINT}	Punkt końcowy do uwierzytelniania żądania interfejsu API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nazwa projektu. Ta wartość jest uwzględniana w wielkości liter.	myProject
{API-VERSION}	Wersja wywoływanego interfejsu API. Zobacz Cykl życia modelu, aby dowiedzieć się więcej o innych dostępnych wersjach interfejsu API.	2022-05-01

Nagłówki

Użyj następującego nagłówka, aby uwierzytelnić żądanie.

Key	Wartość
Ocp-Apim-Subscription-Key	Klucz do zasobu. Służy do uwierzytelniania żądań interfejsu API.

Treść odpowiedzi

    {
        "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": "CustomHealthcare",
        "storageInputContainerName": "{CONTAINER-NAME}",
        "projectName": "{PROJECT-NAME}",
        "multilingual": false,
        "description": "Project description",
        "language": "{LANGUAGE-CODE}"
    }

Wartość	Symbol zastępczy	opis	Przykład
projectKind	CustomHealthcare	Rodzaj projektu.	CustomHealthcare
storageInputContainerName	{CONTAINER-NAME}	Nazwa kontenera usługi Azure Storage, w którym zostały przekazane dokumenty.	myContainer
projectName	{PROJECT-NAME}	Nazwa projektu. Ta wartość jest uwzględniana w wielkości liter.	myProject
multilingual	true	Wartość logiczna, która umożliwia posiadanie dokumentów w wielu językach w zestawie danych, a po wdrożeniu modelu można wykonywać zapytania względem modelu w dowolnym obsługiwanym języku (niekoniecznie w dokumentach szkoleniowych). Aby uzyskać więcej informacji na temat obsługi wielojęzycznej, zobacz Obsługa języków.	true
language	{LANGUAGE-CODE}	Ciąg określający kod języka dokumentów używanych w projekcie. Jeśli projekt jest projektem wielojęzycznym, wybierz kod języka większości dokumentów.	en

Po wysłaniu żądania interfejsu API otrzymasz odpowiedź wskazującą 200 powodzenie i treść odpowiedzi JSON ze szczegółami projektu.

Usuwanie projektu

Language Studio

Jeśli projekt nie jest już potrzebny, możesz usunąć projekt przy użyciu programu Language Studio.

1. Wybierz funkcję usługi językowej, której używasz w górnej części strony,
2. Wybierz projekt, który chcesz usunąć
3. Wybierz pozycję Usuń z górnego menu.

Interfejsy API REST

Jeśli projekt nie jest już potrzebny, możesz go usunąć za pomocą następującego żądania DELETE . Zastąp wartości symboli zastępczych własnymi wartościami.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}?api-version={API-VERSION}

Symbol zastępczy	Wartość	Przykład
{ENDPOINT}	Punkt końcowy do uwierzytelniania żądania interfejsu API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nazwa projektu. Ta wartość jest uwzględniana w wielkości liter.	myProject
{API-VERSION}	Wersja wywoływanego interfejsu API. Wartość, do których odwołuje się tutaj, dotyczy najnowszej wersji wydanej. Zobacz Cykl życia modelu, aby dowiedzieć się więcej o innych dostępnych wersjach interfejsu API.	2022-05-01

Nagłówki

Użyj następującego nagłówka, aby uwierzytelnić żądanie.

Key	Wartość
Ocp-Apim-Subscription-Key	Klucz do zasobu. Służy do uwierzytelniania żądań interfejsu API.

Po wysłaniu żądania interfejsu API otrzymasz odpowiedź wskazującą 202 powodzenie, co oznacza, że projekt został usunięty. Wyniki pomyślnego wywołania z nagłówkiem Operation-Location służącym do sprawdzania stanu zadania.

Następne kroki

• Musisz mieć pomysł na schemat projektu, którego będziesz używać do etykietowania danych.

• Po zdefiniowaniu schematu można rozpocząć etykietowanie danych, które będą używane do trenowania, oceny modelu i wprowadzania przewidywań.