Wdrażanie zapytań dla przewidywań intencji

Po pomyślnym dodaniu wdrożenia można wykonać zapytanie dotyczące wdrożenia pod kątem przewidywań intencji i jednostek z wypowiedzi na podstawie modelu przypisanego do wdrożenia. Możesz wykonywać zapytania dotyczące interfejsu API przewidywania programowego wdrożenia lub za pomocą bibliotek klienckich (Azure SDK).

Test wdrożony model

Program Language Studio umożliwia przesyłanie wypowiedzi, uzyskiwanie przewidywań i wizualizowanie wyników.

Aby przetestować model w programie Language Studio

1. Wybierz pozycję Testowanie wdrożeń z menu po lewej stronie.

2. Wybierz model, który chcesz przetestować. Można testować tylko modele przypisane do wdrożeń.

3. Z listy rozwijanej Nazwa wdrożenia wybierz nazwę wdrożenia.

4. W polu tekstowym wprowadź wypowiedź do przetestowania.

5. W górnym menu wybierz pozycję Uruchom test.

6. Po uruchomieniu testu w wyniku powinna zostać wyświetlona odpowiedź modelu. Wyniki można wyświetlić w widoku kart jednostek lub wyświetlić w formacie JSON.

   

---

Wysyłanie żądania przepływu pracy orkiestracji

Language Studio

1. Po pomyślnym zakończeniu zadania wdrożenia wybierz wdrożenie, którego chcesz użyć, a następnie z górnego menu wybierz pozycję Pobierz adres URL przewidywania.

   

2. W wyświetlonym oknie skopiuj przykładowy adres URL żądania i treść do wiersza polecenia. Zastąp <YOUR_QUERY_HERE> element rzeczywistym tekstem, z którego chcesz wysłać, aby wyodrębnić intencje i jednostki.

3. POST Prześlij żądanie cURL w terminalu lub wierszu polecenia. Jeśli żądanie zakończyło się pomyślnie, otrzymasz odpowiedź 202 z wynikami interfejsu API.

Interfejsy API REST

Najpierw musisz uzyskać klucz zasobu i punkt końcowy:

Przejdź do strony przeglądu zasobu w witrynie Azure Portal. Z menu po lewej stronie wybierz pozycję Klucze i punkt końcowy. Użyjesz punktu końcowego i klucza dla żądań interfejsu API.

Wykonywanie zapytań względem modelu

Utwórz żądanie POST przy użyciu następującego adresu URL, nagłówków i treści JSON, aby rozpocząć testowanie modelu przepływu pracy aranżacji.

Adres URL żądania

{ENDPOINT}/language/:analyze-conversations?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
{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ść żądania

{
  "kind": "Conversation",
  "analysisInput": {
    "conversationItem": {
      "text": "Text1",
      "participantId": "1",
      "id": "1"
    }
  },
  "parameters": {
    "projectName": "{PROJECT-NAME}",
    "deploymentName": "{DEPLOYMENT-NAME}",
    "directTarget": "qnaProject",
    "targetProjectParameters": {
      "qnaProject": {
        "targetProjectKind": "QuestionAnswering",
        "callingOptions": {
          "context": {
            "previousUserQuery": "Meet Surface Pro 4",
            "previousQnaId": 4
          },
          "top": 1,
          "question": "App Service overview"
        }
      }
    }
  }
}

Treść odpowiedzi

Po wysłaniu żądania otrzymasz następującą odpowiedź na przewidywanie!

{
  "kind": "ConversationResult",
  "result": {
    "query": "App Service overview",
    "prediction": {
      "projectKind": "Orchestration",
      "topIntent": "qnaTargetApp",
      "intents": {
        "qnaTargetApp": {
          "targetProjectKind": "QuestionAnswering",
          "confidenceScore": 1,
          "result": {
            "answers": [
              {
                "questions": [
                  "App Service overview"
                ],
                "answer": "The compute resources you use are determined by the *App Service plan* that you run your apps on.",
                "confidenceScore": 0.7384000000000001,
                "id": 1,
                "source": "https://learn.microsoft.com/azure/app-service/overview",
                "metadata": {},
                "dialog": {
                  "isContextOnly": false,
                  "prompts": []
                }
              }
            ]
          }
        }
      }
    }
  }
}

Biblioteki klienta (zestaw Azure SDK)

Najpierw musisz uzyskać klucz zasobu i punkt końcowy:

Przejdź do strony przeglądu zasobu w witrynie Azure Portal. Z menu po lewej stronie wybierz pozycję Klucze i punkt końcowy. Użyjesz punktu końcowego i klucza dla żądań interfejsu API.

Korzystanie z bibliotek klienckich (Azure SDK)

Możesz również użyć bibliotek klienckich udostępnianych przez zestaw Azure SDK do wysyłania żądań do modelu.

Uwaga

Biblioteka kliencka do interpretacji języka konwersacyjnego jest dostępna tylko w następujących celach:

• .NET
• Python

1. Przejdź do strony przeglądu zasobu w witrynie Azure Portal

2. Z menu po lewej stronie wybierz pozycję Klucze i punkt końcowy. Użyj punktu końcowego dla żądań interfejsu API i będziesz potrzebować klucza nagłówka Ocp-Apim-Subscription-Key .

   

3. Pobierz i zainstaluj pakiet biblioteki klienta dla wybranego języka:

   Język	Wersja pakietu
   .NET	1.0.0
   Python	1.0.0

4. Po zainstalowaniu biblioteki klienta użyj poniższych przykładów w usłudze GitHub, aby rozpocząć wywoływanie interfejsu API.

   • C#
   • Python

5. Aby uzyskać więcej informacji, zobacz następującą dokumentację referencyjną:

   • C#
   • Python

Następne kroki

• Omówienie przepływu pracy orkiestracji