QnA Maker 기술 자료에서 사용자 지정 질문 답변으로 마이그레이션
Azure AI 언어의 기능인 사용자 지정 질문 답변은 2021년 5월에 도입되었으며 딥 러닝 랭커를 사용한 관련성 향상, 정확한 답변, 엔드투엔드 지역 지원을 비롯한 몇 가지 새로운 기능이 추가되었습니다. 각 사용자 지정 질문 답변 프로젝트는 QnA Maker의 기술 자료에 해당합니다. 기술 자료를 QnA Maker 리소스에서 언어 리소스 내의 사용자 지정 질문 답변 프로젝트로 쉽게 마이그레이션할 수 있습니다. 여러 QnA Maker 리소스에서 특정 언어 리소스로 기술 자료를 마이그레이션하도록 선택할 수도 있습니다.
기술 자료를 성공적으로 마이그레이션하려면 마이그레이션을 수행하는 계정에 선택한 QnA Maker 및 언어 리소스에 대한 기여자 액세스 권한이 필요합니다. 기술 자료가 마이그레이션되면 다음 세부 정보가 새 사용자 지정 질문 답변 프로젝트에 복사됩니다.
- 활성 학습 제안을 포함하는 QnA 쌍.
- QnA Maker 리소스의 동의어 및 기본 답변입니다.
- 기술 자료 이름이 프로젝트 설명 필드에 복사됩니다.
RBAC(역할 기반 액세스 제어)와 같은 리소스 수준 설정은 새 리소스로 마이그레이션되지 않습니다. 이러한 리소스 수준 설정은 마이그레이션 후 언어 리소스에 대해 다시 구성해야 합니다. 또한 언어 리소스에 대해 분석을 다시 사용하도록 설정해야 합니다.
SDK를 마이그레이션하는 단계
이 SDK 마이그레이션 가이드는 예전의 Microsoft.Azure.CognitiveServices.Knowledge.QnAMaker에서 Azure.AI.Language.QuestionAnswering 새 사용자 지정 질문 답변 클라이언트 라이브러리로 마이그레이션하는 데 도움이 됩니다. 이 가이드에서는 두 패키지 간의 유사한 작업을 나란히 비교하는 데 중점을 둡니다.
기술 자료를 마이그레이션하는 단계
아래 단계에 따라 기술 자료를 마이그레이션할 수 있습니다.
사용자 지정 질문 답변이 미리 사용하도록 설정된 언어 리소스를 만듭니다. Azure Portal에서 언어 리소스를 만들 때 사용자 지정 질문 답변을 사용하도록 설정하는 옵션이 표시됩니다. 해당 옵션을 선택하고 계속 진행하면 기술 자료를 저장할 Azure Search 세부 정보를 묻는 메시지가 표시됩니다.
여러 언어로 된 기술 자료를 언어 리소스에 추가하려면 Language Studio를 방문하여 첫 번째 사용자 지정 질문 답변 프로젝트를 만들고 아래와 같이 첫 번째 옵션을 선택합니다. 언어 리소스에 대한 언어 설정은 프로젝트 만들기 시에만 지정할 수 있습니다. 단일 언어로 된 기존 기술 자료를 언어 리소스로 마이그레이션하려는 경우 이 단계를 건너뛸 수 있습니다.
https://www.qnamaker.ai를 방문하여 기술 자료 페이지의 마이그레이션 메모에서 마이그레이션 시작을 선택합니다. 마이그레이션을 시작하기 위한 대화 상자가 열립니다.
마이그레이션을 시작하는 데 필요한 세부 정보를 입력합니다. 테넌트가 자동으로 선택됩니다. 테넌트를 전환하도록 선택할 수 있습니다.
마이그레이션할 기술 자료가 포함된 QnA Maker 리소스를 선택합니다.
기술 자료를 마이그레이션할 언어 리소스를 선택합니다. 사용자 지정 질문 답변이 사용하도록 설정된 언어 리소스만 볼 수 있습니다. 언어 리소스에 대한 언어 설정이 옵션에 표시됩니다. 언어 설정이 지정되지 않은 경우 QnA Maker 리소스에서 언어 리소스로 여러 언어로 기술 자료를 마이그레이션할 수 없습니다.
여러 언어로 된 기술 자료를 언어 리소스로 마이그레이션하려면 언어 리소스에 대한 첫 번째 사용자 지정 질문 답변 프로젝트를 만들 때 다국어 설정을 사용하도록 설정해야 합니다. 2단계의 지침을 따르면 그렇게 할 수 있습니다. 언어 리소스에 대한 언어 설정을 지정하지 않으면 선택한 QnA Maker 리소스 언어가 할당됩니다.
마이그레이션할 모든 기술 자료를 선택하고 > 다음을 선택합니다.
마이그레이션할 기술 자료를 검토할 수 있습니다. 사용자 지정 질문 답변 프로젝트에 대해 더 엄격한 유효성 검사 규칙을 따르기 때문에 프로젝트 이름에 일부 유효성 검사 오류가 있을 수 있습니다. 잘못된 문자로 인해 발생하는 이러한 오류를 해결하려면 확인란(빨간색)을 선택하고 다음을 선택합니다. 이는 이름에서 문제가 있는 문자를 허용되는 문자로 바꾸는 원클릭 메서드입니다. 중복이 있는 경우 시스템에서 새 고유한 프로젝트 이름을 생성합니다.
주의
대상 언어 리소스에 이미 존재하는 프로젝트와 이름이 같은 기술 자료를 마이그레이션하는 경우 선택한 기술 자료의 내용이 프로젝트의 내용보다 우선 적용됩니다.
유효성 검사 오류를 해결한 후 마이그레이션 시작을 선택합니다.
마이그레이션이 발생하는 데 몇 분 정도 걸립니다. 마이그레이션이 진행 중인 동안에는 취소하지 마세요. 마이그레이션 후 Language Studio 내에서 마이그레이션된 프로젝트로 이동할 수 있습니다.
기술 자료가 사용자 지정 질문 답변 프로젝트로 마이그레이션되지 않으면 오류가 표시됩니다. 가장 일반적인 마이그레이션 오류는 다음과 같은 경우에 발생합니다.
- 원본 및 대상 리소스가 잘못되었습니다.
- 빈 KB(기술 자료)를 마이그레이션하려고 합니다.
- 대상 리소스에 연결된 Azure Search 인스턴스 제한에 도달했습니다.
이러한 오류를 해결하면 마이그레이션을 다시 실행할 수 있습니다.
마이그레이션은 기술 자료의 테스트 인스턴스만 복사합니다. 마이그레이션이 완료되면 기술 자료를 수동으로 배포하여 테스트 인덱스를 프로덕션 인덱스로 복사해야 합니다.
다음 단계
- Azure Monitor 진단 로그로 분석을 다시 사용하도록 설정하는 방법을 알아봅니다.