가져온 문서 및 URL에 대한 서식 지침

콘텐츠에 대한 최상의 결과를 얻으려면 이러한 서식 지정 지침을 검토하세요.

서식 지정 고려 사항

파일 또는 URL을 가져오면 QnA Maker에서 콘텐츠를 markdown 형식으로 변환하고 저장합니다. 변환 프로세스는 텍스트에 새 줄(예: \n\n.)을 추가합니다. markdown 형식에 대한 지식은 변환된 콘텐츠를 이해하고 기술 자료 콘텐츠를 관리하는 데 도움이 됩니다.

기술 자료의 콘텐츠를 직접 추가하거나 편집하는 경우 markdown 서식 지정을 사용하여 서식 있는 텍스트 콘텐츠를 만들거나 이미 답변에 있는 markdown 형식 콘텐츠를 변경합니다. QnA Maker는 콘텐츠에 풍부한 텍스트 기능을 제공하기 위해 markdown 형식의 대부분을 지원합니다. 그러나 채팅 봇과 같은 클라이언트 애플리케이션은 동일한 markdown 형식 집합을 지원하지 않을 수 있습니다. 클라이언트 애플리케이션의 답변 표시를 테스트하는 것이 중요합니다.

콘텐츠 형식 및 예제의 전체 목록을 참조하세요.

기본 문서 서식 지정

QnA Maker는 다음과 같은 시각적 단서를 기반으로 하여 파일의 섹션, 하위 섹션 및 관계를 식별합니다.

• 글꼴 크기
• 글꼴 스타일
• 번호 매기기
• colors

참고 항목

현재 업로드된 문서에서 이미지 추출은 지원되지 않습니다.

제품 설명서

설명서는 일반적으로 제품과 함께 제공되는 지침 자료입니다. 사용자가 제품을 설정, 사용, 유지 관리 및 문제를 해결하는 데 도움이 됩니다. QnA Maker는 설명서를 처리할 때 제목과 부제목을 질문으로, 후속 콘텐츠를 답변으로 추출합니다. 여기에서 예제 를 참조하세요.

다음은 인덱스 페이지 및 계층적 콘텐츠가 있는 설명서의 예입니다.

참고 항목

추출은 목차 및/또는 색인 페이지와 계층적 제목이 있는 명확한 구조를 가진 설명서에서 가장 잘 작동합니다.

브로슈어, 지침, 논문 및 기타 파일

명확한 구조와 레이아웃이 있는 경우 다른 많은 유형의 문서를 처리하여 QA 쌍을 생성할 수도 있습니다. 여기에는 브로슈어, 지침, 보고서, 백서, 과학 논문, 정책, 책 등이 포함됩니다. 여기에서 예제 를 참조하세요.

다음은 인덱스가 없는 반구조화된 문서의 예입니다.

구조화되지 않은 문서 지원

이제 사용자 지정 질문 대답은 비정형 문서를 지원합니다. 잘 정의된 계층적 방식으로 구성된 콘텐츠가 없거나, 집합 구조가 없거나, 콘텐츠가 자유롭게 흐르는 문서는 비정형 문서로 간주될 수 있습니다.

다음은 구조화되지 않은 PDF 문서의 예입니다.

현재 이 기능은 문서 업로드를 통해서만 사용할 수 있으며 PDF 및 DOC 파일 형식에만 사용할 수 있습니다.

Important

구조화되지 않은 파일/콘텐츠를 지원하며 질문 답변에서만 사용할 수 있습니다.

구조화된 QnA 문서

DOC 파일의 정형 질문-답변 형식은 아래와 같이 줄당 질문과 대답을 번갈아 가며 한 줄당 하나의 질문과 다음 줄의 답변 형식입니다.

Question1

Answer1

Question2

Answer2

아래는 구조화된 QnA Word 문서의 예입니다.

구조적 TXT, TSV 및 XLS 파일

구조화된 .txt, .tsv 또는 .xls 파일 형식의 QnA를 QnA Maker에 업로드하여 기술 자료 만들거나 보강할 수도 있습니다. 일반 텍스트이거나 RTF 또는 HTML에서 콘텐츠를 포함할 수 있습니다. QnA 쌍에는 QnA 쌍을 범주별로 그룹화하는 데 사용할 수 있는 선택적 메타데이터 필드가 있습니다.

질문	답변	메타데이터(1개 키: 1개 값)
Question1	Answer1	Key1:Value1 | Key2:Value2
Question2	Answer2	Key:Value

원본 파일의 추가 열은 무시됩니다.

구조적 Excel 파일의 예

다음은 HTML 콘텐츠가 포함된 구조화된 QnA .xls 파일의 예입니다.

Excel 파일의 단일 답변에 대한 대체 질문의 예

다음은 단일 답변에 대한 몇 가지 대체 질문이 있는 구조화된 QnA .xls 파일의 예입니다.

파일을 가져온 후 질문 및 답변 쌍은 아래와 같이 기술 자료 있습니다.

가져오기를 통한 구조화된 데이터 형식

기술 자료를 가져오면 기존 기술 자료의 콘텐츠가 바뀝니다. 가져오기를 사용하려면 데이터 원본 정보를 포함하는 구조화된 .tsv 파일이 필요합니다. 이 정보는 QnA Maker가 질문-답변 쌍을 그룹화하고 특정 데이터 원본에 귀속하는 데 도움이 됩니다. QnA 쌍에는 QnA 쌍을 범주별로 그룹화하는 데 사용할 수 있는 선택적 메타데이터 필드가 있습니다.

질문	답변	원본	메타데이터(1개 키: 1개 값)
Question1	Answer1	Url1	Key1:Value1 | Key2:Value2
Question2	Answer2	Editorial	Key:Value

다중 턴 문서 서식 지정

• 제목 및 부제목을 사용하여 계층 구조를 나타냅니다. 예를 들어 h1을 사용하여 부모 QnA 및 h2를 표시하여 프롬프트로 사용해야 하는 QnA를 나타낼 수 있습니다. 작은 제목 크기를 사용하여 후속 계층 구조를 나타냅니다. 스타일, 색 또는 기타 메커니즘을 사용하여 문서의 구조체를 암시하지 마세요. QnA Maker는 멀티 턴 프롬프트를 추출하지 않습니다.
• 제목의 첫 번째 문자는 대문자여야 합니다.
• 제목 끝에 물음표(?)를 사용하지 않습니다.

샘플 문서:
Surface Pro(docx)
Contoso 혜택(docx)
Contoso 혜택(pdf)

FAQ URL

QnA Maker는 다음과 같은 3가지 형식으로 FAQ 웹 페이지를 지원할 수 있습니다.

• 일반 FAQ 페이지
• 링크가 있는 FAQ 페이지
• 토픽 홈페이지가 있는 FAQ 페이지

일반 FAQ 페이지

가장 일반적인 유형의 FAQ 페이지로, 답변이 동일한 페이지의 질문을 바로 따릅니다.

아래는 일반 FAQ 페이지의 예입니다.

링크가 있는 FAQ 페이지

이러한 종류의 FAQ 페이지에서는 질문이 함께 집계되어 동일한 페이지의 다른 섹션 또는 다른 페이지에 있는 답변에 연결됩니다.

아래는 동일한 페이지에 있는 섹션의 링크가 포함된 FAQ 페이지의 예입니다.

자식 답변 페이지에 대한 부모 항목 페이지 링크

이 유형의 FAQ에는 각 토픽이 다른 페이지의 해당 질문 및 답변 집합에 연결되는 토픽 페이지가 있습니다. QnA Maker는 연결된 모든 페이지를 크롤링하여 해당 질문과 답변을 추출합니다.

다음은 다른 페이지의 FAQ 섹션에 대한 링크가 있는 항목 페이지의 예입니다.

지원 URL

QnA Maker는 지정된 태스크를 수행하는 방법, 지정된 문제를 진단하고 해결하는 방법 및 지정된 프로세스에 대한 어떤 모범 사례가 있는지를 설명하는 웹 문서와 같은 반정형화된 지원 웹 페이지를 처리할 수 있습니다. 추출은 계층적 제목이 있는 명확한 구조를 가진 콘텐츠에서 가장 잘 작동합니다.

참고 항목

지원 문서에 대한 추출은 새로운 기능이며 초기 단계에 있습니다. 잘 구조화된 단순 페이지에서 최적으로 작동하며 복잡한 헤더/바닥글을 포함하지 않습니다.

기술 자료 가져오기 및 내보내기

내보낸 기술 자료의 TSV 및 XLS 파일은 QnA Maker 포털의 설정 페이지에서 파일을 가져와야만 사용할 수 있습니다. 이러한 파일은 기술 자료를 만드는 중에 또는 설정 페이지의 + 파일 추가 또는 + URL 추가 기능에서 데이터 원본으로 사용할 수 없습니다.

이러한 TSV 및 XLS 파일을 통해 기술 자료를 가져오면 내보낸 기술 자료에서 QnA를 추출한 원본이 아니라 편집 원본에 QnA 쌍이 추가됩니다.

다음 단계

콘텐츠 형식 및 예제의 전체 목록 보기