Een CLU-project maken

Gebruik dit artikel voor meer informatie over het instellen van deze vereisten en het maken van een project.

Vereisten

Voordat u CLU gaat gebruiken, hebt u verschillende dingen nodig:

• Een Azure-abonnement: maak er gratis een.
• Een Azure AI-taalresource

Een taalresource maken

Voordat u CLU gaat gebruiken, hebt u een Azure AI Language-resource nodig.

Notitie

• U moet een eigenaarsrol hebben toegewezen aan de resourcegroep om een taalresource te maken.

Een nieuwe resource maken vanuit Azure Portal

1. Meld u aan bij Azure Portal om een nieuwe Azure AI Language-resource te maken.

2. Selecteer Een nieuwe resource maken

3. Zoek in het venster dat wordt weergegeven naar taalservice

4. Selecteer Maken.

5. Maak een taalresource met de volgende details.

   Instantiedetails	Vereiste waarde
   Region	Een van de ondersteunde regio's voor uw taalresource.
   Naam	Vereiste naam voor uw taalresource
   Prijscategorie	Een van de ondersteunde prijscategorieën voor uw taalresource.

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 taalresource
Locatie	Een ondersteunde regio's voor uw taalresource.
Prijscategorie	Een ondersteunde prijscategorie voor uw taalresource.

Belangrijk

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

Aanmelden bij Language Studio

1. Ga naar Language Studio en meld u aan met uw Azure-account.

2. Zoek uw Azure-abonnement in het venster Kies een taalresource die wordt weergegeven en kies uw taalresource. Als u geen resource hebt, kunt u een nieuwe maken.

   Instantiedetails	Vereiste waarde
   Azure-abonnement	Uw Azure-abonnement.
   Azure-resourcegroep	De naam van uw Azure-resourcegroep.
   Azure-resourcenaam	De naam van uw Azure-resource.
   Locatie	Een van de ondersteunde regio's voor uw taalresource. Bijvoorbeeld US - west 2.
   Prijscategorie	Een van de geldige prijscategorieën voor uw taalresource. U kunt de gratis laag (F0) gebruiken om de service uit te proberen.

   

Een gespreksproject maken

Zodra u een Taalresource hebt gemaakt, maakt u een Conversational Language Understanding-project.

Language Studio

1. Zoek in Language Studio de sectie Met de naam Vragen en gesprekstaal begrijpen en selecteer Gesprekstaal.
   

2. Hiermee gaat u naar de pagina Conversational Language Understanding-projecten . Selecteer Nieuw project maken.

   

Als u een nieuw project wilt maken, moet u de volgende details opgeven:

Waarde	Beschrijving
Naam	Een naam voor uw project. Zodra deze is gemaakt, kan deze niet meer worden gewijzigd
Omschrijving	Optionele projectbeschrijving.
Primaire taal uitingen	De primaire taal van uw project. Uw trainingsgegevens moeten voornamelijk in deze taal staan.
Meerdere talen inschakelen	Of u uw project nu in staat wilt stellen om meerdere talen tegelijk te ondersteunen.

Zodra u klaar bent, selecteert u Volgende en controleert u de details. Selecteer Maken om het proces te voltooien. U ziet nu het scherm Schema maken in uw project.

REST-API's

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

Aanvraag-URL

Gebruik de volgende URL bij het maken van uw API-aanvraag. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.

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

Tijdelijke aanduiding	Waarde	Voorbeeld
{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.	2023-04-01

Headers

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

Sleutel	Waarde
Ocp-Apim-Subscription-Key	De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.
Content-Type	'application/merge-patch+json'

Tekst

Gebruik de volgende voorbeeld-JSON als hoofdtekst.

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "Conversation",
  "description": "Project description",
  "multilingual": true
}

Key	Tijdelijke aanduiding	Waarde	Voorbeeld
projectName	{PROJECT-NAME}	De naam van uw project. Deze waarde is hoofdlettergevoelig.	EmailApp
language	{LANGUAGE-CODE}	Een tekenreeks die de taalcode opgeeft voor de uitingen die in uw project worden gebruikt. Als uw project een meertalige project is, kiest u de taalcode van het merendeel van de uitingen.	en-us
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

Project importeren

Language Studio

U kunt een Conversational Language Understanding-project op elk gewenst moment exporteren als een JSON-bestand door naar de pagina gespreksprojecten te gaan, een project te selecteren en in het bovenste menu op Exporteren te klikken.

Dat project kan opnieuw wordenimporteerd als een nieuw project. Als u een project met dezelfde naam importeert, worden de gegevens van het project vervangen door de zojuist geïmporteerde projectgegevens.

Als u een bestaande LUIS-toepassing hebt, kunt u de JSON van de LUIS-toepassing rechtstreeks importeren in Conversational Language Understanding en wordt er een gespreksproject gemaakt met alle beschikbare onderdelen: Intents, ML-entiteiten en utterances. Zie het LUIS-migratieartikel voor meer informatie.

Als u een project wilt importeren, selecteert u de pijlknop naast Een nieuw project maken en selecteert u Importeren en selecteert u vervolgens het JSON-bestand LUIS of Conversational Language Understanding.

REST-API's

U kunt een CLU JSON importeren in de service

Verzend een POST-aanvraag met behulp van de volgende URL, headers en JSON-hoofdtekst om uw project te importeren.

Aanvraag-URL

Gebruik de volgende URL bij het maken van uw API-aanvraag. Vervang de tijdelijke aanduidingen door uw eigen waarden.

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

Tijdelijke aanduiding	Waarde	Voorbeeld
{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 en moet overeenkomen met de projectnaam in het JSON-bestand dat u importeert.	EmailAppDemo
{API-VERSION}	De versie van de API die u aanroept.	2023-04-01

Headers

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

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

Tekst

De JSON-hoofdtekst die u verzendt, is vergelijkbaar met het volgende voorbeeld. Raadpleeg de referentiedocumentatie voor meer informatie over het JSON-object.

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectKind": "Conversation",
    "settings": {
      "confidenceThreshold": 0.7
    },
    "projectName": "{PROJECT-NAME}",
    "multilingual": true,
    "description": "Trying out CLU",
    "language": "{LANGUAGE-CODE}"
  },
  "assets": {
    "projectKind": "Conversation",
    "intents": [
      {
        "category": "intent1"
      },
      {
        "category": "intent2"
      }
    ],
    "entities": [
      {
        "category": "entity1"
      }
    ],
    "utterances": [
      {
        "text": "text1",
        "dataset": "{DATASET}",
        "intent": "intent1",
        "entities": [
          {
            "category": "entity1",
            "offset": 5,
            "length": 5
          }
        ]
      },
      {
        "text": "text2",
        "language": "{LANGUAGE-CODE}",
        "dataset": "{DATASET}",
        "intent": "intent2",
        "entities": []
      }
    ]
  }
}

Key	Tijdelijke aanduiding	Waarde	Voorbeeld
{API-VERSION}	De versie van de API die u aanroept.	2023-04-01
projectName	{PROJECT-NAME}	De naam van uw project. Deze waarde is hoofdlettergevoelig.	EmailAppDemo
language	{LANGUAGE-CODE}	Een tekenreeks die de taalcode opgeeft voor de uitingen die in uw project worden gebruikt. Als uw project een meertalige project is, kiest u de taalcode van het merendeel van de uitingen.	en-us
multilingual	true	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 , inclusief talen die niet zijn opgenomen in uw trainingsdocumenten.	true
dataset	{DATASET}	Lees hoe u een model traint voor informatie over het splitsen van uw gegevens tussen een test- en trainingsset. Mogelijke waarden voor dit veld zijn Train en Test.	Train

Na een geslaagde aanvraag bevat het API-antwoord een operation-location header met een URL die u kunt gebruiken om de status van de importtaak te controleren. De indeling is als volgt:

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

Project exporteren

Language Studio

U kunt een Conversational Language Understanding-project op elk gewenst moment exporteren als een JSON-bestand door naar de pagina gespreksprojecten te gaan, een project te selecteren en op Exporteren te drukken.

REST-API's

U kunt een Conversational Language Understanding-project op elk gewenst moment exporteren als een JSON-bestand.

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

Aanvraag-URL

Gebruik de volgende URL bij het maken van uw API-aanvraag. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:export?stringIndexType=Utf16CodeUnit&api-version={API-VERSION}

Tijdelijke aanduiding	Waarde	Voorbeeld
{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.	EmailApp
{API-VERSION}	De versie van de API die u aanroept.	2023-04-01

Headers

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

Sleutel	Waarde
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 het is gelukt. Pak de operation-location waarde uit in de antwoordheaders. Deze wordt als volgt opgemaakt:

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

JOB-ID wordt gebruikt om uw aanvraag te identificeren, omdat deze bewerking asynchroon is. Gebruik deze URL om de geëxporteerde project-JSON op te halen met dezelfde verificatiemethode.

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

   

REST-API's

Als u de projectgegevens 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-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

Tijdelijke aanduiding	Waarde	Voorbeeld
{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.	2023-04-01

Headers

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

Sleutel	Waarde
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-18T13:53:03Z",
  "lastModifiedDateTime": "2022-04-18T13:53:03Z",
  "lastTrainedDateTime": "2022-04-18T14:14:28Z",
  "lastDeployedDateTime": "2022-04-18T14:49:01Z",
  "projectKind": "Conversation",
  "projectName": "{PROJECT-NAME}",
  "multilingual": true,
  "description": "This is a sample conversation project.",
  "language": "{LANGUAGE-CODE}"
}

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. Selecteer Projecten in het linkernavigatiemenu, selecteer het project dat u wilt verwijderen en selecteer vervolgens Verwijderen in het bovenste menu.

REST-API's

Wanneer u uw project niet meer nodig hebt, kunt u uw project verwijderen met behulp van de API's.

Maak een DELETE-aanvraag met behulp van de volgende URL, headers en JSON-hoofdtekst om een conversationele taalkennisproject te verwijderen.

Aanvraag-URL

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

Tijdelijke aanduiding	Waarde	Voorbeeld
{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.	2023-04-01

Headers

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

Sleutel	Waarde
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.

Volgende stappen

Schema bouwen