QnA Maker 기술 자료 제한 및 경계

아티클
09/01/2024

아래에 제공된 QnA Maker 제한은 Azure AI Search 가격 책정 계층 제한과 QnA Maker 가격 책정 계층 제한의 조합입니다. 리소스당 만들 수 있는 기술 자료 수와 각 기술 자료 얼마나 커질 수 있는지 이해하려면 두 가지 제한 집합을 모두 알아야 합니다.

기술 자료

최대 기술 자료 수는 Azure AI Search 계층 제한을 기반으로 합니다.

Azure AI 검색 계층	무료	기본	S1	S2	S3	S3 HD
게시할 수 있는 기술 자료의 최대 수	2	14	49	199	199	2,999

예를 들어 계층에 15개의 허용된 인덱스가 있는 경우 14개의 기술 자료를 게시할 수 있습니다(게시된 기술 자료당 하나의 인덱스). 15번째 인덱스 testkb는 작성 및 테스트를 위한 모든 기술 자료에 사용됩니다.

추출 제한

파일 명명 제약 조건

파일 이름에는 다음 문자를 포함할 수 없습니다.

문자 사용 안 함
작은따옴표 `'`
큰따옴표 `"`

최대 파일 크기

형식	최대 파일 크기(MB)
`.docx`	10
`.pdf`	25
`.tsv`	10
`.txt`	10
`.xlsx`	3

최대 파일 수

추출할 수 있는 최대 파일 수와 최대 파일 크기는 QnA Maker 가격 책정 계층 제한을 기반으로 합니다.

URL의 최대 딥 링크 수

URL 페이지에서 QnA를 추출하기 위해 크롤링할 수 있는 딥 링크의 최대 수는 20개입니다.

메타데이터 제한

메타데이터는 product:windows 10과 같은 텍스트 기반 키:값 쌍으로 제공되며, 소문자로 저장되고 비교됩니다. 최대 메타데이터 필드 수는 Azure AI 검색 계층 제한을 기반으로 합니다.

GA 버전의 경우 테스트 인덱스가 모든 KB에서 공유되므로 QnA Maker 서비스의 모든 KB에 제한이 적용됩니다.

Azure AI 검색 계층	무료	기본	S1	S2	S3	S3 HD
QnA Maker 서비스당 최대 메타데이터 필드(모든 KB)	1,000	100*	1,000	1,000	1,000	1,000

이름 및 값

다음 표에서는 메타데이터 이름 및 값에 대한 길이와 허용 가능한 문자를 나열합니다.

Item	허용되는 문자	Regex 패턴 일치	최대 문자 수
이름(키)	허용: 영숫자(문자와 숫자) `_`(밑줄) 공백은 포함할 수 없습니다.	`^[a-zA-Z0-9_]+$`	100
값	제외: `:`(콜론) `\|`(세로줄) 하나의 값만 허용	`^[^:\|]+$`	500

기술 자료 콘텐츠 제한

기술 자료에서 전반적인 콘텐츠 제한 사항은 아래와 같습니다.

대답 텍스트 길이: 25,000자
질문 텍스트 길이: 1,000자
메타데이터 키 텍스트 길이: 100자
메타데이터 값 텍스트 길이: 500자
메타데이터 이름의 지원되는 문자: 영문자, 숫자 및 _
메타데이터 값의 지원되는 문자: 모든 문자(: 및 | 제외)
파일 이름 길이: 200
지원되는 파일 형식: “.tsv”, “.pdf”, “.txt”, “.docx”, “.xlsx”
최대 대체 질문 수: 300
최대 질문-답변 쌍 수: 선택한 Azure AI 검색 계층에 따라 달라집니다. 질문 및 대답 쌍은 Azure AI 검색 인덱스의 문서에 매핑됩니다.
URL/HTML 페이지: 100만 문자

기술 자료 호출 제한을 만듭니다.

이는 각 기술 자료 만들기 작업(‘기술 자료 만들기’ 클릭 또는 CreateKnowledgeBase API 호출)에 대한 제한을 나타냅니다.

대답별 권장 최대 대체 질문 수: 300
최대 URL 수: 10
최대 파일 수: 10
호출당 허용되는 최대 QnA 수: 1000개

기술 자료 호출 제한 업데이트

각 업데이트 작업에 대한 제한을 나타냅니다. 즉, 저장을 클릭하고 학습 하거나 UpdateKnowledgeBase API를 호출합니다.

각 원본 이름 길이: 300
추가 또는 삭제된 권장 최대 대체 질문 수: 300
추가 또는 삭제된 최대 메타데이터 필드 수: 10
새로 고칠 수 있는 최대 URL 수: 5
호출당 허용되는 최대 QnA 수: 1000개

비구조적 파일 한도 추가

참고 항목

허용 한도보다 크기가 큰 파일을 사용해야 하는 경우 파일을 API로 보내기 전에 큰 파일을 작은 파일로 분할할 수 있습니다.

구조화되지 않은 파일을 사용하여 KB를 만들거나 CreateKnowledgeBase API를 호출하는 경우의 제한을 나타냅니다.

파일 길이: 처음 32,000자 추출
파일당 최대 3개의 응답

미리 빌드된 질문 답변 한도

참고 항목

허용 한도보다 크기가 큰 문서를 사용해야 하는 경우 텍스트를 API로 보내기 전에 큰 텍스트를 작은 텍스트 청크로 분할할 수 있습니다.
문서는 텍스트 문자의 단일 문자열입니다.

이 한도는 ‘응답을 생성’하거나 GenerateAnswer API를 호출하는 데 미리 빌드된 API가 사용된 경우 나타납니다.

문서 수: 5개
단일 문서의 최대 크기: 5,120자
문서당 최대 3개의 응답

Important

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

변경 제한

변경은 ',', '?', ':', ';', '"', ''', '(', ')', '{', '}', '[', ']', '-', '+', '.', '/', '!', '*', '-', '_', '@', '#' 특수 문자를 허용하지 않습니다.

다음 단계

서비스 가격 책정 계층을 변경하는 시기와 방법을 알아봅니다.

다음을 통해 공유