Een aangepast tekstclassificatieproject maken

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

Vereisten

Voordat u begint met het gebruik van aangepaste tekstclassificatie, hebt u het volgende nodig:

• Een Azure-abonnement: maak er gratis een.

Een taalresource maken

Voordat u begint met het gebruik van aangepaste tekstclassificatie, hebt u een Azure AI-taalresource 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 ervan voor gebruik met aangepaste tekstclassificatie.

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

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

Notitie

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

Azure-portal

Een nieuwe resource maken vanuit Azure Portal

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

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

   

3. Maak een taalresource met de volgende details.

   Naam	Vereiste waarde
   Abonnement	Uw Azure-abonnement.
   Resourcegroep	Een resourcegroep die uw resource bevat. U kunt een bestaande gebruiken of een nieuwe maken.
   Regio	Een van de ondersteunde regio's. Bijvoorbeeld US - west 2.
   Naam	Een naam voor uw resource.
   Prijscategorie	Een van de ondersteunde prijscategorieën. U kunt de gratis laag (F0) gebruiken om de service uit te proberen.

   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.

   U kunt de eigenaar van uw Azure-abonnement bepalen door uw resourcegroep te doorzoeken en de koppeling naar het bijbehorende abonnement te volgen. Daarna kunt u het volgende doen:

   1. Het tabblad Toegangsbeheer (IAM) selecteren
   2. Roltoewijzingen selecteren
   3. Filteren op rol:eigenaar.

4. Selecteer in de sectie Aangepaste tekstclassificatie en aangepaste entiteitsherkenning een bestaand opslagaccount of selecteer Nieuw opslagaccount. Houd er rekening mee dat deze waarden u 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 Controleren en maken onderaan de pagina.

Language Studio

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 waar uw taalresource zich bevindt.
Prijscategorie	De prijscategorie voor uw taalresource.

Belangrijk

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

Als u aangepaste tekstclassificatie wilt gebruiken, moet u uw resource verbinden met een opslagaccount. Als u er nog geen hebt, kunt u een Azure-opslagaccount maken. Gebruik de volgende stappen om uw eerste project te maken en uw opslagaccount te verbinden.

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 aangepaste tekstclassificatie onder de sectie Tekst classificeren van Language Studio.

   

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. Nadat u op Nieuw project hebt geklikt, 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 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. Selecteer het projecttype. U kunt een classificatieproject met meerdere labels maken waarin elk document kan behoren tot een of meer klassen of een project voor classificatie van één label, waarbij elk document tot slechts één klasse kan behoren. Het geselecteerde type kan later niet meer worden gewijzigd. Meer informatie over projecttypen

   

6. Voer de projectgegevens in, inclusief een naam, beschrijving en de taal van de documenten 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 .

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

   Notitie

   Als u uw gegevens al hebt gelabeld, moet u ervoor zorgen dat deze de ondersteunde indeling volgt en Ja selecteert , zijn mijn documenten al gelabeld en heb ik het JSON-labelsbestand opgemaakt en selecteer het labelbestand in de vervolgkeuzelijst hieronder.

   Als u een van de voorbeeldgegevenssets gebruikt, gebruikt u het opgenomen webOfScience_labelsFile of movieLabels json-bestand. Selecteer Volgende.

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

Azure PowerShell gebruiken

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	De regio waarin uw resource wordt gehost. Zie regioondersteuning voor meer informatie.
sku	De prijscategorie van uw resource. Zie servicelimieten voor meer informatie.
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

Vereiste	Beschrijving
Regio's	Zorg ervoor dat uw bestaande resource is ingericht in een van de ondersteunde regio's. Als u geen resource hebt, moet u een nieuwe maken in een ondersteunde regio.
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 tekstclassificatie wilt gebruiken, moet u een Azure-opslagaccount maken als u er nog geen hebt.

Identiteitsbeheer inschakelen voor uw resource

Azure-portal

Uw taalresource moet identiteitsbeheer hebben 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.

Functie voor aangepaste tekstclassificatie inschakelen

Zorg ervoor dat u de functie Aangepaste tekstclassificatie/Aangepaste entiteitsherkenning inschakelt 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. Aangepaste tekstclassificatie inschakelen /Functie Voor herkenning van aangepaste benoemde entiteiten
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.

Rollen instellen voor uw Azure AI-taalresource en -opslagaccount

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 tekstclassificatieproject maken

Zodra uw resource en opslagcontainer zijn geconfigureerd, maakt u een nieuw aangepast tekstclassificatieproject. 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 importeren om aan de slag te gaan.

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 aangepaste tekstclassificatie onder de sectie Tekst classificeren van Language Studio.

   

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. Nadat u op Nieuw project hebt geklikt, 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 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. Selecteer het projecttype. U kunt een classificatieproject met meerdere labels maken waarin elk document kan behoren tot een of meer klassen of een project voor classificatie van één label, waarbij elk document tot slechts één klasse kan behoren. Het geselecteerde type kan later niet meer worden gewijzigd. Meer informatie over projecttypen

   

6. Voer de projectgegevens in, inclusief een naam, beschrijving en de taal van de documenten 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 .

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

   Notitie

   Als u uw gegevens al hebt gelabeld, moet u ervoor zorgen dat deze de ondersteunde indeling volgt en Ja selecteert , zijn mijn documenten al gelabeld en heb ik het JSON-labelsbestand opgemaakt en selecteer het labelbestand in de vervolgkeuzelijst hieronder.

   Als u een van de voorbeeldgegevenssets gebruikt, gebruikt u het opgenomen webOfScience_labelsFile of movieLabels json-bestand. Selecteer Volgende.

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

REST-API's

Als u een aangepast model voor tekstclassificatie 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

Headers

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.

Tekst

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

Classificatie met meerdere labels

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

Key	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	customMultiLabelClassification	Uw projecttype.	customMultiLabelClassification
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 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

Classificatie van één label

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

Key	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	customSingleLabelClassification	Uw projecttype.	customSingleLabelClassification
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 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.

Een aangepast tekstclassificatieproject 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 aangepaste tekstclassificatie onder de sectie Tekst classificeren van Language Studio.

   

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. 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. Selecteer het projecttype. U kunt een classificatieproject met meerdere labels maken waarin elk document kan behoren tot een of meer klassen of een project voor classificatie van één label, waarbij elk document tot slechts één klasse kan behoren. Het geselecteerde type kan later niet meer worden gewijzigd.

   

6. Voer de projectgegevens in, inclusief een naam, beschrijving en de taal van de documenten 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 .

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

8. Selecteer Ja, mijn documenten 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.

9. Selecteer Volgende.

10. 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. Meer informatie over andere beschikbare API-versies	2022-05-01

Headers

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.

Tekst

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

Classificatie met meerdere labels

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectName": "{PROJECT-NAME}",
    "storageInputContainerName": "{CONTAINER-NAME}",
    "projectKind": "customMultiLabelClassification",
    "description": "Trying out custom multi label text classification",
    "language": "{LANGUAGE-CODE}",
    "multilingual": true,
    "settings": {}
  },
  "assets": {
    "projectKind": "customMultiLabelClassification",
    "classes": [
      {
        "category": "Class1"
      },
      {
        "category": "Class2"
      }
    ],
    "documents": [
      {
        "location": "{DOCUMENT-NAME}",
        "language": "{LANGUAGE-CODE}",
        "dataset": "{DATASET}",
        "classes": [
          {
            "category": "Class1"
          },
          {
            "category": "Class2"
          }
        ]
      },
      {
        "location": "{DOCUMENT-NAME}",
        "language": "{LANGUAGE-CODE}",
        "dataset": "{DATASET}",
        "classes": [
          {
            "category": "Class2"
          }
        ]
      }
    ]
  }
}

Key	Tijdelijke aanduiding	Weergegeven als	Opmerking
api-versie	{API-VERSION}	De versie van de API die u aanroept. De versie die hier wordt gebruikt, moet dezelfde API-versie in de URL zijn. Meer informatie over andere beschikbare API-versies	2022-05-01
projectNaam	{PROJECT-NAME}	De naam van uw project. Deze waarde is hoofdlettergevoelig.	myProject
projectKind	customMultiLabelClassification	Uw projecttype.	customMultiLabelClassification
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 meertalige ondersteuning.	en-us
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 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
klassen	[]	Matrix met alle klassen die u in het project hebt. Dit zijn de klassen waarnaar u uw documenten wilt classificeren.	[]
documents	[]	Matrix met alle documenten in uw project en wat de klassen zijn gelabeld voor dit document.	[]
locatie	{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
gegevensset	{DATASET}	De testset waarnaar dit document gaat wanneer het wordt gesplitst vóór de training. Zie Hoe u een model traint voor meer informatie over het splitsen van gegevens. Mogelijke waarden voor dit veld zijn Train en Test.	Train

Classificatie van één label

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectName": "{PROJECT-NAME}",
    "storageInputContainerName": "{CONTAINER-NAME}",
    "projectKind": "customSingleLabelClassification",
    "description": "Trying out custom multi label text classification",
    "language": "{LANGUAGE-CODE}",
    "multilingual": true,
    "settings": {}
  },
  "assets": {
    "projectKind": "customSingleLabelClassification",
        "classes": [
            {
                "category": "Class1"
            },
            {
                "category": "Class2"
            }
        ],
        "documents": [
            {
                "location": "{DOCUMENT-NAME}",
                "language": "{LANGUAGE-CODE}",
                "dataset": "{DATASET}",
                "class": {
                    "category": "Class2"
                }
            },
            {
                "location": "{DOCUMENT-NAME}",
                "language": "{LANGUAGE-CODE}",
                "dataset": "{DATASET}",
                "class": {
                    "category": "Class1"
                }
            }
        ]
    }
}

Key	Tijdelijke aanduiding	Weergegeven als	Opmerking
api-versie	{API-VERSION}	De versie van de API die u aanroept. De versie die hier wordt gebruikt, moet dezelfde API-versie in de URL zijn.	2022-05-01
projectNaam	{PROJECT-NAME}	De naam van uw project. Deze waarde is hoofdlettergevoelig.	myProject
projectKind	customSingleLabelClassification	Uw projecttype.	customSingleLabelClassification
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
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 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
klassen	[]	Matrix met alle klassen die u in het project hebt. Dit zijn de klassen waarnaar u uw documenten wilt classificeren.	[]
documents	[]	Matrix met alle documenten in uw project en tot welke klasse dit document behoort.	[]
locatie	{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
gegevensset	{DATASET}	De testset waarnaar dit document gaat wanneer het wordt gesplitst vóór de training. Zie Hoe u een model traint voor meer informatie over het splitsen van gegevens. Mogelijke waarden voor dit veld zijn Train en Test.	Train

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 projectbeschrijving 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 uw primaire resourcesleutel ook ophalen van deze pagina.

   

REST-API's

Als u projectdetails van aangepaste tekstclassificatie wilt ophalen, dient u een GET-aanvraag in met behulp van de volgende URL en headers. Vervang de tijdelijke aanduidingen 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. De waarde waarnaar hier wordt verwezen, is voor de meest recente uitgebrachte modelversie.	2022-05-01

Headers

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 antwoord

Zodra u de aanvraag hebt verzonden, krijgt u het volgende antwoord.

{
  "createdDateTime": "2022-04-23T13:39:09.384Z",
  "lastModifiedDateTime": "2022-04-23T13:39:09.384Z",
  "lastTrainedDateTime": "2022-04-23T13:39:09.384Z",
  "lastDeployedDateTime": "2022-04-23T13:39:09.384Z",
  "projectKind": "customSingleLabelClassification",
  "storageInputContainerName": "{CONTAINER-NAME}",
  "projectName": "{PROJECT-NAME}",
  "multilingual": true,
  "description": "Project description",
  "language": "{LANGUAGE-CODE}"
}

Weergegeven als	Tijdelijke aanduiding	Omschrijving	Voorbeeld
projectKind	customSingleLabelClassification	Uw projecttype.	Deze waarde kan customSingleLabelClassification of customMultiLabelClassification.
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		Een booleaanse waarde waarmee u documenten in meerdere talen in uw gegevensset kunt hebben. Wanneer uw model is 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
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

Zodra u uw API-aanvraag hebt verzonden, ontvangt u een 200 antwoord dat aangeeft dat de aanvraag is geslaagd en de JSON-antwoordtekst 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. Selecteer aangepaste tekstclassificatie bovenaan en selecteer vervolgens het project dat u wilt verwijderen. Selecteer Verwijderen in het bovenste menu om het project te verwijderen.

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. Meer informatie over andere beschikbare API-versies	2022-05-01

Headers

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 aanroep met een Operation-Location header 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 uw project is gemaakt, kunt u beginnen met het labelen van uw gegevens, zodat uw tekstclassificatiemodel wordt geïnformeerd over het interpreteren van tekst en wordt gebruikt voor training en evaluatie.