기술 자료에서 답변 쿼리
기술 자료가 게시되어야 합니다. 게시된 후에는 generateAnswer API를 사용하여 런타임 예측 엔드포인트에서 기술 자료가 쿼리됩니다. 쿼리에는 질문 텍스트 및 기타 설정이 포함되어 QnA Maker가 답변에 가장 적합한 일치 항목을 선택할 수 있습니다.
참고
QnA Maker 서비스가 2025년 3월 31일부로 종료됩니다. 이제 최신 버전의 질문 및 답변 기능이 Azure AI 언어의 일부로 사용할 수 있습니다. 언어 서비스 내의 질문 답변 기능은 질문 답변을 참조하세요. 2022년 10월 1일부터 새로운 QnA Maker 리소스를 만들 수 없습니다. 기존 QnA Maker 기술 자료를 질문 답변으로 마이그레이션하는 방법에 대한 정보는 마이그레이션 가이드를 참조하세요.
학습되고 게시된 QnA Maker 기술 자료는 GenerateAnswer API에서 봇 또는 다른 클라이언트 애플리케이션의 사용자 쿼리를 수신합니다. 다음 다이어그램에서는 사용자 쿼리를 수신하는 프로세스를 보여줍니다.
프로세스는 다음 표에 설명되어 있습니다.
단계 | 목적 |
---|---|
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 | 새 결과는 순위대로 클라이언트 애플리케이션에 반환됩니다. |
사용되는 기능에는 단어 수준 의미 체계, 모음의 용어 수준 중요도, 두 텍스트 문자열 간의 유사성과 관련성을 확인하기 위한 딥 러닝 의미 체계 모델이 포함되지만 이에 국한되지 않습니다.
지식 기반을 게시할 때 서비스는 애플리케이션, 일반적으로 챗봇에 통합할 수 있는 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"
}
]
}
]
}