Aangepaste Text Analytics maken voor statusproject

Gebruik dit artikel voor meer informatie over het instellen van de vereisten voor het starten met aangepaste tekstanalyse voor status en het maken van een project.

Vereisten

Voordat u aangepaste tekstanalyse gaat gebruiken voor de status, hebt u het volgende nodig:

• Een Azure-abonnement: maak er gratis een.

Een taalresource maken

Voordat u aangepaste tekstanalyse gaat gebruiken voor de status, hebt u een Azure AI Language-resource nodig. Het is raadzaam om uw taalresource te maken en er een opslagaccount aan te koppelen in Azure Portal. Als u een resource maakt in Azure Portal, kunt u tegelijkertijd een Azure-opslagaccount maken, waarbij alle vereiste machtigingen vooraf zijn geconfigureerd. U kunt ook verder lezen in het artikel voor meer informatie over het gebruik van een bestaande resource en het configureren van deze resource om te werken met aangepaste tekstanalyses voor de status.

U hebt ook een Azure-opslagaccount nodig waarin u uw .txt documenten uploadt die worden gebruikt om een model te trainen om entiteiten te extraheren.

Notitie

• U moet een eigenaarsrol hebben toegewezen aan de resourcegroep om een taalresource te maken.
• Als u een bestaand opslagaccount verbindt, moet er een eigenaarsrol aan het account zijn toegewezen.

Taalresource maken en opslagaccount verbinden

U kunt op de volgende manieren een resource maken:

• Azure Portal
• Language Studio
• Powershell

Notitie

U moet het opslagaccount niet verplaatsen naar een andere resourcegroep of een ander abonnement nadat het is gekoppeld aan de taalresource.

Een nieuwe resource maken vanuit Azure Portal

1. Ga naar Azure Portal om een nieuwe Azure AI-taalresource te maken.

2. Selecteer deze service in het venster dat wordt weergegeven in de aangepaste functies. Selecteer Doorgaan om uw resource onder aan het scherm te maken.

   

3. Maak een taalresource met de volgende details.

   Name	Beschrijving
   Abonnement	Uw Azure-abonnement.
   Resourcegroep	Een resourcegroep die uw resource bevat. U kunt een bestaande gebruiken of een nieuwe maken.
   Regio	De regio voor uw taalresource. Bijvoorbeeld 'VS - west 2'.
   Naam	Een naam voor uw resource.
   Prijscategorie	De prijscategorie voor uw taalresource. U kunt de gratis laag (F0) gebruiken om de service uit te proberen.

   Notitie

   Als u een bericht krijgt met de tekst 'uw aanmeldingsaccount is geen eigenaar van de resourcegroep van het geselecteerde opslagaccount', moet voor uw account een eigenaarsrol zijn toegewezen aan de resourcegroep voordat u een taalresource kunt maken. Neem contact op met de eigenaar van uw Azure-abonnement voor hulp.

4. Selecteer in de sectie van deze service een bestaand opslagaccount of selecteer Nieuw opslagaccount. Deze waarden zijn om u te helpen aan de slag te gaan en niet noodzakelijkerwijs de waarden van het opslagaccount die u wilt gebruiken in productieomgevingen. Om latentie te voorkomen tijdens het bouwen van uw project, maakt u verbinding met opslagaccounts in dezelfde regio als uw taalresource.

   Waarde van opslagaccount	Aanbevolen waarde
   Naam van het opslagaccount	Elke naam
   Storage account type	Standaard - LRS

5. Zorg ervoor dat de verantwoordelijke AI-kennisgeving is ingeschakeld. Selecteer Beoordelen en maken onder aan de pagina en selecteer Vervolgens Maken.

Een nieuwe taalresource maken vanuit Language Studio

Als u zich voor het eerst aanmeldt, ziet u een venster in Language Studio waarmee u een bestaande taalresource kunt kiezen of een nieuwe kunt maken. U kunt ook een resource maken door op het instellingenpictogram in de rechterbovenhoek te klikken, Resources te selecteren en vervolgens op Een nieuwe resource maken te klikken.

Maak een taalresource met de volgende details.

Instantiedetails	Vereiste waarde
Azure-abonnement	Uw Azure-abonnement
Azure-resourcegroep	Uw Azure-resourcegroep
Azure-resourcenaam	De naam van uw Azure-resource
Locatie	De regio
Prijscategorie	De prijscategorie van uw taalresource.

Belangrijk

• Zorg ervoor dat u Beheerde identiteit inschakelt wanneer u een taalresource maakt.
• Verantwoordelijke AI-kennisgeving lezen en bevestigen

Als u deze service wilt gebruiken, moet u een Azure-opslagaccount maken als u er nog geen hebt.

Een nieuwe taalresource maken met Behulp van PowerShell

U kunt een nieuwe resource en een opslagaccount maken met behulp van de volgende CLI-sjabloon- en parameterbestanden die worden gehost op GitHub.

Bewerk de volgende waarden in het parameterbestand:

Parameternaam	Beschrijving van waarde
name	Naam van uw taalresource
location	Regio waarin uw resource wordt gehost.
sku	De prijscategorie van uw resource.
storageResourceName	Naam van uw opslagaccount
storageLocation	Regio waarin uw opslagaccount wordt gehost.
storageSkuType	SKU van uw opslagaccount.
storageResourceGroupName	Resourcegroep van uw opslagaccount

Gebruik de volgende PowerShell-opdracht om de ARM-sjabloon (Azure Resource Manager) te implementeren met de bestanden die u hebt bewerkt.

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

Zie de documentatie voor ARM-sjablonen voor informatie over het implementeren van sjablonen en parameterbestanden.

Notitie

• Het proces voor het verbinden van een opslagaccount met uw taalresource kan niet ongedaan worden gemaakt. De verbinding kan later niet meer worden verbroken.
• U kunt uw taalresource alleen verbinden met één opslagaccount.

Een bestaande taalresource gebruiken

U kunt een bestaande taalresource gebruiken om aan de slag te gaan met aangepaste NER zolang deze resource voldoet aan de onderstaande vereisten:

Vereiste	Beschrijving
Regio's	Zorg ervoor dat uw bestaande resource is ingericht in een van de ondersteunde regio's. Zo niet, dan moet u een nieuwe resource maken in een van deze regio's.
Prijscategorie	De prijscategorie voor de resource.
Beheerde identiteit	Zorg ervoor dat de beheerde identiteitinstelling van de resource is ingeschakeld. Lees anders de volgende sectie.

Als u aangepaste tekstanalyse wilt gebruiken voor de status, moet u een Azure-opslagaccount maken als u er nog geen hebt.

Identiteitsbeheer inschakelen voor uw resource

Azure-portal

Uw taalresource moet identiteitsbeheer hebben. Ga als volgende te werk om deze in te schakelen met behulp van Azure Portal:

1. Ga naar uw taalresource
2. Selecteer Identiteit in het linkermenu onder de sectie Resourcebeheer
3. Ga naar het tabblad Systeem toegewezen en zorg ervoor dat u Status instelt op Aan

Language Studio

Uw taalresource moet identiteitsbeheer hebben om deze in te schakelen met Behulp van Language Studio:

1. Selecteer het instellingenpictogram in de rechterbovenhoek van het scherm
2. Resources selecteren
3. Schakel het selectievakje Beheerde identiteit in voor uw Azure AI Language-resource.

Aangepaste tekstanalyse inschakelen voor status

Zorg ervoor dat u aangepaste tekstclassificatie/Aangepaste entiteitsherkenning/Aangepaste tekstanalyse inschakelt voor de statusfunctie vanuit de Azure-portal.

1. Ga naar uw taalresource in Azure Portal.
2. Selecteer Functies in het menu aan de linkerkant onder De sectie Resourcebeheer
3. De functie Aangepaste tekstclassificatie /Aangepaste entiteitsherkenning met benoemde namen/aangepaste tekstanalysefunctie inschakelen
4. Verbinding maken uw opslagaccount
5. Selecteer toepassen

Belangrijk

• Zorg ervoor dat voor uw taalresourcede rol opslagblobgegevensbijdrager is toegewezen aan het opslagaccount waarmee u verbinding maakt.

Vereiste rollen toevoegen

Gebruik de volgende stappen om de vereiste rollen in te stellen voor uw taalresource en opslagaccount.

Rollen voor uw Azure AI-taalresource

1. Ga naar uw opslagaccount of taalresource in Azure Portal.

2. Selecteer Toegangsbeheer (IAM) in het linkernavigatiemenu.

3. Selecteer Toevoegen om roltoewijzingen toe te voegen en kies de juiste rol voor uw account.

   U moet de rol van eigenaar of inzender hebben toegewezen aan uw taalresource.

4. Binnen Toegang toewijzen aan, selecteert u Gebruiker, groep of service-principal

5. Selecteer Leden selecteren

6. Selecteer uw gebruikersnaam. U kunt zoeken naar gebruikersnamen in het veld Selecteren . Herhaal dit voor alle rollen.

7. Herhaal deze stappen voor alle gebruikersaccounts die toegang nodig hebben tot deze resource.

Rollen voor uw opslagaccount

1. Ga naar de pagina van uw opslagaccount in Azure Portal.
2. Selecteer Toegangsbeheer (IAM) in het linkernavigatiemenu.
3. Selecteer Toevoegen om roltoewijzingen toe te voegen en kies de rol Inzender voor opslagblobgegevens in het opslagaccount.
4. Selecteer beheerde identiteit binnen Toegang toewijzen tot.
5. Selecteer Leden selecteren
6. Selecteer uw abonnement en Taal als de beheerde identiteit. U kunt zoeken naar gebruikersnamen in het veld Selecteren .

Belangrijk

Als u een virtueel netwerk of privé-eindpunt hebt, selecteert u Toestaan dat Azure-services in de lijst met vertrouwde services toegang hebben tot dit opslagaccount in Azure Portal.

CORS inschakelen voor uw opslagaccount

Zorg ervoor dat u methoden (GET, PUT, DELETE) toestaat wanneer u CORS (Cross-Origin Resource Sharing) inschakelt. Stel het veld Toegestane oorsprong in op https://language.cognitive.azure.com. Alle headers toestaan door toe te voegen * aan de toegestane headerwaarden en de maximale leeftijd in te stellen op 500.

Een aangepast Text Analytics-project voor statusproject maken

Zodra uw resource en opslagcontainer zijn geconfigureerd, maakt u een nieuwe aangepaste tekstanalyse voor het statusproject. Een project is een werkgebied voor het bouwen van uw aangepaste AI-modellen op basis van uw gegevens. Uw project kan alleen worden geopend door u en anderen die toegang hebben tot de Azure-resource die wordt gebruikt. Als u gelabelde gegevens hebt, kunt u deze gebruiken om aan de slag te gaan door een project te importeren.

Language Studio

1. Meld u aan bij Language Studio. Er wordt een venster weergegeven waarmee u uw abonnement en taalresource kunt selecteren. Selecteer de taalresource die u in de bovenstaande stap hebt gemaakt.

2. Selecteer in de sectie Informatie extraheren van Language Studio de optie Custom Text Analytics voor de status.

3. Selecteer Nieuw project maken in het bovenste menu op de pagina Projecten. Door een project te maken, kunt u gegevens labelen, trainen, evalueren, verbeteren en implementeren.

   

4. Voer de projectgegevens in, inclusief een naam, beschrijving en de taal van de bestanden in uw project. Als u de voorbeeldgegevensset gebruikt, selecteert u Engels. U kunt de naam van uw project later niet meer wijzigen. Selecteer Volgende

   Tip

   Uw gegevensset hoeft zich niet volledig in dezelfde taal te bevinden. U kunt meerdere documenten hebben, elk met verschillende ondersteunde talen. Als uw gegevensset documenten van verschillende talen bevat of als u tijdens runtime tekst uit verschillende talen verwacht, schakelt u de optie voor meertalige gegevenssets in wanneer u de basisgegevens voor uw project invoert. Deze optie kan later worden ingeschakeld op de pagina Project-instellingen .

5. Nadat u Nieuw project maken hebt geselecteerd, wordt er een venster weergegeven waarmee u verbinding kunt maken met uw opslagaccount. Als u al een opslagaccount hebt verbonden, ziet u dat de opslagaccount is verbonden. Als dat niet het is, kiest u uw opslagaccount in de vervolgkeuzelijst die wordt weergegeven en selecteert u Verbinding maken opslagaccount. Hiermee worden de vereiste rollen voor uw opslagaccount ingesteld. Met deze stap wordt mogelijk een fout geretourneerd als u niet als eigenaar van het opslagaccount bent toegewezen.

   Notitie

   • U hoeft deze stap slechts één keer uit te voeren voor elke nieuwe resource die u gebruikt.
   • Dit proces kan niet ongedaan worden gemaakt als u een opslagaccount verbindt met uw taalresource, kunt u het later niet loskoppelen.
   • U kunt uw taalresource alleen verbinden met één opslagaccount.

   

6. Selecteer de container waar u uw gegevensset hebt geüpload.

7. Als u al gelabelde gegevens hebt, moet u ervoor zorgen dat deze de ondersteunde indeling volgt en Ja selecteert , zijn mijn bestanden al gelabeld en heb ik het JSON-labelsbestand opgemaakt en selecteer het labelbestand in de vervolgkeuzelijst. Selecteer Volgende. Als u de gegevensset uit de quickstart gebruikt, hoeft u de opmaak van het JSON-labelsbestand niet te controleren.

8. Controleer de gegevens die u hebt ingevoerd en selecteer Project maken.

REST-API's

Als u een aangepast Text Analytics voor het statusmodel wilt maken, moet u een project maken. Door een project te maken kunt u gegevens labelen, trainen, evalueren, verbeteren en implementeren.

Notitie

De projectnaam is hoofdlettergevoelig voor alle bewerkingen.

Maak een PATCH-aanvraag met behulp van de volgende URL, headers en JSON-hoofdtekst om uw project te maken.

Aanvraag-URL

Gebruik de volgende URL om een project te maken. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.

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

Tijdelijke aanduiding	Weergegeven als	Opmerking
{ENDPOINT}	Het eindpunt voor het verifiëren van uw API-aanvraag.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	De naam voor uw project. Deze waarde is hoofdlettergevoelig.	myProject
{API-VERSION}	De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is voor de nieuwste versie die is uitgebracht. Zie de levenscyclus van het model voor meer informatie over andere beschikbare API-versies.	2022-05-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel	Weergegeven als
Ocp-Apim-Subscription-Key	De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Hoofdtekst

Gebruik de volgende JSON in uw aanvraag. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.

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

Sleutel	Tijdelijke aanduiding	Weergegeven als	Opmerking
projectNaam	{PROJECT-NAME}	De naam van uw project. Deze waarde is hoofdlettergevoelig.	myProject
language	{LANGUAGE-CODE}	Een tekenreeks die de taalcode opgeeft voor de documenten die in uw project worden gebruikt. Als uw project een meertalige project is, kiest u de taalcode van het merendeel van de documenten. Zie taalondersteuning voor meer informatie over ondersteunde taalcodes.	en-us
projectKind	CustomHealthcare	Uw projecttype.	CustomHealthcare
Meertalige	true	Een Booleaanse waarde waarmee u documenten in meerdere talen in uw gegevensset kunt hebben en wanneer uw model wordt geïmplementeerd, kunt u een query uitvoeren op het model in elke ondersteunde taal (niet noodzakelijkerwijs documenten die zijn opgenomen in uw trainingsdocumenten). Zie taalondersteuning voor meer informatie over meertalige ondersteuning.	true
storageInputContainerName	{CONTAINER-NAME	De naam van uw Azure Storage-container waar u uw documenten hebt geüpload.	myContainer

Deze aanvraag retourneert een 201-antwoord, wat betekent dat het project wordt gemaakt.

Deze aanvraag retourneert een fout als:

• De geselecteerde resource beschikt niet over de juiste machtigingen voor het opslagaccount.

Project importeren

Als u al gelabelde gegevens hebt, kunt u deze gebruiken om aan de slag te gaan met de service. Zorg ervoor dat uw gelabelde gegevens de geaccepteerde gegevensindelingen volgen.

Language Studio

1. Meld u aan bij Language Studio. Er wordt een venster weergegeven waarmee u uw abonnement en taalresource kunt selecteren. Selecteer uw taalresource.

2. Selecteer in de sectie Informatie extraheren van Language Studio de optie Aangepaste tekstanalyse voor de status.

3. Selecteer Nieuw project maken in het bovenste menu op de pagina Projecten. Als u een project maakt, kunt u gegevens taggen, trainen, evalueren, verbeteren en implementeren.

4. Nadat u Nieuw project maken hebt geselecteerd, wordt er een scherm weergegeven waarmee u verbinding kunt maken met uw opslagaccount. Als u uw opslagaccount niet kunt vinden, controleert u of u een resource hebt gemaakt met behulp van de aanbevolen stappen. Als u al een opslagaccount hebt verbonden met uw taalresource, ziet u dat uw opslagaccount is verbonden.

   Notitie

   • U hoeft deze stap slechts één keer uit te voeren voor elke nieuwe taalresource die u gebruikt.
   • Dit proces kan niet ongedaan worden gemaakt als u een opslagaccount verbindt met uw taalresource, kunt u het later niet loskoppelen.
   • U kunt uw taalresource alleen verbinden met één opslagaccount.

   

5. Voer de projectgegevens in, inclusief een naam, beschrijving en de taal van de bestanden in uw project. U kunt de naam van uw project later niet meer wijzigen. Selecteer Volgende.

   Tip

   Uw gegevensset hoeft zich niet volledig in dezelfde taal te bevinden. U kunt meerdere documenten hebben, elk met verschillende ondersteunde talen. Als uw gegevensset documenten van verschillende talen bevat of als u tijdens runtime tekst uit verschillende talen verwacht, schakelt u de optie voor meertalige gegevenssets in wanneer u de basisgegevens voor uw project invoert. Deze optie kan later worden ingeschakeld op de pagina Project-instellingen .

6. Selecteer de container waar u uw gegevensset hebt geüpload.

7. Selecteer Ja, mijn bestanden zijn al gelabeld en ik heb het JSON-labelsbestand opgemaakt en selecteer het labelbestand in de vervolgkeuzelijst hieronder om het JSON-labelbestand te importeren. Zorg ervoor dat deze de ondersteunde indeling volgt.

8. Selecteer Volgende.

9. Controleer de gegevens die u hebt ingevoerd en selecteer Project maken.

REST-API's

Verzend een POST-aanvraag met behulp van de volgende URL, headers en JSON-hoofdtekst om het labelbestand te importeren. Zorg ervoor dat het labelsbestand de geaccepteerde indeling volgt.

Als er al een project met dezelfde naam bestaat, worden de gegevens van dat project vervangen.

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

Tijdelijke aanduiding	Weergegeven als	Opmerking
{ENDPOINT}	Het eindpunt voor het verifiëren van uw API-aanvraag.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	De naam voor uw project. Deze waarde is hoofdlettergevoelig.	myProject
{API-VERSION}	De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is voor de nieuwste versie die is uitgebracht. Zie de levenscyclus van het model voor meer informatie over andere beschikbare API-versies.	2022-05-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel	Weergegeven als
Ocp-Apim-Subscription-Key	De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Hoofdtekst

Gebruik de volgende JSON in uw aanvraag. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.

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

Sleutel	Tijdelijke aanduiding	Weergegeven als	Opmerking
multilingual	true	Een Booleaanse waarde waarmee u documenten in meerdere talen in uw gegevensset kunt hebben en wanneer uw model wordt geïmplementeerd, kunt u een query uitvoeren op het model in elke ondersteunde taal (niet noodzakelijkerwijs opgenomen in uw trainingsdocumenten). Zie taalondersteuning voor meer informatie over meertalige ondersteuning.	true
projectName	{PROJECT-NAME}	Projectnaam	myproject
storageInputContainerName	{CONTAINER-NAME}	Containernaam	mycontainer
entities		Matrix met alle entiteitstypen die u in het project hebt. Dit zijn de entiteitstypen die uit uw documenten worden geëxtraheerd.
category		De naam van het entiteitstype, dat door de gebruiker kan worden gedefinieerd voor nieuwe entiteitsdefinities of vooraf gedefinieerd voor vooraf gedefinieerde entiteiten.
compositionSetting	{COMPOSITION-SETTING}	Regel waarmee wordt gedefinieerd hoe u meerdere onderdelen in uw entiteit beheert. Opties zijn combineComponents of separateComponents.	combineComponents
list		Matrix met alle sublijsten die u in het project voor een specifieke entiteit hebt. Lijsten kunnen worden toegevoegd aan vooraf gedefinieerde entiteiten of nieuwe entiteiten met geleerde onderdelen.
sublists	[]	Matrix met sublijsten. Elke sublijst is een sleutel en de bijbehorende waarden.	[]
listKey	One	Een genormaliseerde waarde voor de lijst met synoniemen waaraan moet worden toegewezen in voorspelling.	One
synonyms	[]	Matrix met alle synoniemen	Synoniem
language	{LANGUAGE-CODE}	Een tekenreeks die de taalcode voor het synoniem in uw sublijst opgeeft. Als uw project een meertalige project is en u uw lijst met synoniemen voor alle talen in uw project wilt ondersteunen, moet u uw synoniemen expliciet toevoegen aan elke taal. Zie Taalondersteuning voor meer informatie over ondersteunde taalcodes.	en
values	"EntityNumberone", "FirstEntity"	Een lijst met door komma's gescheiden tekenreeksen die exact overeenkomen voor extractie en toewijzing aan de lijstsleutel.	"EntityNumberone", "FirstEntity"
prebuilts	MedicationName	De naam van het vooraf gemaakte onderdeel dat de vooraf gedefinieerde entiteit invult. Vooraf gemaakte entiteiten worden standaard automatisch in uw project geladen, maar u kunt ze uitbreiden met lijstonderdelen in uw labelsbestand.	MedicationName
documents		Matrix met alle documenten in uw project en een lijst met de entiteiten die in elk document zijn gelabeld.	[]
location	{DOCUMENT-NAME}	De locatie van de documenten in de opslagcontainer. Omdat alle documenten zich in de hoofdmap van de container bevinden, moet dit de naam van het document zijn.	doc1.txt
dataset	{DATASET}	De testset waarnaar dit bestand gaat wanneer het wordt gesplitst vóór de training. Mogelijke waarden voor dit veld zijn Train en Test.	Train
regionOffset		De inclusieve tekenpositie van het begin van de tekst.	0
regionLength		De lengte van het begrenzingsvak in termen van UTF16-tekens. Training houdt alleen rekening met de gegevens in deze regio.	500
category		Het type entiteit dat is gekoppeld aan de opgegeven reeks tekst.	Entity1
offset		De beginpositie voor de entiteitstekst.	25
length		De lengte van de entiteit in termen van UTF16-tekens.	20
language	{LANGUAGE-CODE}	Een tekenreeks die de taalcode opgeeft voor het document dat in uw project wordt gebruikt. Als uw project een meertalige project is, kiest u de taalcode van het merendeel van de documenten. Zie Taalondersteuning voor meer informatie over ondersteunde taalcodes.	en

Zodra u uw API-aanvraag hebt verzonden, ontvangt u een 202 antwoord dat aangeeft dat de taak correct is verzonden. Pak de operation-location waarde uit in de antwoordheaders. Deze wordt als volgt opgemaakt:

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

{JOB-ID} wordt gebruikt om uw aanvraag te identificeren, omdat deze bewerking asynchroon is. U gebruikt deze URL om de status van de importtaak op te halen.

Mogelijke foutscenario's voor deze aanvraag:

• De geselecteerde resource beschikt niet over de juiste machtigingen voor het opslagaccount.
• De storageInputContainerName opgegeven bestaat niet.
• Ongeldige taalcode wordt gebruikt of als het taalcodetype geen tekenreeks is.
• multilingual waarde is een tekenreeks en geen booleaanse waarde.

Projectdetails ophalen

Language Studio

1. Ga naar de pagina met projectinstellingen in Language Studio.

2. U kunt projectdetails bekijken.

3. Op deze pagina kunt u de beschrijving van het project bijwerken en de meertalige gegevensset in-/uitschakelen in projectinstellingen.

4. U kunt ook het verbonden opslagaccount en de container weergeven met uw taalresource.

5. U kunt ook uw primaire resourcesleutel ophalen van deze pagina.

   

REST-API's

Gebruik de volgende GET-aanvraag om uw projectgegevens op te halen. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.

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

Tijdelijke aanduiding	Weergegeven als	Opmerking
{ENDPOINT}	Het eindpunt voor het verifiëren van uw API-aanvraag.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	De naam voor uw project. Deze waarde is hoofdlettergevoelig.	myProject
{API-VERSION}	De versie van de API die u aanroept. Zie de levenscyclus van het model voor meer informatie over andere beschikbare API-versies.	2022-05-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel	Weergegeven als
Ocp-Apim-Subscription-Key	De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Hoofdtekst van de reactie

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

Weergegeven als	Plaatsaanduiding	Omschrijving	Voorbeeld
projectKind	CustomHealthcare	Uw projecttype.	CustomHealthcare
storageInputContainerName	{CONTAINER-NAME}	De naam van uw Azure Storage-container waar u uw documenten hebt geüpload.	myContainer
projectName	{PROJECT-NAME}	De naam van uw project. Deze waarde is hoofdlettergevoelig.	myProject
multilingual	true	Een Booleaanse waarde waarmee u documenten in meerdere talen in uw gegevensset kunt hebben en wanneer uw model wordt geïmplementeerd, kunt u een query uitvoeren op het model in elke ondersteunde taal (niet noodzakelijkerwijs documenten die zijn opgenomen in uw trainingsdocumenten). Zie Taalondersteuning voor meer informatie over meertalige ondersteuning.	true
language	{LANGUAGE-CODE}	Een tekenreeks die de taalcode opgeeft voor de documenten die in uw project worden gebruikt. Als uw project een meertalige project is, kiest u de taalcode van het merendeel van de documenten.	en

Zodra u uw API-aanvraag hebt verzonden, ontvangt u een 200 antwoord dat aangeeft dat de aanvraag is geslaagd en de hoofdtekst van het JSON-antwoord met de projectgegevens.

Project verwijderen

Language Studio

Wanneer u uw project niet meer nodig hebt, kunt u uw project verwijderen met Behulp van Language Studio.

1. Selecteer de taalservicefunctie die u boven aan de pagina gebruikt.
2. Selecteer het project dat u wilt verwijderen
3. Selecteer Verwijderen in het hoofdmenu.

REST-API's

Wanneer u uw project niet meer nodig hebt, kunt u het verwijderen met de volgende DELETE-aanvraag . Vervang de tijdelijke aanduidingen door uw eigen waarden.

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

Tijdelijke aanduiding	Weergegeven als	Opmerking
{ENDPOINT}	Het eindpunt voor het verifiëren van uw API-aanvraag.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	De naam voor uw project. Deze waarde is hoofdlettergevoelig.	myProject
{API-VERSION}	De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is voor de nieuwste versie die is uitgebracht. Zie de levenscyclus van het model voor meer informatie over andere beschikbare API-versies.	2022-05-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel	Weergegeven als
Ocp-Apim-Subscription-Key	De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Zodra u uw API-aanvraag hebt verzonden, ontvangt u een 202 antwoord dat aangeeft dat uw project is verwijderd. Een geslaagde aanroepresultaten met een header Operation-Location die wordt gebruikt om de status van de taak te controleren.

Volgende stappen

• U moet een idee hebben van het projectschema dat u gaat gebruiken om uw gegevens te labelen.

• Nadat u uw schema hebt gedefinieerd, kunt u beginnen met het labelen van uw gegevens, die worden gebruikt voor modeltraining, evaluatie en tot slot voorspellingen doen.