QnA Maker 문제 해결
QnA Maker 서비스와 관련하여 가장 자주 묻는 질문의 큐레이팅된 목록은 서비스를 더 빠르고 더 나은 결과로 채택하는 데 도움이 됩니다.
참고 항목
QnA Maker 서비스가 2025년 3월 31일부로 종료됩니다. 이제 최신 버전의 질문 및 답변 기능이 Azure AI 언어의 일부로 사용할 수 있습니다. 언어 서비스 내의 질문 답변 기능은 질문 답변을 참조하세요. 2022년 10월 1일부터 새로운 QnA Maker 리소스를 만들 수 없습니다. 기존 QnA Maker 기술 자료를 질문 답변으로 마이그레이션하는 방법에 대한 정보는 마이그레이션 가이드를 참조하세요.
예측 관리
쿼리 예측의 처리량 성능을 향상하려면 어떻게 해야 하나요?
답변: 처리량 성능 문제는 App Service와 Cognitive Search 둘 다에 대해 강화해야 함을 나타냅니다. 성능을 향상시키려면 Cognitive Search에 복제본을 추가하는 것이 좋습니다.
가격 책정 계층에 대한 자세한 정보를 알아봅니다.
QnAMaker 서비스 엔드포인트를 가져오는 방법
답변: QnAMaker 서비스 엔드포인트는 QnAMaker 고객 지원팀 또는 UserVoice에 디버깅에 대해 문의할 때 유용합니다. 엔드포인트는 다음 형식 https://your-resource-name.azurewebsites.net의 URL입니다.
Azure Portal에서 QnAMaker 서비스(리소스 그룹)로 이동합니다.
QnA Maker 리소스와 연결된 App Service를 선택합니다. 일반적으로 이름은 동일합니다.
엔드포인트 URL은 개요 섹션에서 사용할 수 있습니다.
기술 자료 관리
내 QnA Maker의 일부를 실수로 삭제했습니다. 어떻게 해야 하나요?
답변: 검색 또는 웹앱과 같은 QnA Maker 리소스와 함께 만든 Azure 서비스를 삭제하지 마세요. 이러한 작업은 QnA Maker가 작동하기 위해 필요하며, 삭제하면 QnA Maker가 제대로 작동하지 않습니다.
질문 및 답변 쌍, 파일, URL, 사용자 지정 질문 및 답변, 기술 자료 또는 Azure 리소스를 포함하여 모든 삭제는 영구적입니다. 기술 자료 일부를 삭제하기 전에 설정 페이지에서 기술 자료 내보내야 합니다.
URL/파일이 질문-답변 쌍을 추출하지 않는 이유는 무엇인가요?
답변: QnA Maker가 유효한 FAQ URL에서 일부 QnA(질문-답변) 콘텐츠를 자동으로 추출하지 못할 수 있습니다. 이러한 경우 QnA 콘텐츠를 .txt 파일에 붙여넣고 도구에서 수집할 수 있는지 확인할 수 있습니다. 또는 QnA Maker 포털을 통해 편집적으로 콘텐츠를 기술 자료 추가할 수 있습니다.
만들 수 있는 기술 자료 크기는 얼마인가요?
답변: 기술 자료 크기는 QnA Maker 서비스를 만들 때 선택한 Azure 검색의 SKU에 따라 달라집니다. 자세한 내용은 여기를 참조하세요.
새 기술 자료를 만들려고 할 때 드롭다운에 아무것도 표시될 수 없는 이유는 무엇인가요?
답변: Azure에서 QnA Maker 서비스를 아직 만들지 않았습니다. 이 작업을 수행하는 방법을 알아보려면 여기를 참조하세요.
기술 자료를 다른 사용자와 공유하려면 어떻게 하나요?
답변: 공유는 QnA Maker 서비스 수준에서 작동합니다. 즉, 서비스의 모든 기술 자료 공유됩니다. 기술 자료 공동 작업하는 방법을 여기에서 읽어보세요.
동일한 AAD 테넌트에 있지 않은 기여자와 기술 자료를 공유하여 기술 자료를 수정할 수 있나요?
답변: 공유는 Azure RBAC(역할 기반 Access Control)에 따릅니다. 다른 사용자와 Azure의 모든 리소스를 공유할 수 있는 경우 QnA Maker도 공유할 수 있습니다.
5개 QnAMaker 기술 자료가 포함된 App Service 요금제가 있는 경우. 5명의 각각 다른 사용자가 QnAMaker 기술 자료 1개에만 액세스할 수 있도록 해당 사용자에게 읽기/쓰기 권한을 할당할 수 있나요?
답변: 개별 기술 자료 아닌 전체 QnAMaker 서비스를 공유할 수 있습니다.
양호한 일치 항목이 없는 경우 기본 메시지를 변경하려면 어떻게 해야 하나요?
답변: 기본 메시지는 App Service의 설정에 속합니다.
- Azure Portal에서 App Service 리소스로 이동
- 설정 옵션 선택
- DefaultAnswer 설정의 값 변경
- App Service 다시 시작
SharePoint 링크가 추출되지 않는 이유는 무엇인가요?
답변: 자세한 내용은 데이터 원본 위치를 참조하세요.
기술 자료에 수행한 업데이트가 게시에 반영되지 않습니다. 그 이유가 무엇인가요?
답변: 테이블 업데이트, 테스트 또는 설정에서 모든 편집 작업을 게시하기 전에 저장해야 합니다. 모든 편집 작업 후에는 저장 후 학습 단추를 선택해야 합니다.
기술 자료는 풍부한 데이터 또는 멀티미디어를 지원하나요?
정답:
파일 및 URL에 대한 멀티미디어 자동 추출
- URLS - 제한된 HTML-Markdown 변환 기능
- 파일 - 지원되지 않음
markdown의 답변 텍스트
QnA 쌍이 기술 자료 있으면 응답의 markdown 텍스트를 편집하여 공용 URL에서 사용할 수 있는 미디어에 대한 링크를 포함할 수 있습니다.
QnA Maker에서 영어 이외의 언어를 지원하나요?
답변: 지원되는 언어에 대한 자세한 내용을 참조하세요.
여러 언어의 콘텐츠가 있는 경우 언어마다 별도의 서비스를 만들어야 합니다.
서비스 관리
내 App Service를 다시 시작해야 하는 경우는 언제인가요?
답변: 사용자 설정페이지의 엔드포인트 키 테이블에서 기술 자료에 대한 버전 값 옆에 주의 아이콘이 표시되면 App Service를 새로 고칩니다.
기존 Search Service를 삭제했습니다. 이 문제를 해결하려면 어떻게 해야 하나요?
답변: Azure AI Search 인덱스 삭제 시 작업이 최종이며 인덱스는 복구할 수 없습니다.
Search Service에서 `testkb` 인덱스를 삭제했습니다. 이 문제를 해결하려면 어떻게 해야 하나요?
답변: Search 서비스에서 인덱스가 testkb 삭제된 경우 마지막으로 게시된 KB에서 데이터를 복원할 수 있습니다. GitHub에서 사용할 수 있는 복구 도구 RestoreTestKBIndex를 사용하세요.
다음 오류가 발생했습니다. QnA Maker App 서비스의 CORS 설정이 https://www.qnamaker.ai를 허용하는지 또는 조직별 네트워크 제한이 있는지 확인하세요. 이 문제를 해결하려면 어떻게 해야 하나요?
답변: App Service 창의 API 섹션에서 CORS 설정을 * 또는 "https://www.qnamaker.ai""로 업데이트합니다. 이 문제가 해결되지 않으면 조직별 제한 사항을 확인합니다.
엔드포인트 키를 새로 고쳐야 하는 경우는 언제인가요?
답변: 엔드포인트 키가 손상되었다고 의심되는 경우 엔드포인트 키를 새로 고칩니다.
여러 언어를 사용하는 기술 자료 동일한 Azure AI Search 리소스를 사용할 수 있나요?
답변: 여러 언어 및 여러 기술 자료를 사용하려면 사용자는 각 언어에 대한 QnA Maker 리소스를 만들어야 합니다. 이렇게 하면 언어당 별도의 Azure Search 서비스를 만들게 됩니다. 단일 Azure Search 서비스에서 다른 언어 기술 자료 혼합하면 결과의 관련성이 저하됩니다.
QnA Maker에서 사용하는 Azure AI Search 리소스의 이름을 변경하기 위해 어떻게 해야 하나요?
답변: Azure AI Search 리소스의 이름은 끝에 임의의 문자가 추가된 QnA Maker 리소스 이름입니다. 이 이름으로는 QnA Maker의 여러 Search 리소스를 구별하기 어렵습니다. 별도의 검색 서비스를 만들고(원하는 방식으로 이름을 지정) QnA 서비스에 연결합니다. 단계는 Azure Search를 업그레이드하기 위해 수행해야 하는 단계와 유사합니다.
QnA Maker가 '런타임 코어가 초기화되지 않음'을 반환하는 경우 이 문제를 해결하려면 어떻게 해야 하나요?
답변: 앱 서비스의 디스크 공간이 가득 찼을 수 있습니다. 디스크 공간을 수정하는 단계:
Azure Portal에서 QnA Maker의 앱 서비스를 선택한 다음, 서비스를 중지합니다.
App Service에 있는 동안 개발 도구, 고급 도구, Go를 차례로 선택합니다. 그러면 새 브라우저 창이 열립니다.
디버그 콘솔, CMD를 차례로 선택하여 명령줄 도구를 엽니다.
사이트/wwwroot/Data/QnAMaker/디렉터리로 이동합니다.
이름이
rd로 시작하는 모든 폴더를 제거합니다.다음을 삭제 하지 마세요.
- KbIdToRankerMappings.txt 파일
- EndpointSettings.json 파일
- EndpointKeys 폴더
App Service를 시작합니다.
기술 자료에 액세스하여 지금 작동하는지 확인합니다.
내 Application Insights가 작동하지 않는 이유는 무엇인가요?
답변: 문제를 해결하려면 아래 단계를 교차 확인하고 업데이트하세요.
App Service -> 설정 그룹 -> 구성 섹션 -> 애플리케이션 설정 -> 이름 "UserAppInsightsKey" 매개 변수가 올바르게 구성되어 있고 해당 Application Insights 개요 탭("계측 키") GUID로 설정되어 있는지 확인합니다.
App Service -> 설정 그룹 -> "Application Insights" 섹션에서 Application Insights가 사용하도록 설정되어 있고 해당 Application Insights 리소스에 연결되어 있는지 확인합니다.
내 Application Insights가 활성화되어 있는데 제대로 작동하지 않는 이유는 무엇인가요?
답변: 아래의 단계를 따르세요.
일부 값이 이미 있는 경우 재정의하여 '"APPINSIGHTS_INSTRUMENTATIONKEY" 이름' 값을 'UserAppInsightsKey' 이름으로 복사합니다.
앱 설정에 'UserAppInsightsKey' 키가 없는 경우 해당 이름의 새 키를 추가하고 값을 복사하세요.
저장하면 앱 서비스가 자동으로 다시 시작됩니다. 이렇게 하면 문제가 해결됩니다.
Bot을 비롯한 다른 서비스와의 통합
QnA Maker를 사용하기 위해 Bot Framework를 사용해야 하나요?
답변: 아니요, QnA Maker와 함께 Bot Framework를 사용할 필요가 없습니다. 하지만 QnA Maker는 Azure AI Bot Service에서 여러 템플릿 중 하나로 제공됩니다. Bot Service를 사용하면 Microsoft Bot Framework를 통해 지능형 봇을 빠르게 개발할 수 있으며 서버 없는 환경에서 실행됩니다.
QnA Maker를 사용하여 새 봇을 만들려면 어떻게 해야 하나요?
답변: 이 문서의 지침에 따라 Azure AI Bot Service를 사용하여 봇을 만듭니다.
기존 Azure AI Bot Service에서 다른 기술 자료를 사용하려면 어떻게 해야 하나요?
답변: 기술 자료 대한 다음 정보가 필요합니다.
- 기술 자료 ID입니다.
- 기술 자료의 게시된 엔드포인트 사용자 지정 하위 기본 이름은
host게시한 후 설정 페이지에서 찾을 수 있습니다. - 기술 자료의 게시된 엔드포인트 키 - 게시 후 설정 페이지에서 찾을 수 있습니다.
이 정보를 확인했으면 Azure Portal에서 봇의 App Service로 이동합니다. 설정 -> 구성 -> 애플리케이션 설정에서 해당 값을 변경합니다.
ABS 서비스에서 기술 자료의 엔드포인트 키에는 QnAAuthkey라는 레이블이 지정되어 있습니다.
두 개 이상의 클라이언트 애플리케이션에서 기술 자료를 공유할 수 있나요?
답변: 예, 기술 자료 여러 클라이언트에서 쿼리할 수 있습니다. 기술 자료의 응답이 느리거나 시간이 초과된 것으로 보일 경우 기술 자료와 연결된 App Service에 대한 서비스 계층을 업그레이드하는 것이 좋습니다.
웹 사이트에 QnA Maker 서비스를 포함하려면 어떻게 해야 하나요?
답변: 다음 단계에 따라 QnA Maker 서비스를 웹 사이트에 웹 채팅 컨트롤로 포함합니다.
- 여기에 있는 지침에 따라 FAQ 봇을 만듭니다.
- 다음 단계에 따라 웹 채팅을 사용하도록 설정합니다.
데이터 저장소
어떤 데이터가 저장되고 어디에 저장되나요?
정답:
QnA Maker 서비스를 만들 때 Azure 지역을 선택했습니다. 기술 자료 및 로그 파일은 이 지역에 저장됩니다.