기술 자료에서 답변 쿼리
기술 자료가 게시되어야 합니다. 게시된 후에는 generateAnswer API를 사용하여 런타임 예측 엔드포인트에서 기술 자료가 쿼리됩니다. 쿼리에는 질문 텍스트 및 기타 설정이 포함되어 QnA Maker가 답변에 가장 적합한 일치 항목을 선택할 수 있습니다.
참고 항목
QnA Maker 서비스가 2025년 3월 31일부로 종료됩니다. 이제 최신 버전의 질문 및 답변 기능이 Azure AI 언어의 일부로 사용할 수 있습니다. 언어 서비스 내의 질문 답변 기능은 질문 답변을 참조하세요. 2022년 10월 1일부터 새로운 QnA Maker 리소스를 만들 수 없습니다. 기존 QnA Maker 기술 자료를 질문 답변으로 마이그레이션하는 방법에 대한 정보는 마이그레이션 가이드를 참조하세요.
QnA Maker에서 사용자 쿼리를 처리하여 가장 적합한 답변을 선택하는 방법
학습되고 게시된 QnA Maker 기술 자료는 GenerateAnswer API에서 봇 또는 다른 클라이언트 애플리케이션의 사용자 쿼리를 수신합니다. 다음 다이어그램에서는 사용자 쿼리를 수신하는 프로세스를 보여줍니다.
Ranker 프로세스
프로세스는 다음 표에 설명되어 있습니다.
| 단계 | 목적 |
|---|---|
| 1 | 클라이언트 애플리케이션이 사용자 쿼리를 GenerateAnswer API로 보냅니다. |
| 2 | QnA Maker가 언어 감지, 맞춤법 검사기 및 단어 분리기를 사용하여 사용자 쿼리를 전처리합니다. |
| 3 | 이러한 전처리는 최상의 검색 결과를 위해 사용자 쿼리를 변경하는 데 사용됩니다. |
| 4 | 이 변경된 쿼리는 top 결과 수를 수신하는 Azure AI Search 인덱스에 전송됩니다. 이러한 결과에 올바른 답변이 없는 경우 top의 값을 약간 늘립니다. 일반적으로 top에 대한 값이 10이면 쿼리의 90%에서 작동합니다. 이 단계에서 Azure Search는 중지 단어를 필터링합니다. |
| 5 | QnA Maker는 구문 및 의미 체계 기반 기능화를 사용하여 사용자 쿼리와 가져온 QnA 결과 간의 유사성을 결정합니다. |
| 6 | 머신에서 학습한 Ranker 모델은 5단계에서 제공하는 다양한 기능을 사용하여 신뢰도 점수와 새 순위를 결정합니다. |
| 7 | 새 결과는 순위대로 클라이언트 애플리케이션에 반환됩니다. |
사용되는 기능에는 단어 수준 의미 체계, 모음의 용어 수준 중요도, 두 텍스트 문자열 간의 유사성과 관련성을 확인하기 위한 딥 러닝 의미 체계 모델이 포함되지만 이에 국한되지 않습니다.
엔드포인트를 사용하여 HTTP 요청 및 응답
지식 기반을 게시할 때 서비스는 애플리케이션, 일반적으로 챗봇에 통합할 수 있는 REST 기반 HTTP 엔드포인트를 만듭니다.
답변을 생성하는 사용자 쿼리 요청
사용자 쿼리는 기술 자료에 대한 최종 사용자의 질문입니다(예: How do I add a collaborator to my app?). 쿼리가 자연어 형식이거나 질문을 나타내는 몇 개의 키워드인 경우도 있습니다(예: help with collaborators). 클라이언트 애플리케이션의 HTTP 요청에서 기술 자료로 쿼리를 보냅니다.
{
"question": "How do I add a collaborator to my app?",
"top": 6,
"isTest": true,
"scoreThreshold": 20,
"strictFilters": [
{
"name": "QuestionType",
"value": "Support"
}],
"userId": "sd53lsY="
}
scoreThreshold, top, strictFilters 등의 속성을 설정하여 응답을 제어합니다.
대화 컨텍스트를 멀티 턴 기능과 함께 사용하여 질문 및 답변을 구체화하는 대화를 유지하고 정확한 최종 답변을 찾을 수 있습니다.
답변을 생성하는 호출의 응답
HTTP 응답은 지정된 사용자 쿼리에 가장 잘 일치하는 항목을 기반으로 기술 자료에서 검색된 답변입니다. 응답에는 답변 및 예측 점수가 포함됩니다. top 속성을 사용하여 둘 이상의 최고 답변을 요청하는 경우 각각 점수가 있는 두 개 이상의 최고 답변을 얻을 수 있습니다.
{
"answers": [
{
"questions": [
"How do I add a collaborator to my app?",
"What access control is provided for the app?",
"How do I find user management and security?"
],
"answer": "Use the Azure portal to add a collaborator using Access Control (IAM)",
"score": 100,
"id": 1,
"source": "Editorial",
"metadata": [
{
"name": "QuestionType",
"value": "Support"
},
{
"name": "ToolDependency",
"value": "Azure Portal"
}
]
}
]
}