Erstellen eines CLU-Projekts

In diesem Artikel erfahren Sie, wie Sie diese Anforderungen einrichten und ein Projekt erstellen.

Voraussetzungen

Bevor Sie mit der Verwendung des CLU beginnen, benötigen Sie Folgendes:

• Azure-Abonnement – kostenloses Abonnement erstellen.
• Eine Azure KI Language-Ressource

Erstellen einer Sprachressource

Bevor Sie CLU verwenden können, benötigen Sie eine Azure KI Language-Ressource.

Hinweis

• Ihnen muss die Rolle Besitzer für die Ressourcengruppe zugewiesen sein, damit Sie eine Sprachressource erstellen können.

Erstellen einer neuen Ressource im Azure-Portal

1. Melden Sie sich beim Azure-Portal an, um eine neue Azure KI Language-Ressource zu erstellen.

2. Wählen Sie Neue Ressource erstellen aus.

3. Suchen Sie im angezeigten Fenster nach Sprachdienst.

4. Klicken Sie auf Erstellen

5. Erstellen Sie eine Sprachressource mit den folgenden Details:

   Instanzdetails	Erforderlicher Wert
   Region	Eine der unterstützten Regionen für Ihre Sprachressource.
   Name	Erforderlicher Name für Ihre Language-Ressource
   Tarif	Einer der unterstützten Tarife für Ihre Sprachressource

Erstellen einer neuen Sprachressource über Language Studio

Wenn Sie sich zum ersten Mal anmelden, wird in Language Studio ein Fenster angezeigt, in dem Sie eine vorhandene Sprachressource auswählen oder eine neue erstellen können. Sie können eine Ressource auch erstellen, indem Sie auf das Einstellungssymbol in der oberen rechten Ecke klicken, Ressourcen auswählen und dann auf Neue Ressource erstellen klicken.

Erstellen Sie eine Sprachressource mit den folgenden Details:

Instanzdetails	Erforderlicher Wert
Azure-Abonnement	Ihr Azure-Abonnement
Azure-Ressourcengruppe	Ihre Azure-Ressourcengruppe
Name der Azure-Ressource	Name der Sprachressource
Standort	Eine unterstützte Region für Ihre Sprachressource
Tarif	Ein unterstützter Tarif für Ihre Sprachressource

Wichtig

• Achten Sie darauf, dass Sie Verwaltete Identität aktivieren, wenn Sie eine Sprachressource erstellen.
• Lesen und Bestätigen des Hinweises zu verantwortungsvoller KI

Anmelden bei Language Studio

1. Wechseln Sie zu Language Studio, und melden Sie sich mit Ihrem Azure-Konto an.

2. Suchen Sie im angezeigten Fenster Sprachressource auswählen nach Ihrem Azure-Abonnement, und wählen Sie Ihre Sprachressource aus. Wenn keine Ressource vorhanden ist, können Sie eine neue erstellen.

   Instanzdetails	Erforderlicher Wert
   Azure-Abonnement	Ihr Azure-Abonnement.
   Azure-Ressourcengruppe	Der Name Ihrer Azure-Ressourcengruppe.
   Name der Azure-Ressource	Der Name Ihrer Azure-Ressource.
   Standort	Eine der unterstützten Regionen für Ihre Sprachressource. Beispiel: „USA, Westen 2“
   Tarif	Einer der gültigen Tarife für Ihre Sprachressource. Sie können den kostenlosen Tarif (F0) verwenden, um den Dienst auszuprobieren.

   

Erstellen eines Unterhaltungsprojekts

Nachdem Sie eine Sprachressource erstellt haben, erstellen Sie ein Conversational Language Understanding-Projekt.

Language Studio

1. Suchen Sie in Language Studio den Abschnitt Fragen und Unterhaltungssprache verstehen, und wählen Sie Conversational Language Understanding aus:
   

2. Dadurch gelangen Sie zur Seite Conversational Language Understanding-Projekte. Wählen Sie Neues Projekt erstellen aus.

   

Zum Erstellen eines neuen Projekts müssen Sie die folgenden Details angeben:

Wert	Beschreibung
Name	Einen Namen für Ihr Projekt. Er kann nach der Erstellung nicht mehr geändert werden.
BESCHREIBUNG	Eine optionale Projektbeschreibung.
Utterances primary language (Primäre Sprache für Äußerungen)	Die primäre Sprache Ihres Projekts. Ihre Trainingsdaten sollten hauptsächlich in dieser Sprache vorliegen.
Mehrere Sprachen aktivieren	Gibt an, ob Sie Ihrem Projekt die gleichzeitige Unterstützung mehrerer Sprachen ermöglichen möchten.

Wenn Sie fertig sind, wählen Sie Weiter aus, und überprüfen Sie die Details. Wählen Sie Erstellen aus, um den Prozess abzuschließen. Nun sollte der Bildschirm Schemaerstellung in Ihrem Projekt angezeigt werden.

REST-APIs

Übermitteln Sie eine PATCH-Anforderung mithilfe der folgenden URL, der Header und des JSON-Texts, um ein neues Projekt zu erstellen.

Anfrage-URL

Verwenden Sie zum Erstellen Ihrer API-Anforderung die folgende URL. Ersetzen Sie die folgenden Platzhalter durch Ihre eigenen Werte.

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

Platzhalter	Wert	Beispiel
{ENDPOINT}	Der Endpunkt für die Authentifizierung Ihrer API-Anforderung.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Der Name für Ihr Projekt. Bei diesem Wert wird die Groß-/Kleinschreibung beachtet.	myProject
{API-VERSION}	Dies ist die Version der von Ihnen aufgerufenen API.	2023-04-01

Header

Verwenden Sie den folgenden Header, um Ihre Anforderung zu authentifizieren.

Schlüssel	Wert
Ocp-Apim-Subscription-Key	Der Schlüssel für Ihre Ressource. Wird für die Authentifizierung Ihrer API-Anforderungen verwendet.
Content-Type	'application/merge-patch+json'

Body

Verwenden Sie den folgenden JSON-Beispieltext.

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

Schlüssel	Platzhalter	Wert	Beispiel
projectName	{PROJECT-NAME}	Der Name des Projekts. Bei diesem Wert wird die Groß-/Kleinschreibung beachtet.	EmailApp
language	{LANGUAGE-CODE}	Hierbei handelt es sich um eine Zeichenfolge, die den Sprachcode für die in Ihrem Projekt verwendete Äußerung angibt. Wählen Sie bei einem mehrsprachigen Projekt den Sprachcode aus, der für die Mehrheit der Äußerungen verwendet wird.	en-us
multilingual	true	Dies ist ein boolescher Wert, der es ermöglicht, dass Ihr Dataset Dokumente in mehreren Sprachen enthält. Wenn Ihr Modell bereitgestellt wird, können Sie das Modell in jeder unterstützten Sprache abfragen (die nicht zwangsläufig in Ihren Trainingsdokumenten enthalten ist). Informationen zur Unterstützung mehrerer Sprachen finden Sie unter Sprachunterstützung.	true

Importieren des Projekts

Language Studio

Sie können ein Conversational Language Understanding-Projekt jederzeit als JSON-Datei exportieren, indem Sie zur Seite mit den Unterhaltungsprojekten wechseln, ein Projekt auswählen und im oberen Menü auf Exportieren klicken.

Dieses Projekt kann als neues Projekt erneut importiert werden. Wenn Sie ein Projekt mit genau demselben Namen importieren, werden die Daten des Projekts durch die Daten des neu importierten Projekts ersetzt.

Wenn Sie über eine vorhandene LUIS-Anwendung verfügen, können Sie den JSON-Code der LUIS-Anwendung direkt in Conversational Language Understanding importieren, dann wird ein Unterhaltungsprojekt mit allen aktuell verfügbaren Teilen erstellt: Absichten, ML-Entitäten und Äußerungen. Weitere Informationen finden Sie im Artikel zur LUIS-Migration.

Wählen Sie zum Importieren eines Projekts die Pfeilschaltfläche neben Neues Projekt erstellen, und wählen Sie Importieren aus. Wählen Sie anschließend die JSON-Datei für LUIS oder Conversational Language Understanding aus.

REST-APIs

Sie können einen CLU-JSON-Code in den Dienst importieren.

Übermitteln Sie eine POST-Anforderung mithilfe der folgenden URL, der Header und des JSON-Texts, um Ihr Projekt zu importieren.

Anfrage-URL

Verwenden Sie zum Erstellen Ihrer API-Anforderung die folgende URL. Ersetzen Sie die Platzhalterwerte durch eigene Werte.

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

Platzhalter	Wert	Beispiel
{ENDPOINT}	Der Endpunkt für die Authentifizierung Ihrer API-Anforderung.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Der Name für Ihr Projekt. Bei diesem Wert wird die Groß-/Kleinschreibung beachtet, und er muss mit dem Projektnamen in der JSON-Datei übereinstimmen, die Sie importieren.	EmailAppDemo
{API-VERSION}	Die Version der von Ihnen aufgerufenen API.	2023-04-01

Header

Verwenden Sie den folgenden Header, um Ihre Anforderung zu authentifizieren.

Schlüssel	Wert
Ocp-Apim-Subscription-Key	Der Schlüssel für Ihre Ressource. Wird für die Authentifizierung Ihrer API-Anforderungen verwendet.

Body

Der JSON-Text, den Sie senden, ähnelt dem folgenden Beispiel. Weitere Informationen zum JSON-Objekt finden Sie in der Referenzdokumentation.

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

Schlüssel	Platzhalter	Wert	Beispiel
{API-VERSION}	Die Version der von Ihnen aufgerufenen API.	2023-04-01
projectName	{PROJECT-NAME}	Der Name des Projekts. Bei diesem Wert wird die Groß-/Kleinschreibung beachtet.	EmailAppDemo
language	{LANGUAGE-CODE}	Hierbei handelt es sich um eine Zeichenfolge, die den Sprachcode für die in Ihrem Projekt verwendete Äußerung angibt. Wählen Sie bei einem mehrsprachigen Projekt den Sprachcode aus, der für die Mehrheit der Äußerungen verwendet wird.	en-us
multilingual	true	Ein boolescher Wert, der es ermöglicht, dass Ihr Dataset Dokumente in mehreren Sprachen enthält. Wenn Ihr Modell bereitgestellt wird, können Sie das Modell in jeder unterstützten Sprache abfragen, einschließlich Sprachen, die nicht in Ihren Trainingsdokumenten enthalten sind.	true
dataset	{DATASET}	Informationen über die Aufteilung Ihrer Daten in einen Test- und einen Trainingssatz finden Sie unter Trainieren eines Modells. Mögliche Werte für dieses Feld sind Train und Test.	Train

Nach einer erfolgreichen Anforderung enthält die API-Antwort einen operation-location-Header mit einer URL, mit der Sie den Status des Importauftrags überprüfen können. Sie hat folgendes Format:

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

Exportiert ein Projekt

Language Studio

Sie können ein Conversational Language Understanding-Projekt jederzeit als JSON-Datei exportieren, indem Sie zur Seite mit den Unterhaltungsprojekten wechseln, ein Projekt auswählen und auf Exportieren drücken.

REST-APIs

Sie können ein Conversational Language Understanding-Projekt jederzeit als JSON-Datei exportieren.

Erstellen Sie eine POST-Anforderung mithilfe der folgenden URL, der Header und des JSON-Texts, um Ihr Projekt zu exportieren.

Anfrage-URL

Verwenden Sie zum Erstellen Ihrer API-Anforderung die folgende URL. Ersetzen Sie die folgenden Platzhalter durch Ihre eigenen Werte.

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

Platzhalter	Wert	Beispiel
{ENDPOINT}	Der Endpunkt für die Authentifizierung Ihrer API-Anforderung.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Der Name für Ihr Projekt. Bei diesem Wert wird die Groß-/Kleinschreibung beachtet.	EmailApp
{API-VERSION}	Dies ist die Version der von Ihnen aufgerufenen API.	2023-04-01

Header

Verwenden Sie den folgenden Header, um Ihre Anforderung zu authentifizieren.

Schlüssel	Wert
Ocp-Apim-Subscription-Key	Der Schlüssel für Ihre Ressource. Wird für die Authentifizierung Ihrer API-Anforderungen verwendet.

Nachdem Sie Ihre API-Anforderung gesendet haben, erhalten Sie eine 202-Antwort, die angibt, dass sie erfolgreich war. Extrahieren Sie in den Antwortheadern den operation-location-Wert. Er weist das folgende Format auf:

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

JOB-ID wird verwendet, um Ihre Anforderung zu identifizieren, da es sich um einen asynchronen Vorgang handelt. Verwenden Sie diese URL, um den exportierten JSON-Projektcode mit derselben Authentifizierungsmethode abzurufen.

Abrufen von CLU-Projektdetails

Language Studio

1. Navigieren Sie in Language Studio zur Seite mit den Projekteinstellungen.

2. Sie können Projektdetails anzeigen.

3. Auf dieser Seite können Sie in den Projekteinstellungen die Projektbeschreibung aktualisieren und das mehrsprachige Dataset aktivieren/deaktivieren.

4. Außerdem können Sie auf dieser Seite den Primärschlüssel der Ressource abrufen.

   

REST-APIs

Wenn Sie Details zum Projekt abrufen möchten, übermitteln Sie mithilfe der folgenden URL und Header eine GET-Anforderung. Ersetzen Sie die Platzhalterwerte durch eigene Werte.

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

Platzhalter	Wert	Beispiel
{ENDPOINT}	Der Endpunkt für die Authentifizierung Ihrer API-Anforderung.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Der Name für Ihr Projekt. Bei diesem Wert wird die Groß-/Kleinschreibung beachtet.	myProject
{API-VERSION}	Dies ist die Version der von Ihnen aufgerufenen API.	2023-04-01

Header

Verwenden Sie den folgenden Header, um Ihre Anforderung zu authentifizieren.

Schlüssel	Wert
Ocp-Apim-Subscription-Key	Der Schlüssel für Ihre Ressource. Wird für die Authentifizierung Ihrer API-Anforderungen verwendet.

Antworttext

Nachdem Sie die Anforderung gesendet haben, erhalten Sie die folgende Antwort.

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

Nachdem Sie Ihre API-Anforderung gesendet haben, erhalten Sie eine Antwort vom Typ 200, die angibt, dass die Anforderung erfolgreich war, sowie den JSON-Antworttext mit Ihren Projektdetails.

Löschen eines Projekts

Language Studio

Wenn Sie Ihr Projekt nicht mehr benötigen, können Sie das Projekt mithilfe von Language Studio löschen. Wählen Sie im linken Navigationsmenü Projekte und das zu löschende Projekt aus und dann im oberen Menü Löschen.

REST-APIs

Wenn Sie Ihr Projekt nicht mehr benötigen, können Sie das Projekt mithilfe von APIs löschen.

Erstellen Sie mithilfe der folgenden URL, der Header und des JSON-Texts eine LÖSCH-Anforderung, um mit dem Löschen eines CLU-Projekts zu beginnen.

Anfrage-URL

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

Platzhalter	Wert	Beispiel
{ENDPOINT}	Der Endpunkt für die Authentifizierung Ihrer API-Anforderung.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Der Name für Ihr Projekt. Bei diesem Wert wird die Groß-/Kleinschreibung beachtet.	myProject
{API-VERSION}	Dies ist die Version der von Ihnen aufgerufenen API.	2023-04-01

Header

Verwenden Sie den folgenden Header, um Ihre Anforderung zu authentifizieren.

Schlüssel	Wert
Ocp-Apim-Subscription-Key	Der Schlüssel für Ihre Ressource. Wird für die Authentifizierung Ihrer API-Anforderungen verwendet.

Nachdem Sie Ihre API-Anforderung gesendet haben, erhalten Sie eine Antwort vom Typ 202, die anzeigt, dass Ihr Projekt erfolgreich gelöscht wurde.

Nächste Schritte

Schemaerstellung