기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 멀티모달 지식 기반 문제 해결
<a name="kb-multimodal-troubleshooting"></a>

이 섹션에서는 멀티모달 지식 기반을 사용할 때 발생하는 일반적인 문제를 해결하기 위한 지침을 제공합니다. 문제 해결 정보는 일반적인 제한 사항, 원인 및 해결 방법이 포함된 일반적인 오류 시나리오, 성능 최적화 권장 사항으로 구성됩니다. 이 정보를 사용하여 멀티모달 콘텐츠의 설정, 수집 또는 쿼리 중에 문제를 진단하고 해결할 수 있습니다.

## 일반 제한 사항
<a name="kb-multimodal-general-limitations"></a>

멀티모달 지식 기반을 사용할 때는 다음과 같은 현재 제한 사항에 유의하세요.
+ **파일 크기 제한:** 비디오 파일당 최대 1.5GB, 오디오 파일당 1GB(Nova 멀티모달 임베딩) 또는 파일당 1.5GB(BDA)
+ **수집 작업당 파일:** 작업당 최대 15,000개의 파일(Nova Multimodal Embeddings) 또는 작업당 1,000개의 파일(BDA)
+ **쿼리 제한:** 쿼리당 최대 하나의 이미지
+ **데이터 소스 제한:** Amazon S3 및 사용자 지정 데이터 소스만 멀티모달 콘텐츠를 지원합니다.
+ **BDA 청킹 제한 사항:** 고정 크기 청킹과 함께 Bedrock Data Automation을 사용하는 경우 오디오 및 비디오 콘텐츠에 중복 백분율 설정이 적용되지 않습니다.
+ **BDA 동시 작업 제한:** 동시 BDA 작업 20개의 기본 제한입니다. 대규모 처리의 경우 서비스 할당량 증가 요청을 고려하세요.
+ **리랭커 모델 제한 사항:** 멀티모달 콘텐츠에는 리랭커 모델이 지원되지 않습니다.
+ **요약 제한:** 텍스트가 아닌 콘텐츠가 포함된 검색 응답의 요약은 지원되지 않습니다.
+ **쿼리 입력 제한:** 텍스트와 이미지를 모두 포함하는 입력은 현재 지원되지 않습니다. 텍스트 또는 이미지 쿼리를 사용할 수 있지만 둘 다 동시에 사용할 수는 없습니다.
+ **가드레일 이미지 콘텐츠 필터:** 이미지 콘텐츠 필터가 구성된 가드레일과 함께 이미지 쿼리를 사용하는 경우 입력 이미지는 가드레일에 대해 평가되며 구성된 필터 임계값을 위반하면 차단될 수 있습니다.
+ **입력 및 유형 불일치:** 기본적으로 입력은 유형이 지정되지 않은 경우 텍스트로 간주됩니다. 텍스트 이외의 양식을 사용하는 경우 올바른 유형을 지정해야 합니다.

## 일반적인 오류 및 해결 방법
<a name="kb-multimodal-common-errors"></a>

멀티모달 지식 기반에 문제가 발생하면 다음과 같은 일반적인 시나리오를 검토하세요.

**이미지 쿼리 사용 시 4xx 오류**  
**원인:** 텍스트 전용 임베딩 모델 또는 BDA 처리 지식 기반에서 이미지 쿼리를 사용하려고 시도합니다.  
**솔루션:** 이미지 쿼리 지원을 위한 지식 기반을 생성할 때 Amazon Nova 멀티모달 임베딩을 선택합니다.

**RAG는 멀티모달 콘텐츠와 함께 4xx 오류를 반환합니다.**  
**원인:** 멀티모달 콘텐츠 및 Amazon Nova 멀티모달 임베딩 모델만 포함하는 지식 기반과 `RetrieveAndGenerate` 함께 사용.  
**해결 방법:** RAG 기능에 BDA 구문 분석기를 사용하거나 지식 기반에 텍스트 콘텐츠가 포함되어 있는지 확인합니다.

**멀티모달 스토리지 대상 필수 오류**  
**원인:** 멀티모달 스토리지 대상을 구성하지 않고 Nova 멀티모달 임베딩 사용.  
**해결 방법:** Nova 멀티모달 임베딩을 사용할 때 멀티모달 스토리지 대상을 지정합니다.

**데이터 소스 및 멀티모달 스토리지는 동일한 S3 버킷을 사용합니다.**  
**원인:** 적절한 포함 접두사 없이 동일한 Amazon S3 버킷을 사용하도록 데이터 소스 및 멀티모달 스토리지 대상을 구성합니다.  
**솔루션:** 데이터 소스 및 멀티모달 스토리지에 별도의 버킷을 사용하거나 추출된 미디어 파일을 다시 수집하지 않도록 포함 접두사를 구성합니다.

**포함 접두사는 "aws/"로 시작할 수 없습니다.**  
**원인:** 데이터 소스와 멀티모달 스토리지 대상이 동일한 Amazon S3 버킷을 공유할 때 "aws/"로 시작하는 포함 접두사를 사용합니다.  
**해결 방법:** 다른 포함 접두사를 지정합니다. "aws/" 경로는 추출된 미디어 스토리지용으로 예약되어 있으며 처리된 콘텐츠를 다시 수집하지 않도록 하기 위한 포함 접두사로 사용할 수 없습니다.

**BDA 수집은 멀티모달 콘텐츠를 건너뜁니다.**  
**원인:** 지식 기반이 멀티모달 스토리지 대상 없이 생성된 후 멀티모달 콘텐츠와 함께 BDA 데이터 소스가 추가되었습니다.  
**솔루션:** 오디오, 비디오 및 이미지 파일의 BDA 처리를 활성화하도록 구성된 멀티모달 스토리지 대상으로 지식 기반을 다시 생성합니다.

**멀티모달 임베딩 모델 없이 생성된 지식 기반**  
**원인:** 지식 기반이 텍스트 전용 임베딩 모델로 생성되어 멀티모달 기능이 제한됩니다.  
**솔루션:** Nova 멀티모달 임베딩을 사용하여 새 지식 기반을 생성하여 네이티브 멀티모달 처리 및 이미지 기반 쿼리를 활성화합니다.

## Amazon S3 수명 주기 정책을 사용하여 임시 데이터 관리
<a name="kb-multimodal-lifecycle-policy"></a>

Nova 멀티모달 임베딩을 사용하는 경우 Amazon Bedrock은 임시 데이터를 멀티모달 스토리지 대상에 저장하고 처리가 완료된 후 삭제를 시도합니다. 임시 데이터 경로에 수명 주기 정책을 적용하여 제대로 만료되었는지 확인하는 것이 좋습니다.

------
#### [ Console ]

**콘솔을 사용하여 수명 주기 규칙을 생성하려면**

1. [Amazon S3 콘솔](https://console.aws.amazon.com/s3)을 엽니다.

1. 지식 기반에 대해 구성한 멀티모달 스토리지 대상으로 이동합니다.

1. **관리** 탭을 선택하고 **수명 주기 규칙 생성을** 선택합니다.

1. **수명 주기 규칙 이름**에를 입력합니다**Transient Data Deletion**.

1. **필터 유형**에서 **하나 이상의 필터를 사용하여이 규칙의 범위 제한을** 선택합니다.

1. **접두사**에 지식 기반 및 데이터 소스의 임시 데이터 경로를 입력합니다.

   다음 접두사의 자리 표시자 값을 실제 식별자로 바꿉니다.

   ```
   aws/bedrock/knowledge_bases/knowledge-base-id/data-source-id/transient_data
   ```
**중요**  
수명 주기 정책을 전체 버킷 또는 "aws/" 접두사에 적용하지 마십시오. 그러면 멀티모달 콘텐츠가 삭제되고 검색 실패가 발생합니다. 위에 표시된 특정 임시 데이터 경로만 사용합니다.

1. **수명 주기 규칙 작업**에서 **객체의 현재 버전 만료를** 선택합니다.

1. **객체 생성 후 일수**에를 입력합니다**1**.

1. **규칙 생성**을 선택합니다.

------
#### [ AWS CLI ]

**를 사용하여 수명 주기 규칙을 생성하려면 AWS CLI**

1. 다음 콘텐츠`lifecycle-policy.json`로 이름이 인 JSON 파일을 생성합니다.

   자리 표시자 값을 실제 식별자로 바꿉니다.
   + *knowledge-base-id* - 지식 기반 식별자
   + *data-source-id* - 데이터 소스 식별자

   ```
   {
       "Rules": [
           {
               "ID": "TransientDataDeletion",
               "Status": "Enabled",
               "Filter": {
                   "Prefix": "aws/bedrock/knowledge_bases/knowledge-base-id/data-source-id/transient_data"
               },
               "Expiration": {
                   "Days": 1
               }
           }
       ]
   }
   ```

1. 버킷에 수명 주기 정책을 적용합니다. *your-multimodal-storage-bucket*을 실제 버킷 이름으로 바꿉니다.

   ```
   aws s3api put-bucket-lifecycle-configuration \
       --bucket your-multimodal-storage-bucket \
       --lifecycle-configuration file://lifecycle-policy.json
   ```

1. 수명 주기 정책이 적용되었는지 확인합니다.

   ```
   aws s3api get-bucket-lifecycle-configuration \
       --bucket your-multimodal-storage-bucket
   ```

------

Amazon S3 수명 주기 정책에 대한 자세한 내용은 *Amazon S3 사용 설명서*[의 객체 수명 주기 관리를](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html) 참조하세요.

## 성능 고려 사항
<a name="kb-multimodal-performance-considerations"></a>

멀티모달 지식 기반에서 최적의 성능을 얻으려면 다음 요소를 고려하세요.
+ **처리 시간:** 콘텐츠 변환으로 인해 BDA 처리 시간이 더 오래 걸립니다.
+ **쿼리 지연 시간:** 이미지 쿼리는 텍스트 쿼리보다 지연 시간이 길 수 있습니다.
+ **청킹 기간:** 오디오/비디오 청크 기간이 길수록 처리 시간이 늘어나지만 정확도가 향상될 수 있습니다.