Jak vytvořit vlastní Analýza textu pro projekt stavu

V tomto článku se dozvíte, jak nastavit požadavky pro zahájení vlastní analýzy textu pro stav a vytvoření projektu.

Požadavky

Než začnete používat vlastní analýzu textu pro stav, potřebujete:

• Předplatné Azure – Vytvořte si ho zdarma.

Vytvoření prostředku jazyka

Než začnete používat vlastní analýzu textu pro stav, budete potřebovat prostředek Azure AI Language. Doporučujeme vytvořit prostředek jazyka a připojit k němu účet úložiště na webu Azure Portal. Vytvoření prostředku na webu Azure Portal umožňuje vytvořit účet úložiště Azure současně se všemi požadovanými oprávněními předem nakonfigurovanými. Dále si můžete přečíst v článku, kde se dozvíte, jak používat existující prostředek, a nakonfigurovat ho tak, aby fungoval s vlastní analýzou textu pro stav.

Budete také potřebovat účet úložiště Azure, kde nahrajete .txt dokumenty, které se použijí k trénování modelu pro extrakci entit.

Poznámka:

• K vytvoření prostředku jazyka musíte mít přiřazenou roli vlastníka ve skupině prostředků.
• Pokud připojíte existující účet úložiště, měli byste k němu mít přiřazenou roli vlastníka.

Vytvoření prostředku jazyka a připojení účtu úložiště

Prostředek můžete vytvořit následujícími způsoby:

• Azure Portal
• Language Studio
• PowerShell

Poznámka:

Účet úložiště byste neměli přesunout do jiné skupiny prostředků nebo předplatného, jakmile je propojený s prostředkem jazyka.

Vytvoření nového prostředku z webu Azure Portal

1. Přejděte na web Azure Portal a vytvořte nový prostředek jazyka Azure AI.

2. V zobrazeném okně vyberte tuto službu z vlastních funkcí. Vyberte Pokračovat a vytvořte prostředek v dolní části obrazovky.

   

3. Vytvořte prostředek jazyka s následujícími podrobnostmi.

   Název	Popis
   Předplatné	Vaše předplatné Azure.
   Skupina prostředků	Skupina prostředků, která bude obsahovat váš prostředek. Můžete použít existující nebo vytvořit nový.
   Oblast	Oblast vašeho prostředku Jazyk. Například "USA – západ 2".
   Název	Název vašeho prostředku
   Cenová úroveň	Cenová úroveň vašeho prostředku Jazyk. Službu můžete vyzkoušet pomocí úrovně Free (F0).

   Poznámka:

   Pokud se zobrazí zpráva"Váš přihlašovací účet není vlastníkem skupiny prostředků vybraného účtu úložiště", musí mít váš účet přiřazenou roli vlastníka pro skupinu prostředků, abyste mohli vytvořit prostředek jazyka. Požádejte o pomoc vlastníka předplatného Azure.

4. V části této služby vyberte existující účet úložiště nebo vyberte Nový účet úložiště. Tyto hodnoty vám pomůžou začít, a ne nutně hodnoty účtu úložiště, které budete chtít použít v produkčních prostředích. Abyste se vyhnuli latenci při sestavování projektu, připojte se k účtům úložiště ve stejné oblasti jako prostředek jazyka.

   Hodnota účtu úložiště	Doporučená hodnota
   Název účtu úložiště	Libovolný název
   Storage account type	Standardní LRS

5. Ujistěte se, že je zaškrtnuté příslušné oznámení O umělé inteligenci. V dolní části stránky vyberte Zkontrolovat a vytvořit a pak vyberte Vytvořit.

Vytvoření nového prostředku jazyka ze sady Language Studio

Pokud se poprvé přihlásíte, zobrazí se v sadě Language Studio okno, které vám umožní zvolit existující prostředek jazyka nebo vytvořit nový. Prostředek můžete vytvořit také tak, že kliknete na ikonu nastavení v pravém horním rohu a vyberete Prostředky a potom kliknete na Vytvořit nový prostředek.

Vytvořte prostředek jazyka s následujícími podrobnostmi.

Podrobnosti o instanci	Požadovaná hodnota
Předplatné Azure	Vaše předplatné Azure.
Skupina zdrojů Azure	Vaše skupina prostředků Azure
Název prostředku Azure	Název vašeho prostředku Azure
Umístění	Oblast
Cenová úroveň	Cenová úroveň vašeho prostředku Jazyk.

Důležité

• Při vytváření prostředku jazyka nezapomeňte povolit spravovanou identitu .
• Přečtěte si a potvrďte oznámení zodpovědné umělé inteligence.

Pokud chcete tuto službu použít, budete muset vytvořit účet úložiště Azure, pokud ho ještě nemáte.

Vytvoření nového prostředku jazyka pomocí PowerShellu

Nový prostředek a účet úložiště můžete vytvořit pomocí následující šablony rozhraní příkazového řádku a souborů parametrů, které jsou hostované na GitHubu.

V souboru parametrů upravte následující hodnoty:

Název parametru	Popis hodnoty
name	Název prostředku jazyka
location	Oblast, ve které je váš prostředek hostovaný.
sku	Cenová úroveň vašeho prostředku.
storageResourceName	Název účtu úložiště
storageLocation	Oblast, ve které je váš účet úložiště hostovaný.
storageSkuType	Skladová položka vašeho účtu úložiště.
storageResourceGroupName	Skupina prostředků vašeho účtu úložiště

Pomocí následujícího příkazu PowerShellu nasaďte šablonu Azure Resource Manageru (ARM) se soubory, které jste upravili.

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

Informace o nasazení šablon a souborů parametrů najdete v dokumentaci k šabloně ARM.

Poznámka:

• Proces připojení účtu úložiště k vašemu prostředku jazyka je nevratný, nejde ho později odpojit.
• Prostředek jazyka můžete připojit pouze k jednomu účtu úložiště.

Použití existujícího prostředku jazyka

Pomocí existujícího prostředku jazyka můžete začít s vlastním NER, pokud tento prostředek splňuje následující požadavky:

Požadavek	Popis
Oblasti	Ujistěte se, že je váš existující prostředek zřízený v jedné z podporovaných oblastí. Pokud ne, budete muset vytvořit nový prostředek v jedné z těchto oblastí.
Cenová úroveň	Cenová úroveň vašeho prostředku.
Spravovaná identita	Ujistěte se, že je povolené nastavení spravované identity prostředku. V opačném případě si přečtěte další část.

Pokud chcete použít vlastní analýzu textu pro stav, budete muset vytvořit účet úložiště Azure, pokud ho ještě nemáte.

Povolení správy identit pro prostředek

Azure Portal

Váš prostředek jazyka musí mít správu identit. Povolení pomocí webu Azure Portal:

1. Přechod na prostředek jazyka
2. V nabídce vlevo v části Správa prostředků vyberte Identita.
3. Na kartě Přiřazený systém nezapomeňte nastavit stav na Zapnuto.

Language Studio

Váš prostředek jazyka musí mít správu identit, aby ho bylo možné povolit v sadě Language Studio:

1. Výběr ikony nastavení v pravém horním rohu obrazovky
2. Vybrat prostředky
3. Zaškrtněte políčko Spravovaná identita prostředku Azure AI Language.

Povolení vlastní analýzy textu pro stav

Nezapomeňte povolit vlastní klasifikaci textu / Rozpoznávání vlastních pojmenovaných entit / Vlastní analýzu textu pro funkci stavu na webu Azure Portal.

1. Na webu Azure Portal přejděte ke svému prostředku jazyka.
2. V nabídce na levé straně v části Správa prostředků vyberte Funkce.
3. Povolení vlastní klasifikace textu / Rozpoznávání vlastních pojmenovaných entit / funkce Vlastní analýza textu
4. Připojení účtu úložiště
5. Výběr možnosti Použít

Důležité

• Ujistěte se, že váš prostředek jazyka má přiřazenou roli přispěvatele dat objektů blob úložiště v účtu úložiště, který se připojujete.

Přidání požadovaných rolí

Pomocí následujícího postupu nastavte požadované role pro váš prostředek jazyka a účet úložiště.

Role pro prostředek Azure AI Language

1. Na webu Azure Portal přejděte ke svému účtu úložiště nebo prostředku jazyka.

2. V levé navigační nabídce vyberte Řízení přístupu (IAM ).

3. Vyberte Přidat přiřazení rolí a zvolte odpovídající roli pro váš účet.

   K prostředku jazyka byste měli mít přiřazenou roli vlastníka nebo přispěvatele .

4. V části Přiřadit přístup vyberte Uživatele, skupinu nebo instanční objekt.

5. Vybrat členy

6. Vyberte své uživatelské jméno. V poli Vybrat můžete hledat uživatelská jména. Tento postup opakujte pro všechny role.

7. Tento postup opakujte pro všechny uživatelské účty, které potřebují přístup k tomuto prostředku.

Role pro váš účet úložiště

1. Na webu Azure Portal přejděte na stránku svého účtu úložiště.
2. V levé navigační nabídce vyberte Řízení přístupu (IAM ).
3. Vyberte Přidat přiřazení rolí a zvolte roli Přispěvatel dat objektů blob úložiště v účtu úložiště.
4. V rámci možnosti Přiřadit přístup vyberte spravovanou identitu.
5. Vybrat členy
6. Vyberte své předplatné a jako spravovanou identitu vyberte jazyk . V poli Vybrat můžete hledat uživatelská jména.

Důležité

Pokud máte virtuální síť nebo privátní koncový bod, nezapomeňte v seznamu důvěryhodných služeb vybrat možnost Povolit službám Azure přístup k tomuto účtu úložiště na webu Azure Portal.

Povolení CORS pro účet úložiště

Při povolování sdílení prostředků mezi zdroji (CORS) nezapomeňte povolit metody GET, PUT, DELETE. Nastavte povolené pole původu na https://language.cognitive.azure.comhodnotu . Povolit všechna záhlaví přidáním * do povolených hodnot záhlaví a nastavit maximální věk na 500.

Vytvoření vlastního Analýza textu pro projekt stavu

Po nakonfigurování vašeho prostředku a kontejneru úložiště vytvořte novou vlastní analýzu textu pro projekt stavu. Projekt je pracovní oblast pro vytváření vlastních modelů AI na základě vašich dat. K vašemu projektu může přistupovat jenom vy a ostatní, kteří mají přístup k používanému prostředku Azure. Pokud máte označená data, můžete je použít k zahájení importu projektu.

Language Studio

1. Přihlaste se k sadě Language Studio. Zobrazí se okno, ve které můžete vybrat předplatné a prostředek jazyka. Vyberte prostředek jazyka, který jste vytvořili v předchozím kroku.

2. V části Extrahovat informace v sadě Language Studio vyberte Vlastní Analýza textu pro stav.

3. V horní nabídce na stránce projektů vyberte Vytvořit nový projekt . Vytvoření projektu umožňuje označit data, trénovat, vyhodnocovat, vylepšovat a nasazovat modely.

   

4. Zadejte informace o projektu, včetně názvu, popisu a jazyka souborů v projektu. Pokud používáte ukázkovou datovou sadu, vyberte angličtinu. Později nemůžete změnit název projektu. Vyberte Další.

   Tip

   Vaše datová sada nemusí být úplně ve stejném jazyce. Můžete mít více dokumentů, z nichž každý má různé podporované jazyky. Pokud vaše datová sada obsahuje dokumenty různých jazyků nebo pokud očekáváte text z různých jazyků během běhu, vyberte možnost povolit vícejazyčnou datovou sadu , když zadáte základní informace o projektu. Tuto možnost můžete povolit později na stránce Nastavení projektu.

5. Po výběru možnosti Vytvořit nový projekt se zobrazí okno, které vám umožní připojit účet úložiště. Pokud jste už připojili účet úložiště, zobrazí se účet úložiště připojený. Pokud ne, zvolte účet úložiště v rozevíracím seznamu, který se zobrazí, a vyberte Připojení účet úložiště. Tím se nastaví požadované role pro váš účet úložiště. Tento krok pravděpodobně vrátí chybu, pokud nejste v účtu úložiště přiřazeni jako vlastník .

   Poznámka:

   • Tento krok stačí provést jenom jednou pro každý nový prostředek, který používáte.
   • Tento proces je nevratný, pokud k prostředku jazyka připojíte účet úložiště, nemůžete ho později odpojit.
   • Prostředek jazyka můžete připojit pouze k jednomu účtu úložiště.

   

6. Vyberte kontejner, do kterého jste datovou sadu nahráli.

7. Pokud jste už označili data, ujistěte se, že se řídí podporovaným formátem, a vyberte Ano, soubory jsou už označené a mám formátovaný soubor popisků JSON a v rozevírací nabídce vyberte soubor štítků. Vyberte Další. Pokud datovou sadu používáte z rychlého startu, nemusíte si prohlédnout formátování souboru s popisky JSON.

8. Zkontrolujte zadaná data a vyberte Vytvořit projekt.

Rozhraní REST API

Pokud chcete začít vytvářet vlastní Analýza textu pro model stavu, musíte vytvořit projekt. Vytvoření projektu vám umožní označovat data, trénovat, vyhodnocovat, vylepšovat a nasazovat modely.

Poznámka:

V názvu projektu se rozlišují malá a velká písmena pro všechny operace.

K vytvoření projektu vytvořte požadavek PATCH pomocí následující adresy URL, hlaviček a textu JSON.

Adresa URL požadavku

K vytvoření projektu použijte následující adresu URL. Nahraďte níže uvedené zástupné hodnoty vlastními hodnotami.

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

Zástupný symbol	Hodnota	Příklad
{ENDPOINT}	Koncový bod pro ověření požadavku rozhraní API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Název projektu. U této hodnoty se rozlišují malá a velká písmena.	myProject
{API-VERSION}	Verze rozhraní API, které voláte. Hodnota, na kterou se zde odkazuje, je určená pro nejnovější vydané verze. Další informace o dalších dostupných verzích rozhraní API najdete v tématu Životní cyklus modelu.	2022-05-01

Hlavičky

K ověření požadavku použijte následující hlavičku.

Key	Hodnota
Ocp-Apim-Subscription-Key	Klíč k vašemu prostředku. Používá se k ověřování požadavků rozhraní API.

Text

V požadavku použijte následující kód JSON. Nahraďte níže uvedené zástupné hodnoty vlastními hodnotami.

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

Klíč	Zástupný symbol	Hodnota	Příklad
projectName	{PROJECT-NAME}	Název projektu. U této hodnoty se rozlišují malá a velká písmena.	myProject
jazyk	{LANGUAGE-CODE}	Řetězec určující kód jazyka pro dokumenty použité v projektu. Pokud je projekt vícejazyčný, zvolte kód jazyka většiny dokumentů. Další informace o podporovaných kódech jazyků najdete v podpoře jazyků.	en-us
projectKind	CustomHealthcare	Váš projekt je laskavý.	CustomHealthcare
Vícejazyčné	true	Logická hodnota, která umožňuje mít v datové sadě dokumenty ve více jazycích a při nasazení modelu se můžete dotazovat na model v libovolném podporovaném jazyce (nemusí být nutně součástí trénovacích dokumentů). Další informace o podpoře více jazyků najdete v podpoře jazyků.	true
storageInputContainerName	{CONTAINER-NAME	Název kontejneru úložiště Azure, do kterého jste dokumenty nahráli.	myContainer

Tento požadavek vrátí odpověď 201, což znamená, že se projekt vytvoří.

Tento požadavek vrátí chybu, pokud:

• Vybraný prostředek nemá pro účet úložiště správná oprávnění.

Import projektu

Pokud jste už data označili jako označená, můžete je použít k zahájení práce se službou. Ujistěte se, že vaše označená data se řídí přijatými formáty dat.

Language Studio

1. Přihlaste se k sadě Language Studio. Zobrazí se okno, ve které můžete vybrat předplatné a prostředek jazyka. Vyberte prostředek jazyka.

2. V části Extrahovat informace v sadě Language Studio vyberte vlastní analýzu textu pro stav.

3. V horní nabídce na stránce projektů vyberte Vytvořit nový projekt . Vytvoření projektu vám umožní označit data, trénovat, vyhodnocovat, vylepšovat a nasazovat modely.

4. Po výběru možnosti Vytvořit nový projekt se zobrazí obrazovka, která vám umožní připojit účet úložiště. Pokud nemůžete najít účet úložiště, ujistěte se, že jste vytvořili prostředek pomocí doporučených kroků. Pokud jste už připojili účet úložiště k vašemu prostředku jazyka, uvidíte připojený účet úložiště.

   Poznámka:

   • Tento krok stačí provést jenom jednou pro každý nový prostředek jazyka, který používáte.
   • Tento proces je nevratný, pokud k prostředku jazyka připojíte účet úložiště, nemůžete ho později odpojit.
   • Prostředek jazyka můžete připojit pouze k jednomu účtu úložiště.

   

5. Zadejte informace o projektu, včetně názvu, popisu a jazyka souborů v projektu. Později nebudete moct změnit název projektu. Vyberte Další.

   Tip

   Vaše datová sada nemusí být úplně ve stejném jazyce. Můžete mít více dokumentů, z nichž každý má různé podporované jazyky. Pokud vaše datová sada obsahuje dokumenty různých jazyků nebo pokud očekáváte text z různých jazyků během běhu, vyberte možnost povolit vícejazyčnou datovou sadu , když zadáte základní informace o projektu. Tuto možnost můžete povolit později na stránce Nastavení projektu.

6. Vyberte kontejner, do kterého jste datovou sadu nahráli.

7. Vyberte Ano, moje soubory jsou už označené a mám formátovaný soubor popisků JSON a v rozevírací nabídce níže vyberte soubor popisků a naimportujte soubor popisků JSON. Ujistěte se, že se řídí podporovaným formátem.

8. Vyberte Další.

9. Zkontrolujte zadaná data a vyberte Vytvořit projekt.

Rozhraní REST API

Odešlete požadavek POST pomocí následující adresy URL, hlaviček a textu JSON pro import souboru štítků. Ujistěte se, že soubor štítků dodržuje akceptované formátování.

Pokud projekt se stejným názvem již existuje, nahradí se data tohoto projektu.

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

Zástupný symbol	Hodnota	Příklad
{ENDPOINT}	Koncový bod pro ověření požadavku rozhraní API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Název projektu. U této hodnoty se rozlišují malá a velká písmena.	myProject
{API-VERSION}	Verze rozhraní API, které voláte. Hodnota, na kterou se zde odkazuje, je určená pro nejnovější vydané verze. Další informace o dalších dostupných verzích rozhraní API najdete v tématu Životní cyklus modelu.	2022-05-01

Hlavičky

K ověření požadavku použijte následující hlavičku.

Key	Hodnota
Ocp-Apim-Subscription-Key	Klíč k vašemu prostředku. Používá se k ověřování požadavků rozhraní API.

Text

V požadavku použijte následující kód JSON. Nahraďte níže uvedené zástupné hodnoty vlastními hodnotami.

{
	"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
							}
						]
					}
				]
			}
		]
	}
}

Klíč	Zástupný symbol	Hodnota	Příklad
multilingual	true	Logická hodnota, která umožňuje mít v datové sadě dokumenty ve více jazycích a při nasazení modelu můžete dotazovat model v libovolném podporovaném jazyce (nemusí nutně být součástí trénovacích dokumentů). Další informace o podpoře více jazyků najdete v podpoře jazyků.	true
projectName	{PROJECT-NAME}	Název projektu	myproject
storageInputContainerName	{CONTAINER-NAME}	Název kontejneru	mycontainer
entities		Pole obsahující všechny typy entit, které máte v projektu. Jedná se o typy entit, které se z dokumentů extrahují.
category		Název typu entity, který lze definovat pro nové definice entit nebo předdefinovaný pro předem připravené entity.
compositionSetting	{COMPOSITION-SETTING}	Pravidlo, které definuje, jak spravovat více komponent ve vaší entitě. Možnosti jsou combineComponents nebo separateComponents.	combineComponents
list		Pole obsahující všechny dílčí seznamy, které máte v projektu pro konkrétní entitu. Seznamy lze přidat do předem připravených entit nebo nových entit s naučenými komponentami.
sublists	[]	Pole obsahující dílčí seznamy. Každý dílčí seznam je klíč a jeho přidružené hodnoty.	[]
listKey	One	Normalizovaná hodnota pro seznam synonym, která se mají namapovat zpět do predikce.	One
synonyms	[]	Pole obsahující všechna synonyma	Synonymum
language	{LANGUAGE-CODE}	Řetězec určující kód jazyka pro synonymum v podsestavě. Pokud je projekt vícejazyčný a chcete podporovat seznam synonym pro všechny jazyky v projektu, musíte do každého jazyka explicitně přidat synonyma. Další informace o podporovaných kódech jazyka najdete v části Podpora jazyků.	en
values	"EntityNumberone", "FirstEntity"	Seznam řetězců oddělených čárkami, které budou přesně odpovídat extrakci a mapování na klíč seznamu.	"EntityNumberone", "FirstEntity"
prebuilts	MedicationName	Název předem připravené komponenty naplňující předem připravenou entitu. Předem připravené entity se ve výchozím nastavení automaticky načtou do projektu, ale v souboru popisků je můžete rozšířit o komponenty seznamu.	MedicationName
documents		Pole obsahující všechny dokumenty v projektu a seznam entit označených v rámci každého dokumentu	[]
location	{DOCUMENT-NAME}	Umístění dokumentů v kontejneru úložiště. Vzhledem k tomu, že všechny dokumenty jsou v kořenovém adresáři kontejneru, měl by to být název dokumentu.	doc1.txt
dataset	{DATASET}	Testovací sada , na kterou tento soubor přejde při rozdělení před trénováním. Možné hodnoty pro toto pole jsou Train a Test.	Train
regionOffset		Inkluzivní pozice znaku začátku textu.	0
regionLength		Délka ohraničujícího rámečku z hlediska znaků UTF16. Trénování bere v úvahu pouze data v této oblasti.	500
category		Typ entity přidružené k rozsahu zadaného textu.	Entity1
offset		Počáteční pozice textu entity.	25
length		Délka entity z hlediska znaků UTF16.	20
language	{LANGUAGE-CODE}	Řetězec určující kód jazyka pro dokument použitý v projektu. Pokud je projekt vícejazyčný, zvolte kód jazyka většiny dokumentů. Další informace o podporovaných kódech jazyka najdete v části Podpora jazyků.	en

Po odeslání požadavku rozhraní API obdržíte 202 odpověď, která značí, že úloha byla odeslána správně. V hlavičce odpovědi extrahujte operation-location hodnotu. Bude formátován takto:

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

{JOB-ID} slouží k identifikaci vašeho požadavku, protože tato operace je asynchronní. Tuto adresu URL použijete k získání stavu úlohy importu.

Možné chybové scénáře pro tento požadavek:

• Vybraný prostředek nemá správná oprávnění pro účet úložiště.
• Zadaná storageInputContainerName hodnota neexistuje.
• Použije se neplatný kód jazyka nebo pokud typ kódu jazyka není řetězec.
• multilingual hodnota je řetězec, nikoli logická hodnota.

Získání podrobností o projektu

Language Studio

1. V sadě Language Studio přejděte na stránku nastavení projektu.

2. Zobrazí se podrobnosti o projektu.

3. Na této stránce můžete aktualizovat popis projektu a povolit nebo zakázat vícejazyčnou datovou sadu v nastavení projektu.

4. Můžete si také prohlédnout připojený účet úložiště a kontejner s prostředkem jazyka.

5. Primární klíč prostředku můžete načíst také z této stránky.

   

Rozhraní REST API

K získání podrobností o projektu použijte následující požadavek GET . Nahraďte níže uvedené zástupné hodnoty vlastními hodnotami.

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

Zástupný symbol	Hodnota	Příklad
{ENDPOINT}	Koncový bod pro ověření požadavku rozhraní API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Název projektu. U této hodnoty se rozlišují malá a velká písmena.	myProject
{API-VERSION}	Verze rozhraní API, které voláte. Další informace o dalších dostupných verzích rozhraní API najdete v tématu Životní cyklus modelu.	2022-05-01

Hlavičky

K ověření požadavku použijte následující hlavičku.

Key	Hodnota
Ocp-Apim-Subscription-Key	Klíč k vašemu prostředku. Používá se k ověřování požadavků rozhraní API.

Text odpovědi

    {
        "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}"
    }

Hodnota	Zástupný symbol	Popis	Příklad
projectKind	CustomHealthcare	Váš projekt je laskavý.	CustomHealthcare
storageInputContainerName	{CONTAINER-NAME}	Název kontejneru úložiště Azure, do kterého jste dokumenty nahráli.	myContainer
projectName	{PROJECT-NAME}	Název projektu. U této hodnoty se rozlišují malá a velká písmena.	myProject
multilingual	true	Logická hodnota, která umožňuje mít v datové sadě dokumenty ve více jazycích a při nasazení modelu se můžete dotazovat na model v libovolném podporovaném jazyce (nemusí být nutně součástí trénovacích dokumentů). Další informace o podpoře více jazyků najdete v tématu Podpora jazyků.	true
language	{LANGUAGE-CODE}	Řetězec určující kód jazyka pro dokumenty použité v projektu. Pokud je projekt vícejazyčný, zvolte kód jazyka většiny dokumentů.	en

Po odeslání požadavku rozhraní API obdržíte 200 odpověď s informacemi o úspěchu a textu odpovědi JSON s podrobnostmi o projektu.

Odstranit projekt

Language Studio

Pokud už projekt nepotřebujete, můžete projekt odstranit pomocí sady Language Studio.

1. V horní části stránky vyberte funkci Služby jazyka, kterou používáte.
2. Vyberte projekt, který chcete odstranit.
3. V horní nabídce vyberte Odstranění.

Rozhraní REST API

Pokud už projekt nepotřebujete, můžete ho odstranit pomocí následujícího požadavku DELETE . Zástupné hodnoty nahraďte vlastními hodnotami.

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

Zástupný symbol	Hodnota	Příklad
{ENDPOINT}	Koncový bod pro ověření požadavku rozhraní API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Název projektu. U této hodnoty se rozlišují malá a velká písmena.	myProject
{API-VERSION}	Verze rozhraní API, které voláte. Hodnota, na kterou se zde odkazuje, je určená pro nejnovější vydané verze. Další informace o dalších dostupných verzích rozhraní API najdete v tématu Životní cyklus modelu.	2022-05-01

Hlavičky

K ověření požadavku použijte následující hlavičku.

Key	Hodnota
Ocp-Apim-Subscription-Key	Klíč k vašemu prostředku. Používá se k ověřování požadavků rozhraní API.

Po odeslání požadavku rozhraní API obdržíte 202 odpověď s informací o úspěchu, což znamená, že projekt byl odstraněn. Úspěšné výsledky volání s hlavičkou Operation-Location použitou ke kontrole stavu úlohy.

Další kroky

• Měli byste mít představu o schématu projektu, které použijete k označení dat.

• Po definování schématu můžete začít popisovat data, která se použijí pro trénování, vyhodnocení modelu a nakonec vytváření předpovědí.