Tworzenie zadania dostrajania funkcji CLU

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

Wymagania wstępne

• Subskrypcja platformy Azure. Jeśli nie masz konta, możesz je utworzyć teraz za darmo.
• Zasób języka sztucznej inteligencji platformy Azure.

Tworzenie zasobu języka

Przed rozpoczęciem korzystania z interpretacji języka konwersacyjnego (CLU) potrzebny jest zasób języka sztucznej inteligencji platformy Azure.

Uwaga

Aby utworzyć zasób języka, musisz mieć przypisaną rolę Właściciel dla grupy 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 Utwórz.

5. Utwórz zasób Language z następującymi informacjami:

   Szczegóły wystąpienia	Wartość wymagana
   Rejon	Jeden z obsługiwanych regionów zasobu Language.
   Nazwisko	Wymagana nazwa zasobu językowego.
   Poziom cenowy	Jedna z obsługiwanych poziomów cenowych dla zasobu językowego.

Tworzenie nowego zasobu językowego z poziomu programu Language Studio

Jeśli po raz pierwszy zalogujesz się, zostanie wyświetlone okno w programie Language Studio , którego można użyć do wybrania istniejącego zasobu języka lub utworzenia nowego. Zasób można również utworzyć, wybierając ikonę ustawień w prawym górnym rogu, wybierając pozycję Zasoby, a następnie wybierając pozycję Utwórz nowy zasób.

Utwórz zasób Language z następującymi informacjami:

Szczegóły wystąpienia	Wartość wymagana
Subskrypcja platformy Azure	Swoją subskrypcję platformy Azure.
Grupa zasobów platformy Azure	Grupa zasobów platformy Azure.
Nazwa zasobu platformy Azure	Nazwa zasobu językowego.
Lokalizacja	Obsługiwane regiony dla zasobu Language.
Poziom cenowy	Obsługiwane warstwy cenowe dla zasobu językowego.

Ważne

• Upewnij się, że włączysz tożsamość zarządzaną podczas tworzenia zasobu językowego.
• 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 oknie Wybierz zasób językowy, które się pojawi, znajdź swoją subskrypcję Azure i wybierz zasób językowy. 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. Przykładem jest Zachodnie stany USA 2.
   Poziom cenowy	Jedna z prawidłowych warstw cenowych zasobu językowego. Aby wypróbować usługę, możesz użyć warstwy Bezpłatna (F0).

   

Tworzenie projektu konwersacji

Po utworzeniu zasobu Language utwórz projekt CLU.

Azure AI Foundry

1. W Language Studio, znajdź sekcję Understand questions and conversational language (Zrozumieć pytania i język konwersacyjny), a następnie wybierz Conversational Language Understanding (Zrozumienie języka konwersacyjnego).

   

2. Po otwarciu strony Projektów Zrozumienia Języka Konwersacyjnego wybierz Utwórz nowy projekt.

   

3. Aby utworzyć nowy projekt, podaj następujące informacje:

   Wartość	Opis
   Nazwisko	Nazwa projektu. Po jego utworzeniu nie można zmienić nazwy.
   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.

4. Po zakończeniu wybierz pozycję Utwórz. Powinna zostać wyświetlona strona docelowa Wprowadzenie dla projektu.

Interfejsy API REST

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

URL żądania

Podczas tworzenia żądania interfejsu API użyj następującego adresu URL. Zastąp wartości zastępcze 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 wrażliwa na wielkość liter.	myProject
{API-VERSION}	Wersja interfejsu API, który wywołujesz.	2023-04-01

Nagłówki

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

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

Ciało

Użyj następującego przykładowego JSON-u jako treść.

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

Klucz	Symbol zastępczy	Wartość	Przykład
projectName	{PROJECT-NAME}	Nazwa projektu. Ta wartość jest wrażliwa na wielkość 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. Po wdrożeniu modelu można wykonywać zapytania dotyczące modelu w dowolnym obsługiwanym języku (niekoniecznie zawarte w dokumentach szkoleniowych). Aby dowiedzieć się więcej o obsłudze wielojęzycznej, zobacz Obsługa języków.	true

Importowanie projektu

Azure AI Foundry

Projekt CLU można wyeksportować jako plik JSON w dowolnym momencie. Na stronie projektów konwersacji wybierz projekt, a następnie w górnym menu wybierz pozycję Eksportuj.

Możesz ponownie zaimportować ten projekt 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 Language Understanding (LUIS), możesz bezpośrednio zaimportować kod JSON aplikacji LUIS do usługi CLU. Tworzy projekt "Konwersacja" ze wszystkimi elementami, które są obecnie dostępne: wypowiedzi, intencje i jednostki uczenia maszynowego. Aby uzyskać więcej informacji, zobacz Migrowanie z usługi Language Understanding (LUIS) do interpretacji języka konwersacyjnego (CLU).

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

Interfejsy API REST

Możesz zaimportować plik JSON CLU do usługi.

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

URL żądania

Podczas tworzenia żądania interfejsu API użyj następującego adresu URL. Zastąp wartości zastępcze 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 importowanym pliku 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 twojego zasobu. Służy do uwierzytelniania żądań interfejsu API.

Ciało

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

Klucz	Symbol zastępczy	Wartość	Przykład
{API-VERSION}	Wersja wywoływanego interfejsu API.	2023-04-01
projectName	{PROJECT-NAME}	Nazwa projektu. Ta wartość jest wrażliwa na wielkość 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 języki, które nie są uwzględnione w dokumentach szkoleniowych.	true
dataset	{DATASET}	Aby uzyskać informacje na temat dzielenia danych między zestaw testowy i treningowy, zobacz Oznacz swoje wypowiedzi w AI Foundry. Możliwe wartości dla tego pola to Train i Test.	Train

Po pomyślnym żądaniu odpowiedź interfejsu API zawiera operation-location nagłówek z adresem URL, którego można użyć do sprawdzenia stanu zadania importu. Nagłówek jest 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

Azure AI Foundry

Projekt CLU można wyeksportować jako plik JSON w dowolnym momencie. Na stronie projekty konwersacji wybierz projekt, a następnie wybierz pozycję Eksportuj.

Interfejsy API REST

Projekt CLU można wyeksportować jako plik JSON w dowolnym momencie.

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

URL żądania

Podczas tworzenia żądania interfejsu API użyj następującego adresu URL. Zastąp wartości zastępcze 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 wrażliwa na wielkość 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 twojego zasobu. Służy do uwierzytelniania żądań interfejsu API.

Po wysłaniu żądania API otrzymasz odpowiedź 202 wskazującą na powodzenie. Wyodrębnij wartość operation-location z nagłówków odpowiedzi. Wartość jest sformatowana 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

Azure AI Foundry

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

2. Przejrzyj szczegóły projektu.

3. Na tej stronie możesz zaktualizować opis projektu i włączyć lub 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 GET żądanie przy użyciu następującego adresu URL i nagłówków. Zastąp wartości zastępcze 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 wrażliwa na wielkość 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 twojego zasobu. Służy do uwierzytelniania żądań interfejsu API.

Ciało 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 200 odpowiedź, która wskazuje powodzenie i zawiera treść odpowiedzi JSON ze szczegółami projektu.

Usuwanie projektu

Azure AI Foundry

Jeśli projekt nie jest już potrzebny, możesz usunąć projekt przy użyciu programu Language Studio. W okienku po lewej stronie wybierz pozycję Projekty, 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 użyć interfejsów API do usunięcia projektu.

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

URL żądania

{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 wrażliwa na wielkość 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 twojego zasobu. Służy do uwierzytelniania żądań interfejsu API.

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

Treści powiązane

• Schemat kompilacji