빠른 시작: QnA Maker 기술 자료 만들기, 학습 및 게시

참고 항목

Azure Open AI On Your Data는 LLM(대규모 언어 모델)을 활용하여 QnA Maker와 유사한 결과를 생성합니다. QnA Maker 프로젝트를 Azure Open AI On Your Data로 마이그레이션하려면 가이드를 확인하세요.

참고 항목

QnA Maker 서비스가 2025년 3월 31일부로 종료됩니다. 이제 최신 버전의 질문 및 답변 기능이 Azure AI 언어의 일부로 사용할 수 있습니다. 언어 서비스 내의 질문 답변 기능은 질문 답변을 참조하세요. 2022년 10월 1일부터 새로운 QnA Maker 리소스를 만들 수 없습니다. 기존 QnA Maker 기술 자료를 질문 답변으로 마이그레이션하는 방법에 대한 정보는 마이그레이션 가이드를 참조하세요.

FAQ 또는 제품 설명서 등, 사용자 고유의 콘텐츠에서 QnA Maker 기술 자료(KB)를 만들 수 있습니다. 이 문서에는 간단한 FAQ 웹 페이지에서 QnA Maker 기술 자료를 만들어 질문에 답변하는 예가 포함되어 있습니다.

필수 조건

• Azure 구독이 없는 경우 시작하기 전에 체험 계정을 만듭니다.
• Azure Portal에서 만든 QnA Maker 리소스입니다. 리소스를 만들 때 선택한 Microsoft Entra ID, 구독, QnA Maker 리소스 이름을 기억하세요.

첫 번째 QnA Maker 기술 자료 만들기

1. Azure 자격 증명으로 QnAMaker.ai 포털에 로그인합니다.

2. QnA Maker 포털에서 기술 자료 만들기를 선택합니다.

3. 만들기 페이지에서 QnA Maker 리소스가 이미 있는 경우 1단계를 건너뜁니다.

서비스를 아직 만들지 않은 경우 안전성 및 QnA 서비스 만들기를 선택합니다. 그러면 구독에서 QnA Maker 서비스를 설정할 수 있는 Azure Portal로 연결됩니다. 리소스를 만들 때 선택한 Microsoft Entra ID, 구독, QnA 리소스 이름을 기억하세요.

Azure Portal에서 리소스 만들기를 완료하면 QnA Maker 포털로 돌아가서 브라우저 페이지를 새로 고치고 2단계를 계속 진행합니다.

4. 2단계에서는 Active 디렉터리, 구독, 서비스(리소스) 및 서비스에서 만든 모든 기술 자료에 대한 언어를 선택합니다.

   

5. 3단계에서는 기술 자료의 이름을 내 샘플 QnA KB로 지정합니다.

6. 4단계에서는 다음 표를 사용하여 설정을 구성합니다.

   설정	값
   URL, .pdf 또는 .docx 파일에서 다중 턴 추출을 사용하도록 설정합니다.	선택
   다중 턴 기본 텍스트	옵션 선택
   + URL 추가	https://www.microsoft.com/download/faq.aspx
   Chit-chat	Professional 선택

7. 5단계에서는 KB 만들기를 선택합니다.

   추출 프로세스는 문서를 읽고 질문과 답변을 확인하는 데 몇 분 정도가 걸립니다.

   QnA Maker가 기술 자료를 성공적으로 만들면 기술 자료 페이지가 열립니다. 이 페이지에서 기술 자료의 내용을 편집할 수 있습니다.

새 질문 및 답변 집합 추가

1. QnA Maker 포털에서 편집 페이지의 상황에 맞는 도구 모음에서 QnA 쌍 추가를 선택합니다.

2. 다음 질문을 추가합니다.

   How many Azure services are used by a knowledge base?

3. markdown으로 서식이 지정된 답변을 추가합니다.

   * Azure AI QnA Maker service\n* Azure Cognitive Search\n* Azure web app\n* Azure app plan

   

   markdown 기호 *는 글머리 기호에 사용됩니다. \n은 새 줄에 사용됩니다.

   편집 페이지에 markdown이 표시됩니다. 나중에 테스트 패널을 사용하면 markdown이 올바르게 표시됩니다.

저장 후 학습

오른쪽 위에서 저장 후 학습을 선택하여 편집 내용을 저장하고 QnA Make를 학습합니다. 저장하지 않으면 편집 내용은 보관되지 않습니다.

기술 자료 테스트

1. QnA Maker 포털의 오른쪽 위에서 테스트를 선택하여 변경 내용이 적용되었는지 테스트합니다.

2. 텍스트 상자에 예제 사용자 쿼리를 입력합니다.

   I want to know the difference between 32 bit and 64 bit Windows

   

3. 검사를 선택하여 응답을 더 자세히 살펴봅니다. 테스트 창은 기술 자료를 게시하기 전에 기술 자료의 변경 내용을 테스트하는 데 사용됩니다.

4. 테스트를 다시 선택하여 테스트 패널을 닫습니다.

기술 자료 게시

기술 자료를 게시하면 기술 자료의 콘텐츠가 test 인덱스에서 Azure 검색의 prod 인덱스로 이동합니다.

1. QnA Maker 포털에서 게시를 선택합니다. 그런 다음, 확인하려면 페이지에서 게시를 선택합니다.

   이제 QnA Maker 서비스가 성공적으로 게시되었습니다. 애플리케이션 또는 봇 코드에서 엔드포인트를 사용할 수 있습니다.

   

봇 만들기

게시 후에는 게시 페이지에서 봇을 만들 수 있습니다.

• 개별 봇의 여러 Azure 지역 또는 가격 책정 계획에 대한 동일한 기술 자료를 가리키는 여러 봇을 신속하게 만들 수 있습니다.
• 기술 자료에 봇을 하나만 사용하려면 Azure Portal에서 모든 봇 보기 링크를 사용하여 현재 봇 목록을 봅니다.

기술 자료를 변경하고 다시 게시하는 경우 봇에 다른 조치를 취할 필요가 없습니다. 이미 기술 자료와 함께 작동하도록 구성되어 있으며 향후 모든 기술 자료 변경 내용과 호환됩니다. 기술 자료를 게시할 때마다 기술 자료에 연결된 모든 봇이 자동으로 업데이트됩니다.

1. QnA Maker 포털의 게시 페이지에서 봇 만들기를 선택합니다. 이 단추는 기술 자료를 게시한 후에만 표시됩니다.

   

2. 새 브라우저 탭에서 Azure Portal의 Azure AI Bot Service 만들기 페이지가 열립니다. Azure AI Bot Service를 구성합니다. 봇과 QnA Maker는 웹앱 서비스 플랜을 공유할 수 있지만, 웹앱을 공유할 수는 없습니다. 즉, 봇의 앱 이름이 QnA Maker 서비스의 앱 이름과 달라야 합니다.

   • 권장 사항
     • 고유하지 않은 경우 봇 핸들을 변경합니다.
     • SDK 언어를 선택합니다. 봇이 만들어지면 로컬 개발 환경에 코드를 다운로드하고 개발 프로세스를 계속할 수 있습니다.
   • 금지 사항
     • 봇을 만들 때 Azure Portal에서 다음 설정을 변경하지 마세요. 기존 기술 자료에 대한 내용이 미리 채워집니다.
       • QnA 인증 기
       • 앱 서비스 플랜 및 위치

3. 봇을 만든 후 봇 서비스 리소스를 엽니다.

4. 봇 관리에서 웹 채팅에서 테스트를 선택합니다.

5. 메시지 입력의 채팅 프롬프트에서 다음을 입력합니다.

   Azure services?

   채팅 봇은 기술 자료의 답변으로 응답합니다.

   

수행했던 작업은 무엇인가요?

새 기술 자료를 만들고, 기술 자료에 공용 URL을 추가하고, 사용자 고유의 QnA 쌍을 추가하고, 기술 자료를 학습, 테스트 및 게시했습니다.

기술 자료를 게시한 후 봇을 만들고, 봇을 테스트했습니다.

이 작업은 코드를 작성하거나 콘텐츠를 정리하지 않고도 모두 몇 분 내에 완료되었습니다.

리소스 정리

다음 빠른 시작을 계속 진행하지 않을 경우 Azure Portal에서 QnA Maker 및 Bot 프레임워크 리소스를 삭제합니다.

다음 단계

메타데이터를 사용하여 질문 추가

자세한 내용은 다음에서 확인합니다.

• 답변의 Markdown 형식
• QnA Maker 데이터 원본.