Wdrażanie zapytań dla przewidywań intencji

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

Testowanie wdrożonego modelu

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

Aby przetestować model z poziomu programu 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 powinna zostać wyświetlona odpowiedź modelu w wyniku. Wyniki można wyświetlić w widoku kart jednostek lub wyświetlić je w formacie JSON.

   

---

Wysyłanie żądania przepływu pracy orkiestracji

Language Studio

1. Po pomyślnym ukończeniu zadania wdrażania 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 wysyłać 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 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 orkiestracji.

Adres URL żądania

{ENDPOINT}/language/:analyze-conversations?api-version={API-VERSION}

Symbol zastępczy	Wartość	Przykład
{ENDPOINT}	Punkt końcowy 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.

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

Do wysyłania żądań do modelu można również użyć bibliotek klienckich dostarczonych przez zestaw Azure SDK.

Uwaga

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

• .NET
• Python

1. Przejdź do strony przeglądu zasobu w 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