Jak utworzyć projekt CLU

Skorzystaj z tego artykułu, aby dowiedzieć się, jak skonfigurować te wymagania i utworzyć projekt.

Wymagania wstępne

Przed rozpoczęciem korzystania z funkcji CLU potrzebne będzie kilka rzeczy:

• Subskrypcja platformy Azure — utwórz bezpłatnie.
• Zasób języka sztucznej inteligencji platformy Azure

Tworzenie zasobu języka

Przed rozpoczęciem korzystania z usługi CLU potrzebny będzie zasób języka sztucznej inteligencji platformy Azure.

Uwaga

• Aby utworzyć zasób języka, musisz mieć przypisaną rolę właściciela w grupie zasobów.

Tworzenie nowego zasobu w witrynie Azure Portal

1. Zaloguj się do witryny Azure Portal , aby utworzyć nowy zasób języka AI platformy Azure.

2. Wybierz pozycję Utwórz nowy zasób

3. W wyświetlonym oknie wyszukaj pozycję Usługa językowa

4. Wybierz pozycję Utwórz

5. Utwórz zasób języka, postępując zgodnie z poniższymi szczegółami.

   Szczegóły wystąpienia	Wartość wymagana
   Region	Jeden z obsługiwanych regionów zasobu Language.
   Nazwisko	Wymagana nazwa zasobu language
   Warstwa cenowa	Jedna z obsługiwanych warstw cenowych dla zasobu Język.

Tworzenie nowego zasobu językowego z poziomu programu Language Studio

Jeśli po raz pierwszy się zalogujesz, zostanie wyświetlone okno w programie Language Studio , które pozwoli wybrać istniejący zasób języka lub utworzyć nowy. Zasób można również utworzyć, klikając ikonę ustawień w prawym górnym rogu, wybierając pozycję Zasoby, a następnie klikając pozycję Utwórz nowy zasób.

Utwórz zasób języka, postępując zgodnie z poniższymi szczegółami.

Szczegóły wystąpienia	Wartość wymagana
Subskrypcja platformy Azure	Subskrypcja platformy Azure
Grupa zasobów platformy Azure	Grupa zasobów platformy Azure
Nazwa zasobu platformy Azure	Nazwa zasobu language
Lokalizacja	Obsługiwane regiony dla zasobu Language.
Warstwa cenowa	Obsługiwane warstwy cenowe dla zasobu Language.

Ważne

• Pamiętaj, aby włączyć tożsamość zarządzaną podczas tworzenia zasobu language.
• Przeczytaj i potwierdź powiadomienie o odpowiedzialnej sztucznej inteligencji

Zaloguj się do programu Language Studio

1. Przejdź do programu Language Studio i zaloguj się przy użyciu konta platformy Azure.

2. W wyświetlonym oknie Wybierz zasób języka znajdź subskrypcję platformy Azure i wybierz zasób Język. Jeśli nie masz zasobu, możesz utworzyć nowy.

   Szczegóły wystąpienia	Wartość wymagana
   Subskrypcja platformy Azure	Swoją subskrypcję platformy Azure.
   Grupa zasobów platformy Azure	Nazwa grupy zasobów platformy Azure.
   Nazwa zasobu platformy Azure	Nazwa zasobu platformy Azure.
   Lokalizacja	Jeden z obsługiwanych regionów zasobu Language. Na przykład "Zachodnie stany USA 2".
   Warstwa cenowa	Jedna z prawidłowych warstw cenowych zasobu Language. Aby wypróbować usługę, możesz użyć warstwy Bezpłatna (F0).

   

Tworzenie projektu konwersacji

Po utworzeniu zasobu Language utwórz projekt Conversational Language Understanding.

Language Studio

1. W programie Language Studio znajdź sekcję o nazwie Understand questions and conversational language (Informacje o pytaniach i języku konwersacyjnym), a następnie wybierz pozycję Conversational language understanding (Interpretacja języka konwersacji).
   

2. Spowoduje to wyświetlenie strony projektów interpretacji języka konwersacji. Wybierz pozycję Utwórz nowy projekt.

   

Aby utworzyć nowy projekt, należy podać następujące szczegóły:

Wartość	Opis
Nazwa/nazwisko	Nazwa projektu. Po utworzeniu nie można go zmienić
opis	Opcjonalny opis projektu.
Wypowiedź języka podstawowego	Podstawowy język projektu. Dane szkoleniowe powinny znajdować się głównie w tym języku.
Włączanie wielu języków	Czy chcesz umożliwić projektowi obsługę wielu języków jednocześnie.

Po zakończeniu wybierz pozycję Dalej i przejrzyj szczegóły. Wybierz pozycję Utwórz , aby ukończyć proces. W projekcie powinien zostać wyświetlony ekran Build Schema (Schemat kompilacji).

Interfejsy API REST

Prześlij żądanie PATCH przy użyciu następującego adresu URL, nagłówków i treści JSON, aby utworzyć nowy projekt.

Zażądaj URL

Podczas tworzenia żądania interfejsu API użyj następującego adresu URL. Zastąp poniższe wartości symboli zastępczych własnymi wartościami.

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

Symbol zastępczy	Wartość	Przykład
{ENDPOINT}	Punkt końcowy do uwierzytelniania żądania interfejsu API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nazwa projektu. Ta wartość jest uwzględniana w wielkości liter.	myProject
{API-VERSION}	Wersja wywoływanego interfejsu API.	2023-04-01

Nagłówki

Użyj następującego nagłówka, aby uwierzytelnić żądanie.

Klucz	Wartość
Ocp-Apim-Subscription-Key	Klucz do zasobu. Służy do uwierzytelniania żądań interfejsu API.
Content-Type	"application/merge-patch+json"

Treść

Użyj następującego przykładowego kodu JSON jako treści.

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

Key	Symbol zastępczy	Wartość	Przykład
projectName	{PROJECT-NAME}	Nazwa projektu. Ta wartość jest uwzględniana w wielkości liter.	EmailApp
language	{LANGUAGE-CODE}	Ciąg określający kod języka wypowiedzi używanych w projekcie. Jeśli projekt jest projektem wielojęzycznym, wybierz kod języka większości wypowiedzi.	en-us
multilingual	true	Wartość logiczna, która umożliwia posiadanie dokumentów w wielu językach w zestawie danych, a po wdrożeniu modelu można wykonywać zapytania dotyczące modelu w dowolnym obsługiwanym języku (niekoniecznie zawarte w dokumentach szkoleniowych). Zobacz Obsługa języków, aby dowiedzieć się więcej o obsłudze wielojęzycznej.	true

Importowanie projektu

Language Studio

Projekt usługi Conversational Language Understanding można wyeksportować w dowolnym momencie jako plik JSON, przechodząc do strony projektów konwersacji, wybierając projekt i z górnego menu, klikając pozycję Eksportuj.

Ten projekt można ponownie zaimportować jako nowy projekt. Jeśli zaimportujesz projekt o dokładnie takiej samej nazwie, zastąpi dane projektu danymi nowo zaimportowanego projektu.

Jeśli masz istniejącą aplikację usługi LUIS, możesz zaimportować kod JSON aplikacji LUIS do usługi Conversational Language Understanding bezpośrednio i utworzy projekt Konwersacja ze wszystkimi dostępnymi elementami: Intents, ML entities and utterances (Intencje, jednostki uczenia maszynowego i wypowiedzi). Aby uzyskać więcej informacji, zobacz artykuł migracji usługi LUIS.

Aby zaimportować projekt, wybierz przycisk strzałki obok pozycji Utwórz nowy projekt i wybierz pozycję Importuj, a następnie wybierz plik JSON usługi LUIS lub Conversational Language Understanding.

Interfejsy API REST

Kod JSON clu można zaimportować do usługi

Prześlij żądanie POST przy użyciu następującego adresu URL, nagłówków i treści JSON, aby zaimportować projekt.

Zażądaj URL

Podczas tworzenia żądania interfejsu API użyj następującego adresu URL. Zastąp wartości symboli zastępczych własnymi wartościami.

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

Symbol zastępczy	Wartość	Przykład
{ENDPOINT}	Punkt końcowy do uwierzytelniania żądania interfejsu API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nazwa projektu. Ta wartość uwzględnia wielkość liter i musi być zgodna z nazwą projektu w importowanych plikach JSON.	EmailAppDemo
{API-VERSION}	Wersja wywoływanego interfejsu API.	2023-04-01

Nagłówki

Użyj następującego nagłówka, aby uwierzytelnić żądanie.

Klucz	Wartość
Ocp-Apim-Subscription-Key	Klucz do zasobu. Służy do uwierzytelniania żądań interfejsu API.

Treść

Treść wysyłanego kodu JSON jest podobna do poniższego przykładu. Aby uzyskać więcej informacji na temat obiektu JSON, zobacz dokumentację referencyjną.

{
  "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	Symbol zastępczy	Wartość	Przykład
{API-VERSION}	Wersja wywoływanego interfejsu API.	2023-04-01
projectName	{PROJECT-NAME}	Nazwa projektu. Ta wartość jest uwzględniana w wielkości liter.	EmailAppDemo
language	{LANGUAGE-CODE}	Ciąg określający kod języka wypowiedzi używanych w projekcie. Jeśli projekt jest projektem wielojęzycznym, wybierz kod języka większości wypowiedzi.	en-us
multilingual	true	Wartość logiczna, która umożliwia posiadanie dokumentów w wielu językach w zestawie danych. Po wdrożeniu modelu można wykonywać zapytania dotyczące modelu w dowolnym obsługiwanym języku , w tym w językach, które nie są uwzględnione w dokumentach szkoleniowych.	true
dataset	{DATASET}	Zobacz , jak wytrenować model , aby uzyskać informacje na temat dzielenia danych między zestaw testowy i treningowy. Możliwe wartości dla tego pola to Train i Test.	Train

Po pomyślnym żądaniu odpowiedź interfejsu API będzie zawierać operation-location nagłówek z adresem URL, którego można użyć do sprawdzenia stanu zadania importu. Jest on sformatowany w następujący sposób:

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

Eksportowanie projektu

Language Studio

Projekt usługi Conversational Language Understanding można wyeksportować w dowolnym momencie jako plik JSON, przechodząc do strony projektów konwersacji, wybierając projekt i naciskając pozycję Eksportuj.

Interfejsy API REST

W dowolnym momencie możesz wyeksportować projekt usługi Conversational Language Understanding jako plik JSON.

Utwórz żądanie POST przy użyciu następującego adresu URL, nagłówków i treści JSON w celu wyeksportowania projektu.

Zażądaj URL

Podczas tworzenia żądania interfejsu API użyj następującego adresu URL. Zastąp poniższe wartości symboli zastępczych własnymi wartościami.

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

Symbol zastępczy	Wartość	Przykład
{ENDPOINT}	Punkt końcowy do uwierzytelniania żądania interfejsu API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nazwa projektu. Ta wartość jest uwzględniana w wielkości liter.	EmailApp
{API-VERSION}	Wersja wywoływanego interfejsu API.	2023-04-01

Nagłówki

Użyj następującego nagłówka, aby uwierzytelnić żądanie.

Klucz	Wartość
Ocp-Apim-Subscription-Key	Klucz do zasobu. Służy do uwierzytelniania żądań interfejsu API.

Po wysłaniu żądania interfejsu API otrzymasz odpowiedź wskazującą 202 powodzenie. W nagłówkach odpowiedzi wyodrębnij operation-location wartość. Zostanie on sformatowany w następujący sposób:

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

JOB-ID służy do identyfikowania żądania, ponieważ ta operacja jest asynchroniczna. Użyj tego adresu URL, aby pobrać wyeksportowany kod JSON projektu przy użyciu tej samej metody uwierzytelniania.

Uzyskiwanie szczegółów projektu CLU

Language Studio

1. Przejdź do strony ustawień projektu w programie Language Studio.

2. Możesz wyświetlić szczegóły projektu.

3. Na tej stronie można zaktualizować opis projektu i włączyć/wyłączyć wielojęzyczny zestaw danych w ustawieniach projektu.

4. Możesz również pobrać klucz podstawowy zasobu z tej strony.

   

Interfejsy API REST

Aby uzyskać szczegóły projektu, prześlij żądanie GET przy użyciu następującego adresu URL i nagłówków. Zastąp wartości symboli zastępczych własnymi wartościami.

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

Symbol zastępczy	Wartość	Przykład
{ENDPOINT}	Punkt końcowy do uwierzytelniania żądania interfejsu API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nazwa projektu. Ta wartość jest uwzględniana w wielkości liter.	myProject
{API-VERSION}	Wersja wywoływanego interfejsu API.	2023-04-01

Nagłówki

Użyj następującego nagłówka, aby uwierzytelnić żądanie.

Klucz	Wartość
Ocp-Apim-Subscription-Key	Klucz do zasobu. Służy do uwierzytelniania żądań interfejsu API.

Treść odpowiedzi

Po wysłaniu żądania otrzymasz następującą odpowiedź.

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

Po wysłaniu żądania interfejsu API otrzymasz odpowiedź wskazującą 200 powodzenie i treść odpowiedzi JSON ze szczegółami projektu.

Usuwanie projektu

Language Studio

Jeśli projekt nie jest już potrzebny, możesz usunąć projekt przy użyciu programu Language Studio. Wybierz pozycję Projekty z menu nawigacji po lewej stronie, wybierz projekt, który chcesz usunąć, a następnie wybierz pozycję Usuń z górnego menu.

Interfejsy API REST

Jeśli projekt nie jest już potrzebny, możesz usunąć projekt przy użyciu interfejsów API.

Utwórz żądanie DELETE przy użyciu następującego adresu URL, nagłówków i treści JSON, aby usunąć projekt interpretacji języka konwersacji.

Zażądaj URL

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

Symbol zastępczy	Wartość	Przykład
{ENDPOINT}	Punkt końcowy do uwierzytelniania żądania interfejsu API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nazwa projektu. Ta wartość jest uwzględniana w wielkości liter.	myProject
{API-VERSION}	Wersja wywoływanego interfejsu API.	2023-04-01

Nagłówki

Użyj następującego nagłówka, aby uwierzytelnić żądanie.

Klucz	Wartość
Ocp-Apim-Subscription-Key	Klucz do zasobu. Służy do uwierzytelniania żądań interfejsu API.

Po wysłaniu żądania interfejsu API otrzymasz odpowiedź wskazującą 202 powodzenie, co oznacza, że projekt został usunięty.

Następne kroki

Schemat kompilacji