먼저 리소스 키와 엔드포인트를 가져와야 합니다.
Azure Portal에서 리소스 개요 페이지로 이동합니다. 왼쪽 메뉴에서 키 및 엔드포인트를 선택합니다. API 요청에 엔드포인트와 키를 사용합니다.
모델 쿼리
다음 URL, 헤더 및 JSON 본문을 사용하여 POST 요청을 만들어 대화형 Language Understanding 모델 테스트를 시작합니다.
요청 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": {
"id": "1",
"participantId": "1",
"text": "Text 1"
}
},
"parameters": {
"projectName": "{PROJECT-NAME}",
"deploymentName": "{DEPLOYMENT-NAME}",
"stringIndexType": "TextElement_V8"
}
}
| 키 |
자리 표시자 |
값 |
예제 |
participantId |
{JOB-NAME} |
|
"MyJobName |
id |
{JOB-NAME} |
|
"MyJobName |
text |
{TEST-UTTERANCE} |
의도를 예측하고 엔터티를 추출하려는 발화입니다. |
"Read Matt's email |
projectName |
{PROJECT-NAME} |
프로젝트의 이름입니다. 이 값은 대/소문자를 구분합니다. |
myProject |
deploymentName |
{DEPLOYMENT-NAME} |
배포의 이름입니다. 이 값은 대/소문자를 구분합니다. |
staging |
요청을 보내면 예측에 대해 다음과 같은 응답을 받게 됩니다.
응답 본문
{
"kind": "ConversationResult",
"result": {
"query": "Text1",
"prediction": {
"topIntent": "inten1",
"projectKind": "Conversation",
"intents": [
{
"category": "intent1",
"confidenceScore": 1
},
{
"category": "intent2",
"confidenceScore": 0
},
{
"category": "intent3",
"confidenceScore": 0
}
],
"entities": [
{
"category": "entity1",
"text": "text1",
"offset": 29,
"length": 12,
"confidenceScore": 1
}
]
}
}
}
| 키 |
샘플 값 |
설명 |
| query |
“Matt의 메일 읽기” |
쿼리를 위해 제출한 텍스트입니다. |
| topIntent |
“읽기” |
신뢰도 점수가 가장 높은 예측 의도입니다. |
| 의도 |
[] |
쿼리 텍스트에 대해 예측된 모든 의도 목록과 각각의 신뢰도 점수입니다. |
| 엔터티 |
[] |
쿼리 텍스트에서 추출된 엔터티 목록을 포함하는 배열입니다. |
대화 프로젝트에 대한 API 응답
대화 프로젝트에서는 프로젝트 내에 있는 의도와 엔터티 모두에 대한 예측을 얻을 수 있습니다.
- 의도 및 엔터티에는 모델에서 프로젝트의 특정 요소를 예측하는 것과 관련하여 0.0~1.0 사이의 신뢰도 점수가 포함됩니다.
- 상위 채점 의도가 자체 매개 변수 내에 포함되어 있습니다.
- 예측된 엔터티만 응답에 표시됩니다.
- 엔터티는 다음을 표시합니다.
- 추출된 엔터티의 텍스트입니다.
- 오프셋 값으로 표시되는 시작 위치
- 길이 값으로 표시되는 엔터티 텍스트의 길이입니다.
