기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Kendra 작동 방식
Amazon Kendra 는 애플리케이션에 대한 검색 및 검색 증강 생성(RAG) 기능을 제공합니다. 문서를 직접 또는 타사 문서 리포지토리에서 인덱싱하고 관련 정보를 사용자에게 지능적으로 제공합니다. Amazon Kendra 를 사용하여 다양한 유형의 문서의 업데이트 가능한 인덱스를 생성할 수 있습니다. 에서 지원하는 문서 유형 목록은 문서 유형을 Amazon Kendra참조하세요. [https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html)
Amazon Kendra 는 다른 서비스와 통합됩니다. Amazon Kendra GenAI Enterprise Edition 인덱스를 [Amazon Q Business](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/what-is.html) 및 [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-bedrock.html)에 연결하여 RAG 채팅 솔루션을 생성할 수 있습니다. 또는 Amazon Kendra 검색으로 [Amazon Lex 채팅 봇](https://docs.aws.amazon.com/lexv2/latest/dg/faq-bot-kendra-search.html)을 구동하여 사용자의 질문에 유용한 답변을 제공할 수 있습니다. [Amazon Simple Storage Service 버킷](https://docs.aws.amazon.com/kendra/latest/dg/data-source-s3.html)을의 데이터 소스로 사용하여 문서에 연결하고 인덱싱 Amazon Kendra 할 수도 있습니다.
Amazon Kendra 에는 다음과 같은 구성 요소가 있습니다.
+ 문서를 보관하고 검색할 수 있게 해주는 [인덱스](https://docs.aws.amazon.com//kendra/latest/dg/create-index.html)입니다.**
+ 문서를 저장하고 Amazon Kendra 가 연결하는 [데이터 소스](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html)입니다.** Amazon Kendra 인덱스가 소스 리포지토리로 업데이트된 상태로 유지되도록 데이터 소스를 인덱스와 자동으로 동기화할 수 있습니다.
+ 문서를 인덱스에 직접 추가하는 [문서 추가 API](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-documents.html)입니다.**
+ 입력 쿼리가 주어지면 관련 구절 또는 텍스트 발췌문을 검색하는 [https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html)입니다.
+ 입력 쿼리가 지정된 인덱스를 검색하는 [https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html)입니다.
콘솔 또는 API를 Amazon Kendra 통해를 사용할 수 있습니다. 인덱스를 생성, 업데이트 및 삭제할 수 있습니다. 인덱스를 삭제하면 모든 데이터 소스 커넥터가 삭제되고 모든 문서 정보가 영구적으로 삭제됩니다 Amazon Kendra.
**Topics**
+ [Amazon Kendra의 인덱스](hiw-index.md)
+ [문서](hiw-documents.md)
+ [데이터 소스](hiw-data-source.md)
+ [쿼리](hiw-query.md)
+ [Tags](tagging.md)
# Amazon Kendra의 인덱스
인덱스는 문서의 내용을 담고 있으며 문서를 검색할 수 있는 방식으로 구조화되어 있습니다. 이 섹션에서는 지원되는 인덱스 유형 및 인덱스 기능에 대한 개요를 제공합니다.
**Topics**
+ [Amazon Kendra의 인덱스 유형](hiw-index-types.md)
+ [Amazon Kendra의 인덱스에 문서 추가](hiw-index-adding-docs.md)
+ [Amazon Kendra 예약 또는 공통 문서 필드 사용](index-reserved-fields-hiw.md)
+ [Amazon Kendra에서 인덱스의 응답 검색](index-searching.md)
# Amazon Kendra의 인덱스 유형
Amazon Kendra 에는 GenAI Enterprise Edition 인덱스, Enterprise Edition 인덱스, Developer Edition 인덱스의 세 가지 인덱스 유형이 있습니다. 다음 섹션에서는 각 인덱스의 기능에 대해 설명합니다.
**Topics**
+ [Amazon Kendra GenAI Enterprise Edition 인덱스](#kendra-gen-ai-index)
+ [Amazon Kendra Enterprise Edition 인덱스](#kendra-enterprise-index)
+ [Amazon Kendra Developer Edition 인덱스](#kendra-developer-index)
## Amazon Kendra GenAI Enterprise Edition 인덱스
Amazon Kendra GenAI Enterprise Edition 인덱스는 검색 API 작업 및 검색 증강 생성(RAG) 사용 사례에 가장 높은 정확도를 제공합니다. 하이브리드 검색(키워드 및 벡터), 시멘틱 임베딩, 재평가 모델과 같은 최신 정보 검색 기술로 구동되며 다양한 데이터세트에서 테스트되었습니다. 쿼리 API 작업은 Amazon Kendra Developer Edition 및 Amazon Kendra Enterprise Edition 인덱스와 비교할 때 Amazon Kendra GenAI Enterprise Edition 인덱스에서 유사한 정확도를 제공합니다.
Amazon Kendra GenAI Enterprise Edition 인덱스를 사용하면 AWS 생성형 AI 서비스 전반에서 인덱싱된 데이터를 이동할 수 있습니다. 이 기능을 사용하면 인덱스를 다시 빌드하지 않고도 투자를 원활하게 재사용할 수 있습니다. [Amazon Bedrock 지식 기반](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base.html)에서 관리형 리트리버로 사용하고 이를 에이전트 및 프롬프트 흐름과 같은 Amazon Bedrock 도구와 통합하여 고급 AI 어시스턴트를 구축할 수 있습니다. 완전관리형 디지털 어시스턴트의 경우 [Amazon Q Business](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/what-is.html)와 함께 사용할 수도 있습니다.
Amazon Kendra GenAI Enterprise Edition 인덱스는 다른 두 인덱스 유형에 비해 더 작고 세분화된 용량 단위와 더 낮은 시작 가격을 제공합니다. 이렇게 하면 용량 사용률을 더 효율적으로 높일 수 있습니다.
**참고**
최상의 경험과 정확성을 추구한다면 Amazon Kendra GenAI Enterprise Edition 인덱스를 선택하는 것이 좋습니다.
**Topics**
+ [지원되는 기능](#kendra-gen-ai-index-features)
+ [제한 사항](#genai-index-limitations)
### 지원되는 기능
RAG 사용 사례에 대해 [검색](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) API 작업을 사용하는 경우 Amazon Kendra GenAI Enterprise Edition 인덱스에 대해 다음 기능이 지원됩니다.
+ **전체 지원** - [신뢰도 점수 버킷](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QueryResultItem.html#Kendra-Type-QueryResultItem-ScoreAttributes), [필터링](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html), [패싯](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-facets), [관련성 튜닝](https://docs.aws.amazon.com/kendra/latest/dg/tuning.html), [사용자 지정 문서 보강](https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html), [사용자 지정 메타데이터](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html), [쿼리 용량 및 문서 용량 조정](https://docs.aws.amazon.com/kendra/latest/dg/adjusting-capacity.html)
+ **부분 지원** - [데이터 소스 커넥터](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html) 및 [사용자 컨텍스트 필터링](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html) 부분적으로 지원되는 기능에 대한 자세한 내용은 [제한](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html#genai-index-limitations)을 참조하세요.
검색 사용 사례에 [쿼리](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) API 작업을 사용하는 경우 Amazon Kendra GenAI Enterprise Edition 인덱스에서 다음 기능이 지원됩니다.
+ **전체 지원** - [문서 순위](https://docs.aws.amazon.com/kendra/latest/dg/search-service-rerank.html), [추출 질문 답변](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html), [신뢰도 점수 버킷](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QueryResultItem.html#Kendra-Type-QueryResultItem-ScoreAttributes), [필터링](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html), [패싯](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-facets), [정렬](https://docs.aws.amazon.com/kendra/latest/dg/tuning-sorting-responses.html#sorting-responses), [축소 및 확장 쿼리 결과](https://docs.aws.amazon.com/kendra/latest/dg/expand-collapse-query-results.html), [인덱스 브라우징](https://docs.aws.amazon.com/kendra/latest/dg/browsing.html), [부울 쿼리](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax), [정확한 일치](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax), [와일드카드 쿼리](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax), [쿼리 제안](https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html), [쿼리 맞춤법 검사기](https://docs.aws.amazon.com/kendra/latest/dg/query-spell-check.html), [관련성 튜닝](https://docs.aws.amazon.com/kendra/latest/dg/tuning.html), [증분 학습](https://docs.aws.amazon.com/kendra/latest/dg/submitting-feedback.html), [사용자 지정 문서 보강](https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html), [사용자 지정 메타데이터](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html), [쿼리 용량 및 문서 용량 조정](https://docs.aws.amazon.com/kendra/latest/dg/adjusting-capacity.html), [검색 경험](https://docs.aws.amazon.com/kendra/latest/dg/deploying.html)
+ **부분 지원** - [데이터 소스 커넥터](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html) 및 [사용자 컨텍스트 필터링](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html) 부분적으로 지원되는 기능에 대한 자세한 내용은 [제한](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html#kendra-gen-ai-index)을 참조하세요.
### 제한 사항
다음은 Amazon Kendra GenAI Enterprise Edition 인덱스의 알려진 제한 사항을 간략하게 설명합니다.
+ Amazon Kendra GenAI Enterprise Edition 인덱스는 미국 동부(버지니아 북부) 및 미국 서부(오리건)에서만 사용할 수 있습니다.
+ Amazon Kendra GenAI Enterprise Edition 인덱스는 영어 콘텐츠만 지원합니다.
+ Amazon Kendra GenAI Enterprise Edition 인덱스는 v2.0 Amazon Kendra 데이터 소스 커넥터만 지원합니다.
+ Amazon Kendra GenAI Enterprise Edition 인덱스에서는 [사용자 속성](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-attribute)만 사용하여 사용자 컨텍스트별로 검색 결과를 필터링할 수 있습니다.
+ Amazon Kendra GenAI Enterprise Edition 인덱스는 문서에 대한 [토큰 기반 사용자 액세스 제어](https://docs.aws.amazon.com/kendra/latest/dg/create-index-access-control.html) 또는 [사용자 ID 및 그룹 기반 사용자 액세스 제어](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources)를 지원하지 않습니다.
+ Amazon Kendra GenAI Enterprise Edition 인덱스에서는 [CreateAccessControlConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateAccessControlConfiguration.html) API 작업이 비활성화되었습니다.
+ Amazon Q Business에서 Amazon Kendra GenAI Enterprise Edition 인덱스를 사용하는 경우 문서에 대한 최종 사용자 액세스 제어에 대해 다음 사항에 유의하세요.
Amazon Q Business 는 사용자 이메일 ID를 사용하여 인덱스의 문서에 대한 최종 사용자 액세스를 결정합니다. Amazon Kendra 인덱스를에 연결하면는 최종 사용자를 위한 문서 필터링을 활성화하기 위해 Amazon Kendra에 사용자의 식별 이메일 ID를 Amazon Q Business Amazon Q Business 릴레이합니다. Amazon Kendra 인덱스에 연결된 데이터 소스가 이메일 ID 기반 문서 필터링을 사용하지 않거나 이메일 ID가 없는 경우는 퍼블릭 문서에서만 응답을 Amazon Q Business 생성합니다.
## Amazon Kendra Enterprise Edition 인덱스
Amazon Kendra Enterprise Edition 인덱스는 시맨틱 검색 기능을 제공하고 프로덕션 워크로드에 적합한 고가용성 서비스를 제공합니다.
**Topics**
+ [지원되는 기능](#kendra-ent-index-features)
+ [제한 사항](#ent-index-limitations)
### 지원되는 기능
RAG 사용 사례에 대해 [검색](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) API 작업을 사용하는 경우 Amazon Kendra Enterprise Edition 인덱스에서는 [고급 쿼리 구문](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax)을 사용한 쿼리, 쿼리에 대한 [맞춤법 수정 제안](https://docs.aws.amazon.com/kendra/latest/dg/query-spell-check.html), [패싯](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-facets), 검색 쿼리 자동 완성을 위한 [쿼리 제안](https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html), [증분 학습](https://docs.aws.amazon.com/kendra/latest/dg/submitting-feedback.html) 기능이 지원됩니다.
검색 사용 사례에 [쿼리](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) API 작업을 사용하는 경우 Amazon Kendra Enterprise Edition 인덱스에서는 모든 기능이 지원됩니다.
### 제한 사항
다음은 Amazon Kendra Enterprise Edition 인덱스의 알려진 제한 사항을 간략하게 설명합니다.
+ 에서 Amazon Kendra Enterprise Edition 인덱스를 사용하는 경우 문서에 대한 최종 사용자 액세스 제어에 대해 다음 사항에 Amazon Q Business유의하세요.
Amazon Q Business 는 사용자 이메일 ID를 사용하여 인덱스의 문서에 대한 최종 사용자 액세스를 결정합니다. Amazon Kendra 인덱스를에 연결하면는 최종 사용자를 위한 문서 필터링을 활성화하기 위해 Amazon Kendra에 사용자의 식별 이메일 ID를 Amazon Q Business Amazon Q Business 릴레이합니다. Amazon Kendra 인덱스에 연결된 데이터 소스가 이메일 ID 기반 문서 필터링을 사용하지 않거나 이메일 ID가 없는 경우는 퍼블릭 문서에서만 응답을 Amazon Q Business 생성합니다.
## Amazon Kendra Developer Edition 인덱스
Amazon Kendra Developer Edition 인덱스는 사용 사례를 테스트할 수 있는 시맨틱 검색 기능도 제공합니다. 그러나 프로덕션 사용 사례에는 권장하지 않습니다.
**Topics**
+ [지원되는 기능](#kendra-dev-index-features)
+ [제한 사항](#dev-index-limitations)
### 지원되는 기능
RAG 사용 사례에 대해 [검색](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) API 작업을 사용하는 경우 Amazon Kendra Developer Edition 인덱스에서는 [고급 쿼리 구문](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax)을 사용한 쿼리, 쿼리에 대한 [맞춤법 수정 제안](https://docs.aws.amazon.com/kendra/latest/dg/query-spell-check.html), [패싯](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-facets), 검색 쿼리 자동 완성을 위한 [쿼리 제안](https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html), [증분 학습](https://docs.aws.amazon.com/kendra/latest/dg/submitting-feedback.html) 기능이 지원됩니다.
검색 사용 사례에 [쿼리](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) API 작업을 사용하는 경우 Amazon Kendra Developer Edition 인덱스에서는 모든 기능이 지원됩니다.
### 제한 사항
다음은 Amazon Kendra Developer Edition 인덱스의 알려진 제한 사항을 간략하게 설명합니다.
+ 에서 Amazon Kendra Developer Edition 인덱스를 사용하는 경우 문서에 대한 최종 사용자 액세스 제어에 대해 다음 사항에 Amazon Q Business유의하세요.
Amazon Q Business 는 사용자 이메일 ID를 사용하여 인덱스의 문서에 대한 최종 사용자 액세스를 결정합니다. Amazon Kendra 인덱스를에 연결하면는 최종 사용자를 위한 문서 필터링을 활성화하기 위해 Amazon Kendra에 사용자의 식별 이메일 ID를 Amazon Q Business Amazon Q Business 릴레이합니다. Amazon Kendra 인덱스에 연결된 데이터 소스가 이메일 ID 기반 문서 필터링을 사용하지 않거나 이메일 ID가 없는 경우는 퍼블릭 문서에서만 응답을 Amazon Q Business 생성합니다.
# Amazon Kendra의 인덱스에 문서 추가
인덱스에 문서를 추가하는 방법은 문서를 저장하는 방식에 따라 달라집니다.
+ Amazon S3 버킷 또는 Microsoft SharePoint 사이트와 같은 일종의 리포지토리에 문서를 저장하는 경우 [데이터 소스 커넥터를](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html) 사용하여 리포지토리에서 문서를 인덱싱합니다.
+ 문서를 리포지토리에 저장하지 않는 경우 [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html) API 작업을 사용하여 문서를 직접 인덱싱합니다.
+ Amazon Kendra (Amazon S3) 버킷에 저장해야 하는 FAQ 질문 및 답변의 경우 버킷에서 업로드합니다.
Amazon Kendra 콘솔 AWS CLI, 또는 AWS SDK를 사용하여 인덱스를 생성할 수 있습니다. 인덱싱할 수 있는 문서 유형에 대한 자세한 내용은 [문서 유형](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html)을 참조하세요.
# Amazon Kendra 예약 또는 공통 문서 필드 사용
[UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html) API 작업을 사용하여 예약 또는 공통 필드를 생성할 수 있습니다. 이렇게 하려면를 사용하고 Amazon Kendra 예약 인덱스 필드 이름을 `DocumentMetadataConfigurationUpdates`지정하여 동등한 문서 속성/필드 이름에 매핑합니다. 사용자 지정 필드도 생성할 수 있습니다.
데이터 소스 커넥터를 사용하는 경우 데이터 소스 문서 필드를 Amazon Kendra 인덱스 필드에 매핑하는 필드 매핑이 대부분 포함됩니다. 콘솔을 사용하는 경우 데이터 소스를 선택하고 편집 작업을 선택한 다음 데이터 소스 구성을 위한 필드 매핑 섹션 옆으로 이동하여 필드를 업데이트합니다.
필드를 displayable, facetable, searchable, sortable로 설정하도록 `Search` 객체를 구성할 수 있습니다. 필드의 순위 순서, 부스트 기간 또는 부스팅에 적용할 기간, 최신성, 중요도 값 및 특정 필드 값에 매핑된 중요도 값을 설정하도록 `Relevance` 객체를 구성할 수 있습니다.
콘솔을 사용하는 경우 탐색 메뉴에서 패싯 옵션을 선택하여 필드에 대한 검색 설정을 구성할 수 있습니다. 관련성 조정을 설정하려면 탐색 메뉴에서 인덱스를 검색하는 옵션을 선택하고 쿼리를 입력한 다음 사이드 패널 옵션을 사용하여 검색 관련성을 조정합니다. 필드를 생성한 후에는 필드 유형을 변경할 수 없습니다.
Amazon Kendra에서 사용할 수 있는 예약된 문서 필드 또는 공통 문서 필드는 다음과 같습니다.
+ `_authors` - 문서 내용을 책임지는 1명 이상의 작성자 목록
+ `_category` - 문서를 특정 그룹에 배치하는 범주
+ `_created_at` - 문서가 생성된 ISO 8601 형식의 날짜 및 시간. 예를 들어, 2012-03-25T12:30:10\$101:00은 중부 유럽 시간으로 2012년 3월 25일 오후 12시 30분 10초에 대한 ISO 8601 날짜/시간 형식입니다.
+ `_data_source_id` - 문서가 포함된 데이터 소스의 식별자
+ `_document_body` - 문서의 내용
+ `_document_id` - 문서의 고유 식별자
+ `_document_title` - 문서의 제목
+ `_excerpt_page_number` - 문서 발췌문이 나타나는 PDF 파일의 페이지 번호 2020년 9월 8일 이전에 인덱스를 만든 경우 이 속성을 사용하려면 먼저 문서를 다시 인덱싱해야 합니다.
+ `_faq_id` - 질문-답변 유형 문서(FAQ)인 경우 FAQ의 고유 식별자
+ `_file_type` - 문서의 파일 유형(예: pdf 또는 doc)
+ `_last_updated_at` - 문서가 마지막으로 업데이트된 ISO 8601 형식의 날짜 및 시간. 예를 들어, 2012-03-25T12:30:10\$101:00은 중부 유럽 시간으로 2012년 3월 25일 오후 12시 30분 10초에 대한 ISO 8601 날짜/시간 형식입니다.
+ `_source_uri` - 문서를 사용할 수 있는 URI(예: 회사 웹 사이트의 문서 URI)
+ `_version` - 문서의 특정 버전을 나타내는 식별자
+ `_view_count` - 문서가 조회된 횟수
+ `_language_code`(문자열) - 문서에 적용되는 언어의 코드 언어를 지정하지 않으면 영어가 기본값으로 사용됩니다. 코드를 포함하여 지원되는 언어에 대한 자세한 내용은 [영어 이외의 언어로 문서 추가](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-languages.html)를 참조하세요.
예약 필드 또는 공통 필드를 만들 때와 마찬가지로 `UpdateIndex` API 작업과 `DocumentMetadataConfigurationUpdates`를 사용하여 사용자 지정 필드를 생성합니다. 사용자 지정 필드에 적절한 데이터 유형을 설정해야 합니다.
콘솔을 사용하는 경우 데이터 소스를 선택하고 편집 작업을 선택한 다음 데이터 소스 구성을 위한 필드 매핑 섹션 옆으로 이동하여 필드를 업데이트합니다. 일부 데이터 소스는 새 필드 또는 사용자 지정 필드 추가를 지원하지 않습니다. 필드를 생성한 후에는 필드 유형을 변경할 수 없습니다.
사용자 지정 필드에 설정할 수 있는 유형은 다음과 같습니다.
+ Date
+ 숫자
+ 문자열
+ 문자열 목록
[BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html) API 작업을 사용하여 인덱스에 문서를 추가한 경우, `Attributes`는 문서의 필드/속성을 나열하고 `DocumentAttribute` 객체를 사용하여 필드를 생성합니다.
Amazon S3 데이터 소스에서 인덱싱된 문서의 경우 필드 정보가 포함된 [JSON 메타데이터 파일을](https://docs.aws.amazon.com/kendra/latest/dg/s3-metadata.html) 사용하여 필드를 생성합니다.
지원되는 데이터베이스를 데이터 소스로 사용하는 경우 [필드 매핑 옵션](https://docs.aws.amazon.com/kendra/latest/dg/data-source-database.html#data-source-procedure-database)을 사용하여 필드를 구성할 수 있습니다.
# Amazon Kendra에서 인덱스의 응답 검색
인덱스를 생성한 후 문서 검색을 시작할 수 있습니다.
Amazon Kendra 인덱스를 검색하려면 API [ 검색](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) 작업 또는 [쿼리](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) API 작업을 사용합니다.
검색 API 작업은 검색 증강 생성(RAG) 사용 사례에 적합합니다. 지정된 쿼리의 경우 최대 200개의 토큰 단어로 구성된 의미상 관련된 구절의 순위가 매겨진 문서 목록을 반환합니다. 이를 대규모 언어 모델(LLM)로 전송하여 RAG로 답변을 생성할 수 있습니다. 자세한 내용은 [인덱스 검색](https://docs.aws.amazon.com/kendra/latest/dg/searching.html)을 참조하세요.
쿼리 API 작업은 문서 검색 사용 사례에 가장 적합합니다. 지정된 쿼리의 경우 쿼리와 관련된 100개의 단어 발췌문이 포함된 순위가 매겨진 문서 목록을 반환합니다. 이는 사용자가 순위가 매겨진 문서 목록을 탐색하는 기존 문서 검색 사용 사례에 유용합니다.
각 인덱스 유형에 대해 검색 및 쿼리 API 작업에서 지원되는 기능을 확인하려면 [인덱스 유형](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html)을 참조하세요.
# 문서
이 섹션에서는가 지원하는 여러 문서 형식과 문서의 다양한 필드/속성을 인 Amazon Kendra 덱싱하는 방법을 설명합니다.
**Topics**
+ [문서 유형 또는 형식](#index-document-types)
+ [문서 속성 또는 필드](#hiw-document-attributes)
## 문서 유형 또는 형식
Amazon Kendra 는 PDF, HTML, Word, PowerPoint 등과 같은 널리 사용되는 문서 유형 또는 형식을 지원합니다. 인덱스는 여러 문서 형식을 포함할 수 있습니다.
Amazon Kendra 는 문서를 검색할 수 있도록 문서 내부의 콘텐츠를 추출합니다. 추출된 텍스트와 문서 내의 표 형식 콘텐츠(HTML 테이블)에 대한 검색을 최적화하는 방식으로 문서가 파싱됩니다. 즉, 검색에 사용되는 필드 또는 속성으로 문서를 구조화합니다. 마지막 수정 날짜와 같은 문서 메타데이터는 검색에 유용한 필드가 될 수 있습니다.
문서를 행과 열로 구성할 수 있습니다. 예를 들어, 각 문서는 행이고 각 문서 필드/속성(예: 제목 및 본문 내용)은 열입니다. 예를 들어 데이터베이스를 데이터 소스로 사용하는 경우 데이터는 행과 열로 구조화되거나 구성되어야 합니다.
다음과 같은 방법으로 인덱스에 문서를 추가할 수 있습니다.
+ [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-documents.html) API
+ [데이터 소스 커넥터](https://docs.aws.amazon.com/kendra/latest/dg/data-sources.html)
FAQ 파일을 추가하려면 [CreateFaq](https://docs.aws.amazon.com/kendra/latest/dg/in-creating-faq.html) API를 사용하여 Amazon S3 버킷에 저장된 파일을 추가합니다. 기본 CSV 형식, 헤더에 사용자 지정 필드/속성을 포함하는 CSV 형식, 사용자 지정 필드가 포함된 JSON 형식 중에서 선택할 수 있습니다. 기본 형식은 기본 CSV입니다.
다음은 지원되는 각 문서 형식에 대한 정보와 Amazon Kendra 가 문서를 인덱싱할 때 각 형식을 처리하는 방법에 대한 정보를 제공합니다.
| 문서 형식 | 취급 방식 | 문서 처리 방법 | 원래 구조 |
| --- | --- | --- | --- |
| 휴대용 문서형식(PDF) | HTML | HTML로 변환된 후 내용이 추출됩니다. | 비정형 |
| 하이퍼텍스트 마크업 언어(HTML) | HTML | HTML 태그는 콘텐츠를 추출하기 위해 필터링됩니다. 콘텐츠는 기본 HTML 시작 태그와 종료 태그(content) 사이에 있어야 합니다. | 반구조화 |
| 확장형 마크업 언어(XML) | XML | XML 태그는 콘텐츠를 추출하기 위해 필터링됩니다. | 반구조화 |
| 확장형 스타일시트 언어 변환(XSLT) | XSLT | 태그는 콘텐츠를 추출하기 위해 필터링됩니다. | 반구조화 |
| MarkDown(MD) | 일반 텍스트 | 콘텐츠는 MarkDown 구문이 포함된 상태로 추출됩니다. | 반구조화 |
| 쉼표로 구분된 값(CSV) | CSV | 각 셀에서 추출된 콘텐츠로, 단일 파일은 단일 문서 결과로 처리됩니다. | FAQ 파일은 구조화되고 그 외에는 반정형 |
| Microsoft Excel(XLS 및 XLSX) | XLS 및 XLSX | 각 셀에서 추출된 콘텐츠로, 단일 파일은 단일 문서 결과로 처리됩니다. | 반구조화 |
| JavaScript Object Notation(JSON) | 일반 텍스트 | 콘텐츠는 JSON 구문이 포함된 상태로 추출됩니다. | 반구조화 |
| 서식 있는 텍스트(RTF) | RTF | RTF 구문은 필터링되어 콘텐츠를 추출합니다. | 반구조화 |
| Microsoft PowerPoint(PPT) | PPT, PPTX | PowerPoint 슬라이드에서는 검색 대상 텍스트 내용만 추출됩니다. 이미지 및 기타 콘텐츠는 추출되지 않습니다. | 비정형 |
| Microsoft Word | DOC, DOCX | Word 페이지에서는 검색 대상 텍스트 내용만 추출됩니다. 이미지 및 기타 콘텐츠는 추출되지 않습니다. | 비정형 |
| 일반 텍스트(TXT) | TXT | 텍스트 문서의 모든 텍스트가 추출됩니다. | 비정형 |
## 문서 속성 또는 필드
문서에는 관련 속성 또는 필드가 있습니다. 문서의 필드는 문서의 속성 또는 문서 구조 내에 포함된 내용입니다. 예를 들어, 각 문서에는 제목, 본문 텍스트, 작성자가 포함될 수 있습니다. 특정 문서에 대한 사용자 지정 필드를 추가할 수도 있습니다. 예를 들어 인덱스가 세금 문서를 검색하는 경우 세금 문서 유형에 대한 사용자 지정 필드를 지정할 수 있습니다(예: W-2, 1099 등).
쿼리에서 문서 필드를 사용하려면 먼저 인덱스 필드에 매핑되어야 합니다. 예를 들어 제목 필드를 `_document_title` 필드에 매핑될 수 있습니다. 자세한 내용을 알아보려면 [필드 매핑](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html)을 참조하세요. 새 필드를 추가하려면 필드를 매핑할 인덱스 필드를 만들어야 합니다. 콘솔을 사용하거나 [UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html) API를 사용하여 인덱스 필드를 생성합니다.
문서 필드를 사용하여 응답을 필터링하고 패싯된 검색 결과를 만들 수 있습니다. 예를 들어 특정 버전의 문서만 반환하도록 응답을 필터링하거나 검색어와 일치하는 1099 유형의 세금 문서만 반환하도록 검색을 필터링할 수 있습니다. 자세한 내용은 [필터링 및 패싯 검색](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html)을 참조하세요.
문서 필드를 사용하여 쿼리 응답을 수동으로 조정할 수도 있습니다. 예를 들어 제목 필드의 중요도를 높여 응답에 반환할 문서를 결정할 때가 필드에 Amazon Kendra 할당하는 가중치를 늘리도록 선택할 수 있습니다. 자세한 내용은 [검색 관련성 조정](https://docs.aws.amazon.com/kendra/latest/dg/tuning.html)을 참조하세요.
문서를 인덱스에 직접 추가하는 경우 [문서](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Document.html) 입력 파라미터의 필드를 [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html) API에 지정합니다. [DocumentAttribute](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DocumentAttribute.html) 객체 배열에 사용자 지정 필드 값을 지정합니다. 데이터 소스를 사용하는 경우 문서 필드를 추가하는 데 사용하는 방법은 데이터 소스에 따라 달라집니다. 자세한 내용을 알아보려면 [데이터 소스 필드 매핑](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html)을 참조하세요.
### Amazon Kendra 예약 또는 공통 문서 필드 사용
[UpdateIndex API](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html)를 사용하면 `DocumentMetadataConfigurationUpdates`를 사용하고 Amazon Kendra 예약 인덱스 필드 이름을 지정하여 예약된 필드 또는 공통 필드를 생성하여 동등한 문서 속성/필드 이름에 매핑할 수 있습니다. 사용자 지정 필드도 생성할 수 있습니다. 데이터 소스 커넥터를 사용하는 경우 데이터 소스 문서 필드를 Amazon Kendra 인덱스 필드에 매핑하는 필드 매핑이 대부분 포함됩니다. 콘솔을 사용하는 경우 데이터 소스를 선택하고 편집 작업을 선택한 다음 데이터 소스 구성을 위한 필드 매핑 섹션 옆으로 이동하여 필드를 업데이트합니다.
필드를 displayable, facetable, searchable, sortable로 설정하도록 `Search` 객체를 구성할 수 있습니다. 필드의 순위 순서, 부스트 기간 또는 부스팅에 적용할 기간, 최신성, 중요도 값 및 특정 필드 값에 매핑된 중요도 값을 설정하도록 `Relevance` 객체를 구성할 수 있습니다. 콘솔을 사용하는 경우 탐색 메뉴에서 패싯 옵션을 선택하여 필드에 대한 검색 설정을 지정할 수 있습니다. 관련성 조정을 설정하려면 탐색 메뉴에서 인덱스를 검색하는 옵션을 선택하고 쿼리를 입력한 다음 사이드 패널 옵션을 사용하여 검색 관련성을 조정합니다. 필드를 생성한 후에는 필드 유형을 변경할 수 없습니다.
Amazon Kendra 에는 사용할 수 있는 다음과 같은 예약 또는 공통 문서 필드가 있습니다.
+ `_authors` - 문서 내용을 책임지는 한 명 이상의 작성자 목록.
+ `_category` - 문서를 특정 그룹에 배치하는 범주.
+ `_created_at` - 문서가 생성된 ISO 8601 형식의 날짜 및 시간. 예를 들어, 2012-03-25T12:30:10\$101:00은 중부 유럽 시간으로 2012년 3월 25일 오후 12시 30분 10초에 대한 ISO 8601 날짜/시간 형식입니다.
+ `_data_source_id` - 문서가 포함된 데이터 소스의 식별자.
+ `_document_body` - 작업 문서의 내용.
+ `_document_id` - 문서의 고유 식별자.
+ `_document_title` - 문서의 제목.
+ `_excerpt_page_number` - 문서 발췌문이 나타나는 PDF 파일의 페이지 번호. 2020년 9월 8일 이전에 인덱스를 만든 경우 이 속성을 사용하려면 먼저 문서를 다시 인덱싱해야 합니다.
+ `_faq_id` - 질문-답변 유형 문서(FAQ)인 경우 FAQ의 고유 식별자.
+ `_file_type` - 문서의 파일 형식(예: pdf 또는 doc).
+ `_last_updated_at` - 문서가 마지막으로 업데이트된 ISO 8601 형식의 날짜 및 시간. 예를 들어, 2012-03-25T12:30:10\$101:00은 중부 유럽 시간으로 2012년 3월 25일 오후 12시 30분 10초에 대한 ISO 8601 날짜/시간 형식입니다.
+ `_source_uri` - 문서가 제공된 URI. 예를 들면, 회사 웹 사이트에 있는 문서의 URI.
+ `_version` - 문서의 특정 버전을 나타내는 식별자.
+ `_view_count` - 문서가 조회된 횟수.
+ `_language_code`(문자열) - 문서에 적용되는 언어의 코드. 언어를 지정하지 않으면 영어가 기본값으로 사용됩니다. 코드를 포함하여 지원되는 언어에 대한 자세한 내용은 [영어 이외의 언어로 문서 추가](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-languages.html)를 참조하세요.
사용자 지정 필드의 경우 예약된 필드 또는 공통 필드를 만들 때와 마찬가지로 `UpdateIndex` API와 `DocumentMetadataConfigurationUpdates`를 사용하여 이러한 필드를 만듭니다. 사용자 지정 필드에 적절한 데이터 유형을 설정해야 합니다. 콘솔을 사용하는 경우 데이터 소스를 선택하고 편집 작업을 선택한 다음 데이터 소스 구성을 위한 필드 매핑 섹션 옆으로 이동하여 필드를 업데이트합니다. 일부 데이터 소스는 새 필드 또는 사용자 지정 필드 추가를 지원하지 않습니다. 필드를 생성한 후에는 필드 유형을 변경할 수 없습니다.
사용자 지정 필드에 설정할 수 있는 유형은 다음과 같습니다.
+ Date
+ 숫자
+ 문자열
+ 문자열 목록
[BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html) API를 사용하여 인덱스에 문서를 추가한 경우, `Attributes`는 문서의 필드/속성을 나열하고 `DocumentAttribute` 객체를 사용하여 필드를 생성합니다.
Amazon S3 데이터 소스에서 인덱싱된 문서의 경우 필드 정보가 포함된 [JSON 메타데이터 파일을](https://docs.aws.amazon.com/kendra/latest/dg/s3-metadata.html) 사용하여 필드를 생성합니다.
지원되는 데이터베이스를 데이터 소스로 사용하는 경우 [필드 매핑 옵션](https://docs.aws.amazon.com/kendra/latest/dg/data-source-database.html#data-source-procedure-database)을 사용하여 필드를 구성할 수 있습니다.
# 데이터 소스
데이터 소스는 문서 또는 콘텐츠에 Amazon Kendra 연결하고 인덱싱하는 데이터 리포지토리 또는 위치입니다. 예를 들어 Microsoft SharePoint에 연결하여이 소스에 저장된 문서를 크롤링하고 인덱싱 Amazon Kendra 하도록를 구성할 수 있습니다. 가 크롤링할 URLs 제공하여 웹 페이지를 인덱싱 Amazon Kendra 할 수도 있습니다. 데이터 소스를 Amazon Kendra 인덱스와 자동으로 동기화하여 데이터 소스의 추가, 업데이트 또는 삭제된 문서도 인덱스에 추가, 업데이트 또는 삭제되도록 할 수 있습니다.
지원되는 데이터 소스:
+ [Adobe Experience Manager](https://docs.aws.amazon.com/kendra/latest/dg/data-source-aem.html)
+ [Alfresco](https://docs.aws.amazon.com/kendra/latest/dg/data-source-alfresco.html)
+ [Aurora (MySQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-aurora-mysql.html)
+ [Aurora (PostgreSQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-aurora-postgresql.html)
+ [Amazon FSx (Windows)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-fsx.html)
+ [Amazon FSx (NetApp ONTAP)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-fsx-ontap.html)
+ [데이터베이스 데이터 소스](https://docs.aws.amazon.com/kendra/latest/dg/data-source-database.html)
+ [Amazon RDS (Microsoft SQL Server)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-ms-sql-server.html)
+ [Amazon RDS (MySQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-mysql.html)
+ [Amazon RDS (Oracle)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-oracle.html)
+ [Amazon RDS (PostgreSQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-postgresql.html)
+ [Amazon S3 버킷](https://docs.aws.amazon.com/kendra/latest/dg/data-source-s3.html)
+ [Amazon Kendra 웹 크롤러](https://docs.aws.amazon.com/kendra/latest/dg/data-source-web-crawler.html)
+ [Box](https://docs.aws.amazon.com/kendra/latest/dg/data-source-box.html)
+ [Confluence](https://docs.aws.amazon.com/kendra/latest/dg/data-source-confluence.html)
+ [사용자 지정 데이터 소스](https://docs.aws.amazon.com/kendra/latest/dg/data-source-custom.html)
+ [Dropbox](https://docs.aws.amazon.com/kendra/latest/dg/data-source-dropbox.html)
+ [Drupal](https://docs.aws.amazon.com/kendra/latest/dg/data-source-drupal.html)
+ [GitHub](https://docs.aws.amazon.com/kendra/latest/dg/data-source-github.html)
+ [Gmail](https://docs.aws.amazon.com/kendra/latest/dg/data-source-gmail.html)
+ [Google Workspace Drives](https://docs.aws.amazon.com/kendra/latest/dg/data-source-google-drive.html)
+ [IBM DB2](https://docs.aws.amazon.com/kendra/latest/dg/data-source-ibm-db2.html)
+ [Jira](https://docs.aws.amazon.com/kendra/latest/dg/data-source-jira.html)
+ [Microsoft Exchange](https://docs.aws.amazon.com/kendra/latest/dg/data-source-exchange.html)
+ [Microsoft OneDrive](https://docs.aws.amazon.com/kendra/latest/dg/data-source-onedrive.html)
+ [Microsoft SharePoint](https://docs.aws.amazon.com/kendra/latest/dg/data-source-sharepoint.html)
+ [Microsoft Teams](https://docs.aws.amazon.com/kendra/latest/dg/data-source-teams.html)
+ [Microsoft SQL Server](https://docs.aws.amazon.com/kendra/latest/dg/data-source-ms-sql-server.html)
+ [Microsoft Yammer](https://docs.aws.amazon.com/kendra/latest/dg/data-source-yammer.html)
+ [MySQL](https://docs.aws.amazon.com/kendra/latest/dg/data-source-mysql.html)
+ [Oracle Database](https://docs.aws.amazon.com/kendra/latest/dg/data-source-oracle-database.html)
+ [PostgreSQL](https://docs.aws.amazon.com/kendra/latest/dg/data-source-postgresql.html)
+ [Quip](https://docs.aws.amazon.com/kendra/latest/dg/data-source-quip.html)
+ [Salesforce](https://docs.aws.amazon.com/kendra/latest/dg/data-source-salesforce.html)
+ [ServiceNow](https://docs.aws.amazon.com/kendra/latest/dg/data-source-servicenow.html)
+ [Slack](https://docs.aws.amazon.com/kendra/latest/dg/data-source-slack.html)
+ [Zendesk](https://docs.aws.amazon.com/kendra/latest/dg/data-source-zendesk.html)
에서 지원하는 문서 유형 또는 형식 목록은 [문서 유형을](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html) Amazon Kendra 참조하세요. 데이터 소스에서 문서를 인덱싱할 데이터 소스 커넥터를 만들기 전에 먼저 인덱스를 만들어야 합니다.
**참고**
문서의 인덱스를 만들려면 데이터 소스를 사용할 필요가 없습니다. 배치 업로드를 사용하여 인덱스에 직접 문서를 추가할 수 있습니다. 자세한 내용은 [인덱스에 직접 문서 추가](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-documents.html)를 참조하세요.
Amazon Kendra 콘솔, CLI 또는 SDK 사용에 대한 연습은 [시작하기](https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html)를 AWS 참조하세요. SDKs
# 쿼리
답을 얻기 위해 사용자는 인덱스를 쿼리합니다. 사용자는 쿼리에 자연어를 사용할 수 있습니다. 응답에는 제목, 텍스트 발췌문, 인덱스에서 가장 좋은 답변을 제공하는 문서의 위치 등의 정보가 포함됩니다.
Amazon Kendra 는 문서의 내용뿐만 아니라 문서에 대해 제공하는 모든 정보를 사용하여 문서가 쿼리와 관련이 있는지 여부를 결정합니다. 예를 들어, 인덱스에 문서가 마지막으로 업데이트된 시기에 대한 정보가 포함된 경우 최근에 업데이트된 문서에 더 높은 관련성을 할당 Amazon Kendra 하도록에 지시할 수 있습니다.
쿼리에는가 필터 기준을 충족하는 문서만 Amazon Kendra 반환하도록 응답을 필터링하는 방법에 대한 기준도 포함될 수 있습니다. 예를 들어 부서라는 인덱스 필드를 만든 경우 부서 필드가 합법으로 설정된 문서만 반환되도록 응답을 필터링할 수 있습니다.**** 자세한 내용은 [검색 필터링](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html)을 참조하세요.
인덱스에 있는 개별 필드의 관련성을 조정하여 쿼리 결과에 영향을 줄 수 있습니다. 조정은 결과에서 필드의 중요도를 변경합니다. 예를 들어, 새로운 범주 문서의 중요도를 높이면 이 범주의 문서가 응답에 포함될 가능성이 높아집니다.** 자세한 내용은 [검색 관련성 조정](https://docs.aws.amazon.com/kendra/latest/dg/tuning.html)을 참조하세요.
쿼리 사용에 대한 자세한 내용은 [인덱스 검색](https://docs.aws.amazon.com/kendra/latest/dg/searching.html)을 참조하세요.
# Tags
태그나 레이블을 할당하여 인덱스, 데이터 소스, FAQ를 관리합니다. 태그를 사용하여 Amazon Kendra 리소스를 다양한 방식으로 분류할 수 있습니다. 예를 들어 용도별, 소유자별 또는 애플리케이션별 또는 몇 가지의 조합. 각 태그는 사용자가 정의하는 *키*와 *값*으로 구성됩니다.
태그를 통해 다음 작업을 수행할 수 있습니다.
+ AWS 리소스를 식별하고 구성합니다. 많은 AWS 서비스가 태그 지정을 지원하므로 서로 다른 서비스의 리소스에 동일한 태그를 할당하여 리소스가 관련이 있음을 나타낼 수 있습니다. 예를 들어 인덱스와 인덱스를 사용하는 Amazon Lex 봇에 동일한 태그를 지정할 수 있습니다.
+ 비용을 할당합니다. AWS 결제 및 비용 관리 대시보드에서 태그를 활성화합니다. AWS 는 태그를 사용하여 비용을 분류하고 월별 비용 할당 보고서를 제공합니다. 자세한 내용은 * AWS 결제* [및 비용 관리 정보에서 비용 할당 및 태그 지정](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)을 참조하세요.
+ 리소스에 대한 액세스를 제어합니다. AWS Identity and Access Management (IAM) 정책의 태그를 사용하여 Amazon Kendra 리소스에 대한 액세스를 제어할 수 있습니다. 이러한 정책을 IAM 역할 또는 사용자에게 연결하여 태그 기반 액세스 제어를 활성화할 수 있습니다. 자세한 내용은 [태그 기반 권한 부여](https://docs.aws.amazon.com/kendra/latest/dg/security_iam_service-with-iam.html#security_iam_service-with-iam-tags)를 참조하세요.
AWS Management Console, AWS Command Line Interface (AWS CLI) 또는 Amazon Kendra API를 사용하여 태그를 생성하고 관리할 수 있습니다.
## 리소스에 태그 지정
Amazon Kendra 콘솔을 사용하는 경우 리소스를 생성하거나 나중에 추가할 때 리소스에 태그를 지정할 수 있습니다. 이 콘솔을 사용하여 태그를 업데이트하거나 제거할 수도 있습니다.
AWS Command Line Interface (AWS CLI) 또는 Amazon Kendra API를 사용하는 경우 다음 작업을 사용하여 리소스에 대한 태그를 관리합니다.
+ [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html) - 데이터 소스를 생성할 때 태그를 적용합니다.
+ [CreateFaq](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateFaq.html) - FAQ를 생성할 때 태그를 적용합니다.
+ [CreateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateIndex.html) - 인덱스를 생성할 때 태그를 적용합니다.
+ [ListTagsForResource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ListTagsForResource.html) - 리소스와 연결된 태그를 봅니다.
+ [TagResource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TagResource.html) - 리소스의 태그를 추가하고 수정합니다.
+ [UntagResource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UntagResource.html) - 리소스에서 태그를 제거합니다.
## 태그 제한 사항
Amazon Kendra 리소스의 태그에는 다음 제한이 적용됩니다.
+ 최대 태그 수 - 50
+ 최대 키 길이 - 128자
+ 최대 값 길이 - 256자
+ 키 및 값에 사용할 수 있는 문자: a-z, A-Z, 공백 및 \$1 . : / = \$1 - @ 문자
+ 키와 값은 대/소문자를 구분합니다.
+ 키 접두사로 `aws:`를 사용하지 마세요. AWS 전용입니다.