Jak tworzyć projekty w przepływie pracy orkiestracji

Artykuł
11/21/2024

Przepływ pracy orkiestracji umożliwia tworzenie projektów łączących aplikacje z:

Usługa Custom Language Understanding
Odpowiadanie na pytania
LUIS

Wymagania wstępne

Przed rozpoczęciem korzystania z przepływu pracy orkiestracji 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 przepływu pracy orkiestracji 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.
Jeśli planujesz użyć odpowiedzi na pytania, musisz włączyć odpowiadanie na pytania podczas tworzenia zasobów

Tworzenie nowego zasobu w witrynie Azure Portal

Przejdź do witryny Azure Portal, aby utworzyć nowy zasób języka sztucznej inteligencji platformy Azure.
Wybierz pozycję Kontynuuj, aby utworzyć zasób
Utwórz zasób języka, postępując zgodnie z poniższymi szczegółami.

Szczegóły wystąpienia Wartość wymagana

Region (Region) Jeden z obsługiwanych regionów.

Nazwisko Nazwa zasobu Language.

Warstwa cenowa Jedna z obsługiwanych warstw cenowych.

Szczegóły wystąpienia	Wartość wymagana
Region (Region)	Jeden z obsługiwanych regionów.
Nazwisko	Nazwa zasobu Language.
Warstwa cenowa	Jedna z obsługiwanych warstw cenowych.

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 platformy Azure
Lokalizacja	Dowiedz się więcej o obsługiwanych regionach.
Warstwa cenowa	Dowiedz się więcej o obsługiwanych warstwach cenowych.

Ważne

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

Aby utworzyć nową intencję, wybierz przycisk +Dodaj i zacznij od nadania intencji nazwy. Zobaczysz dwie opcje, aby nawiązać połączenie z projektem. Możesz nawiązać połączenie z projektami (LUIS, odpowiedzi na pytania lub usługi Conversational Language Understanding) lub wybrać opcję braku .

Tworzenie projektu przepływu pracy orkiestracji

Po utworzeniu zasobu Language utwórz projekt przepływu pracy aranżacji.

Language Studio
Interfejsy API REST

W usłudze Language Studio znajdź sekcję z etykietą Understand questions and conversational language (Informacje o pytaniach i języku konwersacyjnym), a następnie wybierz pozycję Orchestration Workflow (Przepływ pracy orkiestracji).
Spowoduje to wyświetlenie strony projektu przepływu pracy orkiestracji. Wybierz pozycję Utwórz nowy projekt. Aby utworzyć projekt, należy podać następujące szczegóły:

Wartość	Opis
Nazwa/nazwisko	Nazwa projektu.
opis	Opcjonalny opis projektu.
Wypowiedź języka podstawowego	Podstawowy język projektu. Dane szkoleniowe powinny znajdować się głównie w tym języku.

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

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

Adres URL żądania

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.

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

Treść

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

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "Orchestration",
  "description": "Project description"
 }

Klucz	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`

Importowanie projektu przepływu pracy orkiestracji

Language Studio
Interfejsy API REST

Projekt przepływu pracy orkiestracji można wyeksportować jako plik JSON w dowolnym momencie, przechodząc do strony projektów przepływu pracy aranżacji, wybierając projekt, a następnie w górnym 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.

Aby zaimportować projekt, wybierz przycisk strzałki obok pozycji Utwórz nowy projekt i wybierz pozycję Importuj, a następnie wybierz plik JSON.

Plik JSON przepływu pracy orkiestracji 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.

Adres URL żądania

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}/: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ść 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.

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

Treść

Uwaga

Każda intencja powinna być tylko z jednego typu (CLU, LUIS i qna)

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

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectKind": "Orchestration",
    "settings": {
      "confidenceThreshold": 0
    },
    "projectName": "{PROJECT-NAME}",
    "description": "Project description",
    "language": "{LANGUAGE-CODE}"
  },
  "assets": {
    "projectKind": "Orchestration",
    "intents": [
      {
        "category": "string",
        "orchestration": {
          "kind": "luis",
          "luisOrchestration": {
            "appId": "00001111-aaaa-2222-bbbb-3333cccc4444",
            "appVersion": "string",
            "slotName": "string"
          },
          "cluOrchestration": {
            "projectName": "string",
            "deploymentName": "string"
          },
          "qnaOrchestration": {
            "projectName": "string"
          }
        }
      }
    ],
    "utterances": [
      {
        "text": "Trying orchestration",
        "language": "{LANGUAGE-CODE}",
        "intent": "string"
      }
    ]
  }
}

Klucz	Symbol zastępczy	Wartość	Przykład
`api-version`	`{API-VERSION}`	Wersja wywoływanego interfejsu API. Używana tutaj wersja musi być tą samą wersją interfejsu API w adresie URL.	`2022-03-01-preview`
`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`

Projekt przepływu pracy orkiestracji można wyeksportować w dowolnym momencie jako plik JSON, przechodząc do strony projektów przepływu pracy aranżacji, wybierając projekt i naciskając pozycję Eksportuj.

Projekt przepływu pracy aranżacji można wyeksportować jako plik JSON w dowolnym momencie.

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

Adres URL żądania

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.

Key	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 aranżacji

Language Studio
Interfejsy API REST

Przejdź do strony ustawień projektu w programie Language Studio.
Możesz wyświetlić szczegóły projektu.
Na tej stronie można zaktualizować opis projektu.
Możesz również pobrać klucz podstawowy zasobu z tej strony.

Aby uzyskać szczegóły projektu przepływu pracy aranżacji, 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.

Key	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": "Orchestration",
  "projectName": "{PROJECT-NAME}",
  "description": "This is a sample orchestration 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
Interfejsy API REST

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.

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.

Adres 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 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.

Key	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

Udostępnij za pośrednictwem

Jak tworzyć projekty w przepływie pracy orkiestracji

Wymagania wstępne

Tworzenie zasobu języka

Tworzenie nowego zasobu w witrynie Azure Portal

Tworzenie nowego zasobu językowego z poziomu programu Language Studio

Tworzenie projektu przepływu pracy orkiestracji

Adres URL żądania

Nagłówki

Treść

Importowanie projektu przepływu pracy orkiestracji

Adres URL żądania

Nagłówki

Treść

Eksportowanie projektu

Adres URL żądania

Nagłówki

Uzyskiwanie szczegółów projektu aranżacji

Nagłówki

Treść odpowiedzi

Usuwanie projektu

Adres URL żądania

Nagłówki

Następne kroki

Opinia

Dodatkowe zasoby

Udostępnij za pośrednictwem

Jak tworzyć projekty w przepływie pracy orkiestracji

Wymagania wstępne

Tworzenie zasobu języka

Tworzenie nowego zasobu w witrynie Azure Portal

Tworzenie nowego zasobu językowego z poziomu programu Language Studio

Zaloguj się do programu Language Studio

Tworzenie projektu przepływu pracy orkiestracji

Importowanie projektu przepływu pracy orkiestracji

Eksportowanie projektu

Uzyskiwanie szczegółów projektu aranżacji

Usuwanie projektu

Następne kroki

Opinia

Dodatkowe zasoby