참고
Azure AI 검색 Azure 포털, REST API 및 Azure SDK 통해 사용할 수 있습니다. 또한 엔터프라이즈 콘텐츠를 Microsoft Foundry 포털의 에이전트에 대해 재사용 가능한 사용 권한 인식 기술 자료로 변환하는 관리되는 기술 계층인 Foundry IQ를 뒷받침합니다.
이 문서에서는 인덱싱 중에 사용되는 AI 보강 및 기술 세트를 시작하는 데 도움이 되는 팁을 제공합니다.
팁 1: 간단히 시작 및 작게 시작
Azure Portal의 데이터 가져오기 마법사 는 AI 보강을 지원합니다. 코드를 작성하지 않고도 인덱스, 인덱서, 데이터 원본 및 기술 세트와 같이 보강 파이프라인에 사용되는 모든 개체를 만들고 검사할 수 있습니다.
간단히 시작하는 또 다른 방법은 인덱싱하려는 문서를 나타내는 소수의 문서 또는 행만 있는 데이터 원본을 만드는 것입니다. 작은 데이터 집합은 문제를 찾고 해결하는 속도를 높이는 가장 좋은 방법입니다. 엔드 투 엔드 파이프라인을 통해 샘플을 실행하고 결과가 요구 사항을 충족하는지 확인합니다. 결과에 만족하면 데이터 원본에 더 많은 파일을 추가할 준비가 된 것입니다.
팁 2: 오류가 있더라도 작동하는 기능 확인
경우에 따라 작은 오류가 해당 트랙에서 인덱서를 중지합니다. 문제를 하나씩 해결하려는 경우 해당 조건은 괜찮습니다. 하지만 특정 유형의 오류는 무시하도록 해서 인덱서가 계속 실행되고 실제로 어떤 흐름이 작동하는지 확인할 수 있습니다.
개발 중 오류를 무시하려면 인덱서 정의의 일부로 maxFailedItems 및 maxFailedItemsPerBatch을 -1로 설정합니다.
{
"parameters": {
"maxFailedItems": -1,
"maxFailedItemsPerBatch": -1
}
}
참고
프로덕션 워크로드에 maxFailedItemsmaxFailedItemsPerBatch 대해 0으로 설정하는 것이 가장 좋습니다.
팁 3: 디버그 세션을 사용하여 문제 해결
디버그 세션은 기술 세트의 종속성 그래프, 입력 및 출력 및 정의를 보여 주는 시각적 편집기입니다. 현재 인덱서 및 기술 세트 구성을 사용하여 인덱서 데이터 원본에서 단일 원본 문서를 로드합니다. 그런 다음 해당 문서로 범위가 지정된 전체 기술 세트를 실행할 수 있습니다. 디버그 세션 내에서 오류를 식별 및 해결하고, 변경 내용의 유효성을 검사하고, 부모 기술 세트에 변경 내용을 커밋할 수 있습니다. 연습은 자습서: 디버그 세션을 참조하세요.
팁 4: 예상 콘텐츠가 표시되지 않음
콘텐츠가 누락된 경우 Azure 포털에서 삭제된 문서를 확인합니다. 검색 서비스 페이지에서 인덱서를 열고 인덱서를 선택한 다음 실행의 상태 값을 선택하여 실행 세부 정보 및 오류를 봅니다.
파일 크기와 관련된 문제가 있는 경우 다음과 같은 오류가 표시될 수 있습니다. "Blob <파일 이름>"의 파일 크기<는 현재 서비스 계층의 >문서 추출에 대한 최대 크기를 초과합니다. 인덱서 제한에 대한 자세한 내용은 서비스 제한을 참조하세요.
콘텐츠가 표시되지 않는 두 번째 이유는 입력/출력 매핑 오류와 관련이 있을 수 있습니다. 예를 들어 출력 대상 이름은 "People"이지만 인덱스 필드 이름은 소문자 "people"입니다. 시스템은 전체 파이프라인에 대해 201개의 성공 메시지를 반환하므로 실제로 필드가 비어 있는 경우 인덱싱이 성공했다고 생각할 수 있습니다.
팁 5: 최대 실행 시간을 초과하여 처리 확장
이미지 분석은 단순한 사례라도 계산 집약적이므로 이미지가 특히 크거나 복잡한 경우 처리 시간이 최대 허용 시간을 초과할 수 있습니다.
기술 세트가 있는 인덱서의 경우 기술 세트 실행이 대부분의 계층에 대해 2시간으로 제한됩니다. 해당 기간 내에 기술 세트 처리가 완료되지 않는 경우 마지막으로 알려진 좋은 문서에서 처리를 다시 시작할 수 있도록 인덱서가 5분마다 실행되도록 예약합니다.
마지막으로 정상 작동이 확인된 문서부터 인덱싱을 재개합니다. 인덱서는 반복 일정에 따라, 이미지 백로그를 처리하여 모든 처리되지 않은 이미지를 완전히 처리할 때까지 수 시간 또는 며칠 동안 작업할 수 있습니다. 일정 구문에 대한 자세한 내용은 인덱서 예약을 참조합니다.
참고
예약된 인덱서가 동일한 문서에서 반복적으로 실패하는 경우 서비스는 진행될 때까지 실행 빈도(최대 24시간마다 한 번)를 줄입니다. 기본 문제를 해결한 후 요청 시 인덱서 실행 진행하면 인덱서가 구성된 간격으로 돌아갑니다. 인덱서가 성공적으로 실행된 후 구성된 일정으로 돌아가지 않는 경우 일정 동작 FAQ를 참조하세요.
팁 6: 인덱싱 처리량 증가
병렬 인덱싱의 경우 여러 컨테이너에 데이터를 또는 동일한 컨테이너 내부에 여러 가상 폴더를 분산합니다. 그런 다음, 여러 데이터 원본 및 인덱서 쌍을 만듭니다. 모든 인덱서는 동일한 기술 집합을 사용하며 동일한 대상 검색 인덱스에 쓸 수 있으므로 검색 앱이 이 분할을 알 필요가 없습니다.