다음을 통해 공유


배포에서 의도 예측 쿼리

배포가 성공적으로 추가되면 배포에 할당한 모델을 기준으로 하는 발화의 의도 및 엔터티 예측에 대해 배포를 쿼리할 수 있습니다. 예측 API 또는 클라이언트 라이브러리(Azure SDK)를 통해 프로그래밍 방식으로 배포를 쿼리할 수 있습니다.

배포된 모델 테스트

먼저 리소스 키와 엔드포인트를 가져와야 합니다.

Azure Portal에서 리소스 개요 페이지로 이동합니다. 왼쪽 메뉴에서 키 및 엔드포인트를 선택합니다. API 요청에 엔드포인트와 키를 사용합니다.

Azure Portal의 키 및 엔드포인트 페이지를 보여주는 스크린샷.

모델 쿼리

다음 URL, 헤더 및 JSON 본문을 사용하여 POST 요청을 만들어 오케스트레이션 워크플로 모델 테스트를 시작합니다.

요청 URL

{ENDPOINT}/language/:analyze-conversations?api-version={API-VERSION}
자리 표시자 예제
{ENDPOINT} API 요청을 인증하기 위한 엔드포인트입니다. https://<your-custom-subdomain>.cognitiveservices.azure.com
{API-VERSION} 호출하는 API 의 버전 입니다. 2023-04-01

헤더

다음 헤더를 사용하여 요청을 인증합니다.

Ocp-Apim-Subscription-Key 리소스의 키입니다. API 요청을 인증하는 데 사용됩니다.

요청 본문

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

응답 본문

요청을 보내면 예측에 대해 다음과 같은 응답을 받습니다.

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

먼저 리소스 키와 엔드포인트를 가져와야 합니다.

Azure Portal에서 리소스 개요 페이지로 이동합니다. 왼쪽 메뉴에서 키 및 엔드포인트를 선택합니다. API 요청에 엔드포인트와 키를 사용합니다.

Azure Portal의 키 및 엔드포인트 페이지를 보여주는 스크린샷.

클라이언트 라이브러리 사용(Azure SDK)

Azure SDK에서 제공하는 클라이언트 라이브러리를 사용하여 모델에 요청을 보낼 수도 있습니다.

참고 항목

대화 언어 이해를 위한 클라이언트 라이브러리는 다음에 대해서만 사용할 수 있습니다.

  • .NET
  • Python
  1. Azure Portal에서 스토리지 계정 개요 페이지로 이동합니다.

  2. 왼쪽 메뉴에서 키 및 엔드포인트를 선택합니다. API 요청에 대한 엔드포인트를 사용합니다. 이 경우 Ocp-Apim-Subscription-Key 헤더에 대한 키가 필요합니다.

    Azure 엔드포인트를 가져오는 방법을 보여 주는 스크린샷

  3. 선택한 언어에 대한 클라이언트 라이브러리 패키지를 다운로드하여 설치합니다.

    언어 패키지 버전
    .NET 1.0.0
    Python 1.0.0
  4. 클라이언트 라이브러리를 설치한 후 GitHub에서 다음 샘플을 사용하여 API 호출을 시작합니다.

  5. 자세한 내용은 다음 참조 설명서를 참조하세요.

다음 단계