QnA Maker 기술 자료 제한 및 경계
아래에 제공된 QnA Maker 제한은 Azure AI Search 가격 책정 계층 제한과 QnA Maker 가격 책정 계층 제한의 조합입니다. 리소스당 만들 수 있는 기술 자료 수와 각 기술 자료 얼마나 커질 수 있는지 이해하려면 두 가지 제한 집합을 모두 알아야 합니다.
기술 자료
최대 기술 자료 수는 Azure AI Search 계층 제한을 기반으로 합니다.
| Azure AI Search 계층 | 무료 | 기본 | 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 Search 계층 제한을 기반으로 합니다.
GA 버전의 경우 테스트 인덱스가 모든 KB에서 공유되므로 QnA Maker 서비스의 모든 KB에 제한이 적용됩니다.
| Azure AI Search 계층 | 무료 | 기본 | 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 Search 계층에 따라 달라집니다. 질문 및 답변 쌍은 Azure AI Search 인덱스 문서에 매핑됩니다.
- URL/HTML 페이지: 1백만 문자
기술 자료 호출 제한을 만듭니다.
이는 각 기술 자료 만들기 작업(‘기술 자료 만들기’ 클릭 또는 CreateKnowledgeBase API 호출)에 대한 제한을 나타냅니다.
- 답변당 권장되는 최대 대체 질문 수: 300
- 최대 URL 수: 10
- 최대 파일 수: 10
- 호출당 허용되는 최대 QnA 수: 1000
기술 자료 호출 제한 업데이트
각 업데이트 작업에 대한 제한을 나타냅니다. 즉, 저장을 클릭하고 학습 하거나 UpdateKnowledgeBase API를 호출합니다.
- 각 원본 이름의 길이: 300
- 추가 또는 삭제된 권장 최대 대체 질문 수: 300
- 추가 또는 삭제된 최대 메타데이터 필드 수: 10
- 새로 고칠 수 있는 최대 URL 수: 5
- 호출당 허용되는 최대 QnA 수: 1000
구조화되지 않은 파일 제한 추가
참고 항목
- 제한에서 허용하는 것보다 큰 파일을 사용해야 하는 경우 파일을 API로 보내기 전에 파일을 더 작은 파일로 분할할 수 있습니다.
구조화되지 않은 파일을 사용하여 KB를 만들거나 CreateKnowledgeBase API를 호출하는 경우의 제한을 나타냅니다.
- 파일 길이: 처음 32000자를 추출합니다.
- 파일당 최대 3개의 응답
미리 빌드된 질문 답변 제한
참고 항목
- 제한에서 허용하는 것보다 큰 문서를 사용해야 하는 경우 API로 보내기 전에 텍스트를 더 작은 텍스트 청크로 분할할 수 있습니다.
- 문서는 텍스트 문자의 단일 문자열입니다.
이 한도는 ‘응답을 생성’하거나 GenerateAnswer API를 호출하는 데 미리 빌드된 API가 사용된 경우 나타납니다.
- 문서 수: 5
- 단일 문서의 최대 크기: 5,120자
- 문서당 최대 3개의 응답
Important
구조화되지 않은 파일/콘텐츠를 지원하며 질문 답변에서만 사용할 수 있습니다.
변경 제한
변경은 ',', '?', ':', ';', '"', ''', '(', ')', '{', '}', '[', ']', '-', '+', '.', '/', '!', '*', '-', '_', '@', '#' 특수 문자를 허용하지 않습니다.
다음 단계
서비스 가격 책정 계층을 변경하는 시기와 방법을 알아봅니다.