As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Como Amazon Kendra funciona
Amazon Kendra fornece funcionalidade de pesquisa e recuperação de geração aumentada (RAG) para seu aplicativo. Ele indexa seus documentos diretamente, ou do repositório de documentos de terceiros, e fornece informações relevantes de forma inteligente para os usuários. Você pode usar Amazon Kendra para criar um índice atualizável de documentos de vários tipos. Para obter uma lista dos tipos de documentos compatíveis com Amazon Kendra, consulte [Tipos de documentos](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html).
Amazon Kendra se integra a outros serviços. É possível conectar um índice do Amazon Kendra GenAI Enterprise Edition ao [Amazon Q Business](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/what-is.html) e ao [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-bedrock.html) para criar sua solução de chat de RAG. Ou você pode potencializar [os bots de Amazon Lex bate-papo](https://docs.aws.amazon.com/lexv2/latest/dg/faq-bot-kendra-search.html) com a Amazon Kendra pesquisa para fornecer respostas úteis às perguntas dos usuários. Você também pode usar um [Amazon Simple Storage Service bucket](https://docs.aws.amazon.com/kendra/latest/dg/data-source-s3.html) como fonte de dados Amazon Kendra para se conectar e indexar seus documentos.
Amazon Kendra tem os seguintes componentes:
+ Um [https://docs.aws.amazon.com//kendra/latest/dg/create-index.html](https://docs.aws.amazon.com//kendra/latest/dg/create-index.html) que contém os documentos e os torna pesquisáveis.
+ Uma [https://docs.aws.amazon.com/kendra/latest/dg/data-source.html](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html) que armazena os documentos e Amazon Kendra se conecta a. Você pode sincronizar automaticamente uma fonte de dados com um Amazon Kendra índice para que seu índice permaneça atualizado com o repositório de origem.
+ Uma [https://docs.aws.amazon.com/kendra/latest/dg/in-adding-documents.html](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-documents.html) que adiciona documentos diretamente a um índice.
+ Uma [https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) que recupera passagens ou trechos relevantes do texto de acordo com uma consulta de entrada.
+ Uma [https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) que pesquisa um índice com base em uma consulta de entrada.
Você pode usar Amazon Kendra por meio do console ou da API. É possível criar, editar e excluir índices. A exclusão de um índice exclui todos os conectores da fonte de dados e exclui permanentemente todas as informações do documento. Amazon Kendra
**Topics**
+ [Índices no Amazon Kendra](hiw-index.md)
+ [Documentos](hiw-documents.md)
+ [Fontes de dados](hiw-data-source.md)
+ [Consultas](hiw-query.md)
+ [Tags](tagging.md)
# Índices no Amazon Kendra
Um índice contém o conteúdo dos documentos e é estruturado de forma a tornar os documentos pesquisáveis. Essa seção fornece uma visão geral dos tipos de índice e dos atributos de índice compatíveis.
**Topics**
+ [Tipos de índice no Amazon Kendra](hiw-index-types.md)
+ [Adicionar documentos a um índice no Amazon Kendra](hiw-index-adding-docs.md)
+ [Usando campos de documentos Amazon Kendra reservados ou comuns](index-reserved-fields-hiw.md)
+ [Recuperar respostas de índices no Amazon Kendra](index-searching.md)
# Tipos de índice no Amazon Kendra
Amazon Kendra tem três tipos de índice: índice GenAI Enterprise Edition, índice Enterprise Edition e índice Developer Edition. As seções a seguir descrevem os principais recursos de cada índice.
**Topics**
+ [Índice do Amazon Kendra GenAI Enterprise Edition](#kendra-gen-ai-index)
+ [Índice do Amazon Kendra Enterprise Edition](#kendra-enterprise-index)
+ [Índice do Amazon Kendra Developer Edition](#kendra-developer-index)
## Índice do Amazon Kendra GenAI Enterprise Edition
Um índice do Amazon Kendra GenAI Enterprise Edition oferece a mais alta precisão para a operação da API de recuperação e para casos de uso de geração aumentada via recuperação (RAG). Ele é desenvolvido pelas mais recentes tecnologias de recuperação de informações, como pesquisa híbrida (palavra-chave e vetor), incorporação semântica e modelos de reclassificação, e foi testado em uma variedade de conjuntos de dados. A operação da API de consulta proporciona uma precisão semelhante para um índice do Amazon Kendra GenAI Enterprise Edition quando comparada com os índices do Amazon Kendra Developer Edition e do Amazon Kendra Enterprise Edition.
Um índice Amazon Kendra GenAI Enterprise Edition permite a mobilidade de seus dados indexados entre serviços generativos de IA. AWS Com essa funcionalidade, é possível reutilizar facilmente seus investimentos sem precisar recriar índices. Você pode usá-la em uma [base de conhecimento do Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base.html) como recuperador gerenciado e integrá-la às ferramentas do Amazon Bedrock, como agentes e fluxos de prompt, para criar assistentes de IA avançados. Também é possível usá-lo com o [Amazon Q Business](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/what-is.html), como um assistente digital totalmente gerenciado.
Um índice do Amazon Kendra GenAI Enterprise Edition oferece unidades de capacidade menores e mais granulares, bem como um preço inicial mais baixo em comparação com os outros dois tipos de índice. Isso torna a utilização da capacidade mais eficiente.
**nota**
Para ter a melhor experiência e precisão, recomendamos que você escolha um índice do Amazon Kendra GenAI Enterprise Edition.
**Topics**
+ [Recursos compatíveis](#kendra-gen-ai-index-features)
+ [Limitações](#genai-index-limitations)
### Recursos compatíveis
Os seguintes recursos são compatíveis com um índice do Amazon Kendra GenAI Enterprise Edition caso você use a operação da API [Retrieve](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) para casos de uso de RAG:
+ **Suporte completo**: [buckets de pontuação de confiança](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QueryResultItem.html#Kendra-Type-QueryResultItem-ScoreAttributes), [filtragem](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html), [facetamento](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-facets), [ajuste de relevância](https://docs.aws.amazon.com/kendra/latest/dg/tuning.html), [enriquecimento personalizado de documentos](https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html), [metadados personalizados](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html) e [ajuste da capacidade de consulta e da capacidade do documento](https://docs.aws.amazon.com/kendra/latest/dg/adjusting-capacity.html).
+ **Suporte parcial**: [conectores de fonte de dados](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html) e [filtragem de contexto do usuário](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html). Consulte mais informações sobre os recursos parcialmente compatíveis em [Limitações](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html#genai-index-limitations).
Os seguintes recursos são compatíveis com um índice do Amazon Kendra GenAI Enterprise Edition caso você use a operação da API [Query](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) para casos de uso de pesquisa:
+ **Suporte completo**: [classificação de documentos](https://docs.aws.amazon.com/kendra/latest/dg/search-service-rerank.html), [resposta extrativa a perguntas](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html), [buckets de pontuação de confiança](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QueryResultItem.html#Kendra-Type-QueryResultItem-ScoreAttributes), [filtragem](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html), [facetagem](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-facets), [classificação](https://docs.aws.amazon.com/kendra/latest/dg/tuning-sorting-responses.html#sorting-responses), [redução e expansão dos resultados da consulta](https://docs.aws.amazon.com/kendra/latest/dg/expand-collapse-query-results.html), [navegação por índices](https://docs.aws.amazon.com/kendra/latest/dg/browsing.html), [consultas booleanas](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax), [correspondência exata](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax), [consultas com curingas](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax), [sugestões de consultas](https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html), [corretor ortográfico de consultas](https://docs.aws.amazon.com/kendra/latest/dg/query-spell-check.html), [ajuste de relevância](https://docs.aws.amazon.com/kendra/latest/dg/tuning.html), [aprendizado incremental](https://docs.aws.amazon.com/kendra/latest/dg/submitting-feedback.html), [enriquecimento personalizado de documentos](https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html), [metadados personalizados](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html), [ajuste da capacidade de consulta e da capacidade de documento](https://docs.aws.amazon.com/kendra/latest/dg/adjusting-capacity.html) e [experiência de pesquisa](https://docs.aws.amazon.com/kendra/latest/dg/deploying.html).
+ **Suporte parcial**: [conectores de fonte de dados](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html) e [filtragem de contexto do usuário](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html). Consulte mais informações sobre os recursos parcialmente compatíveis em [Limitações](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html#kendra-gen-ai-index).
### Limitações
O conteúdo a seguir destaca as limitações conhecidas de um índice do Amazon Kendra GenAI Enterprise Edition:
+ Índices do Amazon Kendra GenAI Enterprise Edition estão disponíveis somente nas regiões Leste dos EUA (Norte da Virgínia) e Oeste dos EUA (Oregon).
+ Os índices do Amazon Kendra GenAI Enterprise Edition são compatíveis somente com conteúdo em inglês.
+ Os índices do Amazon Kendra GenAI Enterprise Edition são compatíveis somente com os conectores de fonte de dados do Amazon Kendra v2.0.
+ Em um índice do Amazon Kendra GenAI Enterprise Edition, você pode usar somente [atributos do usuário](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-attribute) para filtrar os resultados da pesquisa por contexto do usuário.
+ Os índices do Amazon Kendra GenAI Enterprise Edition não são compatíveis com o [controle de acesso de usuário baseado em tokens](https://docs.aws.amazon.com/kendra/latest/dg/create-index-access-control.html) nem com o [controle de acesso de usuário baseado em grupo e ID de usuário](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) para documentos.
+ A operação da [CreateAccessControlConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateAccessControlConfiguration.html)API está desativada para os índices do Amazon Kendra GenAI Enterprise Edition.
+ Se você estiver usando um índice do Amazon Kendra GenAI Enterprise Edition com o Amazon Q Business, observe o seguinte sobre o controle do acesso do usuário final aos documentos:
Amazon Q Business usa o ID de e-mail do usuário para determinar o acesso do usuário final aos documentos em um índice. Quando você conecta um índice do Amazon Kendra Amazon Q Business ao Amazon Q Business , retransmite o ID de e-mail de identificação do usuário para o Amazon Kendra para permitir a filtragem de documentos para usuários finais. Se as fontes de dados conectadas ao seu índice do Amazon Kendra não usarem a filtragem de documentos baseada em ID de e-mail ou se a ID de e-mail não estiver presente Amazon Q Business , gerará respostas somente de documentos públicos.
## Índice do Amazon Kendra Enterprise Edition
Um índice do Amazon Kendra Enterprise Edition fornece recursos de pesquisa semântica e oferece um serviço de alta disponibilidade adequado para workloads de produção.
**Topics**
+ [Recursos compatíveis](#kendra-ent-index-features)
+ [Limitações](#ent-index-limitations)
### Recursos compatíveis
Os seguintes recursos são compatíveis com um índice do Amazon Kendra Enterprise Edition caso você esteja usando a operação de API [Retrieve](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) para casos de uso de RAG: consultas usando [sintaxe de consulta avançada](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax), [correções ortográficas sugeridas](https://docs.aws.amazon.com/kendra/latest/dg/query-spell-check.html) para consultas, [facetagem](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-facets), [sugestões de consultas](https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html) para preencher consultas de pesquisa automaticamente e [aprendizado incremental](https://docs.aws.amazon.com/kendra/latest/dg/submitting-feedback.html).
Todos os recursos são compatíveis com um índice do Amazon Kendra Enterprise Edition caso você use a operação da API [Query](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) para casos de uso de pesquisa.
### Limitações
Veja a seguir uma descrição das limitações conhecidas de um índice do Amazon Kendra Enterprise Edition:
+ Se você estiver usando um índice do Amazon Kendra Enterprise Edition Amazon Q Business com, observe o seguinte sobre o controle do acesso do usuário final aos documentos:
Amazon Q Business usa o ID de e-mail do usuário para determinar o acesso do usuário final aos documentos em um índice. Quando você conecta um índice do Amazon Kendra Amazon Q Business ao Amazon Q Business , retransmite o ID de e-mail de identificação do usuário para o Amazon Kendra para permitir a filtragem de documentos para usuários finais. Se as fontes de dados conectadas ao seu índice do Amazon Kendra não usarem a filtragem de documentos baseada em ID de e-mail ou se a ID de e-mail não estiver presente Amazon Q Business , gerará respostas somente de documentos públicos.
## Índice do Amazon Kendra Developer Edition
Um índice do Amazon Kendra Developer Edition também oferece recursos de pesquisa semântica para você testar seus casos de uso. No entanto, não recomendamos usá-lo em casos de uso de produção.
**Topics**
+ [Recursos compatíveis](#kendra-dev-index-features)
+ [Limitações](#dev-index-limitations)
### Recursos compatíveis
Os seguintes recursos são compatíveis com um índice do Amazon Kendra Developer Edition caso você esteja usando a operação de API [Retrieve](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) para casos de uso de RAG: consultas usando [sintaxe de consulta avançada](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax), [correções ortográficas sugeridas](https://docs.aws.amazon.com/kendra/latest/dg/query-spell-check.html) para consultas, [facetagem](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-facets), [sugestões de consultas](https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html) para preencher consultas de pesquisa automaticamente e [aprendizado incremental](https://docs.aws.amazon.com/kendra/latest/dg/submitting-feedback.html).
Todos os recursos são compatíveis com um índice do Amazon Kendra Developer Edition caso você use a operação da API [Query](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) para casos de uso de pesquisa.
### Limitações
Veja a seguir uma descrição das limitações conhecidas de um índice do Amazon Kendra Developer Edition:
+ Se você estiver usando um índice do Amazon Kendra Developer Edition Amazon Q Business com, observe o seguinte sobre o controle do acesso do usuário final aos documentos:
Amazon Q Business usa o ID de e-mail do usuário para determinar o acesso do usuário final aos documentos em um índice. Quando você conecta um índice do Amazon Kendra Amazon Q Business ao Amazon Q Business , retransmite o ID de e-mail de identificação do usuário para o Amazon Kendra para permitir a filtragem de documentos para usuários finais. Se as fontes de dados conectadas ao seu índice do Amazon Kendra não usarem a filtragem de documentos baseada em ID de e-mail ou se a ID de e-mail não estiver presente Amazon Q Business , gerará respostas somente de documentos públicos.
# Adicionar documentos a um índice no Amazon Kendra
A forma como você adiciona documentos a um índice depende de como você armazena os documentos.
+ Se você armazenar seus documentos em algum tipo de repositório, como um Amazon S3 bucket ou um SharePoint site da Microsoft, você usa um [conector de fonte de dados](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html) para indexar seus documentos do seu repositório.
+ Se você não armazena seus documentos em um repositório, você usa a operação de [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API para indexar diretamente seus documentos.
+ Para perguntas e respostas de perguntas frequentes, que devem ser armazenadas em um bucket Amazon Kendra (Amazon S3), você as carrega do bucket.
Você pode criar índices com o Amazon Kendra console AWS CLI, o ou um AWS SDK. Para obter informações sobre os tipos de documentos que podem ser indexados, consulte [Tipos de documentos](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html).
# Usando campos de documentos Amazon Kendra reservados ou comuns
Com a operação [UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html)da API, você pode criar campos reservados ou comuns. Para fazer isso, você usa `DocumentMetadataConfigurationUpdates` e especifica o nome do campo de índice Amazon Kendra reservado para mapear para o attribute/field nome do documento equivalente. Você também pode criar campos personalizados.
Se você usa um conector de fonte de dados, a maioria inclui mapeamentos de campo que mapeiam os campos do documento da fonte de dados para campos de Amazon Kendra índice. Se usar o console, atualize os campos selecionando a fonte de dados, a ação de edição e, em seguida, prosseguindo para a seção de mapeamentos de campo para configurar a fonte de dados.
Você pode configurar o objeto `Search` para definir um campo como exibível, facetável, pesquisável e classificável. Configure o objeto `Relevance` para definir a ordem de classificação, a duração do aumento ou o período de tempo de um campo a ser aplicado ao aumento, à atualização, ao valor de importância e aos valores de importância mapeados para valores de campo específicos.
Se usar o console, defina as configurações de pesquisa de um campo selecionando a opção de faceta no menu de navegação. Para definir o ajuste de relevância, selecione a opção de pesquisar o índice no menu de navegação, insira uma consulta e use as opções do painel lateral para ajustar a relevância da pesquisa. Você não pode alterar o tipo de campo depois de criar o campo.
O Amazon Kendra tem os seguintes campos de documento reservados ou comuns que podem ser usados:
+ `_authors`: uma lista de um ou mais autores responsáveis pelo conteúdo do documento.
+ `_category`: uma categoria que coloca um documento em um grupo específico.
+ `_created_at`: a data e a hora no formato ISO 8601 em que o documento foi criado. Por exemplo, 2012-03-25T12:30:10\$101:00 é o formato de data e hora ISO 8601 para 25 de março de 2012 às 12h30 (mais 10 segundos) no horário da Europa Central.
+ `_data_source_id`: o identificador da fonte de dados que contém o documento.
+ `_document_body`: o conteúdo do documento.
+ `_document_id`: o identificador exclusivo do documento.
+ `_document_title`: o título do documento.
+ `_excerpt_page_number`: o número da página em um arquivo PDF em que o trecho do documento aparece. Se o índice foi criado antes de 8 de setembro de 2020, você deve reindexar os documentos antes de poder usar esse atributo.
+ `_faq_id`: se for um documento do tipo pergunta e resposta (Perguntas frequentes), um identificador exclusivo para as Perguntas frequentes.
+ `_file_type`: o tipo de arquivo do documento, como pdf ou doc.
+ `_last_updated_at`: a data e a hora no formato ISO 8601 em que o documento foi atualizado pela última vez. Por exemplo, 2012-03-25T12:30:10\$101:00 é o formato de data e hora ISO 8601 para 25 de março de 2012 às 12h30 (mais 10 segundos) no horário da Europa Central.
+ `_source_uri`: o URI em que o documento está disponível, por exemplo, o URI do documento no site da empresa.
+ `_version`: um identificador para a versão específica de um documento.
+ `_view_count`: o número de vezes que o documento foi visualizado.
+ `_language_code` (string): o código de um idioma que se aplica ao documento. Isso volta para o padrão, inglês, se você não especificar um idioma. Para obter mais informações sobre os idiomas suportados, incluindo os códigos, consulte [Adicionar documentos em outros idiomas além do inglês](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-languages.html).
Você cria campos personalizados usando `DocumentMetadataConfigurationUpdates` com a operação de API `UpdateIndex`, assim como faz ao criar um campo reservado ou comum. Você deve definir o tipo de dados apropriado para o campo personalizado.
Se usar o console, atualize os campos selecionando a fonte de dados, a ação de edição e, em seguida, prosseguindo para a seção de mapeamentos de campo para configurar a fonte de dados. Algumas fontes de dados não oferecem suporte à adição de novos campos ou campos personalizados. Você não pode alterar o tipo de campo depois de criar o campo.
Estes são os tipos que podem ser definidos para campos personalizados:
+ Data
+ Número
+ String
+ Lista de strings
Se você adicionou documentos a um índice usando a operação fields/attributes da [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API, `Attributes` lista seus documentos e cria campos usando o `DocumentAttribute` objeto.
Para documentos indexados de uma fonte de Amazon S3 dados, você cria campos usando um [arquivo de metadados JSON](https://docs.aws.amazon.com/kendra/latest/dg/s3-metadata.html) que inclui as informações dos campos.
Ao usar um banco de dados compatível como fonte de dados, poderá configura os campos usando a [opção de mapeamentos de campo](https://docs.aws.amazon.com/kendra/latest/dg/data-source-database.html#data-source-procedure-database).
# Recuperar respostas de índices no Amazon Kendra
Depois de criar um índice, comece a pesquisar os documentos.
Para pesquisar um Amazon Kendra índice, você usa a operação da API [Retrieve](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) ou a operação da API [Query](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html).
A operação de API Retrieve é ideal para casos de uso de geração aumentada via recuperação (RAG). Para determinada consulta, ela retorna uma lista classificada de passagens semanticamente relevantes de até 200 palavras de token. Você pode enviá-las a um grande modelo de linguagem (LLM) para gerar uma resposta usando RAG. Consulte mais informações em [Pesquisar um índice](https://docs.aws.amazon.com/kendra/latest/dg/searching.html).
A operação da API Query é melhor para casos de uso de pesquisa de documentos. Para determinada consulta, ela retorna uma lista de documentos classificados com trechos de 100 palavras que são relevantes para a consulta. Isso é útil para casos de uso tradicionais de pesquisa de documentos em que os usuários estão navegando por uma lista de documentos classificados.
Saiba quais recursos são compatíveis com as operações de API Retrieve e Query para cada tipo de índice em [Tipos de índice](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html).
# Documentos
Esta seção explica como Amazon Kendra indexa os diversos formatos de documentos que ele suporta e os diferentes tipos fields/attributes de documentos.
**Topics**
+ [Tipos ou formatos de documentos](#index-document-types)
+ [Atributos ou campos do documento](#hiw-document-attributes)
## Tipos ou formatos de documentos
Amazon Kendra oferece suporte a tipos ou formatos de documentos populares, como PDF, HTML PowerPoint, Word e muito mais. Um índice pode conter vários formatos de documento.
Amazon Kendra extrai o conteúdo dentro dos documentos para tornar os documentos pesquisáveis. Os documentos são analisados de forma a otimizar a pesquisa no texto extraído e em qualquer conteúdo tabular (tabelas HTML) dentro dos documentos. Isso significa estruturar os documentos em campos ou atributos que são usados para pesquisa. Os metadados do documento, como a data da última modificação, podem ser campos úteis para pesquisa.
Os documentos podem ser organizados em linhas e colunas. Por exemplo, cada documento é uma linha e cada campo/atributo do documento, como o título e o conteúdo do corpo, é uma coluna. Por exemplo, se você usa um banco de dados como fonte de dados, os dados devem ser estruturados ou organizados em linhas e colunas.
Você pode adicionar documentos ao índice das seguintes formas:
+ [API BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-documents.html)
+ [Conector da fonte de dados](https://docs.aws.amazon.com/kendra/latest/dg/data-sources.html)
Se quiser adicionar um arquivo de perguntas frequentes, use a [CreateFaq](https://docs.aws.amazon.com/kendra/latest/dg/in-creating-faq.html)API para adicionar o arquivo armazenado em um Amazon S3 bucket. Você pode escolher entre um formato CSV básico, um formato CSV que inclui personalização fields/attributes em um cabeçalho e um formato JSON que inclui campos personalizados. O formato padrão é CSV básico.
Veja a seguir informações sobre cada formato de documento compatível e como Amazon Kendra trata cada formato ao indexar documentos.
| Formato do documento | Tratado como | Como o documento é tratado | Estrutura original |
| --- | --- | --- | --- |
| Formato de documento portátil (PDF) | HTML | Convertido em HTML e, em seguida, o conteúdo é extraído. | Não estruturado |
| HyperText Linguagem de marcação (HTML) | HTML | As tags HTML são filtradas para extrair conteúdo. O conteúdo deve estar entre as tags principais de HTML início e fim (content). | Semiestruturado |
| Linguagem de marcação extensível (XML) | XML | As tags HTML são filtradas para extrair conteúdo. | Semiestruturado |
| Transformação de linguagem de folha de estilo extensível (XSLT) | XSLT | As tags HTML são filtradas para extrair conteúdo. | Semiestruturado |
| MarkDown (Maryland) | Texto sem formatação | O conteúdo é extraído com a MarkDown sintaxe incluída. | Semiestruturado |
| CSV (valores separados por vírgula) | CSV | Conteúdo extraído de cada célula, com um único arquivo tratado como um único resultado de documento. | Estruturado para arquivos de perguntas frequentes, caso contrário, semiestruturado |
| Microsoft Excel (XLS e XLSX) | XLS e XLSX | Conteúdo extraído de cada célula, com um único arquivo tratado como um único resultado de documento. | Semiestruturado |
| JavaScript Notação de objeto (JSON) | Texto sem formatação | O conteúdo é extraído com a sintaxe MarkDown incluída. | Semiestruturado |
| Formato Rich Text (RTF) | RTF | A sintaxe RTF é filtrada para extrair conteúdo. | Semiestruturado |
| Microsoft PowerPoint (PPT) | PPT, PPTX | Somente o conteúdo de texto é extraído dos PowerPoint slides para pesquisa. Imagens e outros conteúdos não são extraídos. | Não estruturado |
| Microsoft Word | .doc/.docx | Somente o conteúdo de texto é extraído das páginas do Word para pesquisa. Imagens e outros conteúdos não são extraídos. | Não estruturado |
| Texto sem formatação (TXT) | TXT | Todo o texto no documento de texto é extraído. | Não estruturado |
## Atributos ou campos do documento
Um documento tem atributos ou campos associados a ele. Os campos de um documento são as propriedades de um documento ou o que está contido na estrutura de um documento. Por exemplo, cada um dos documentos pode conter título, corpo do texto e autor. Você também pode adicionar campos personalizados para documentos específicos. Por exemplo, se o índice pesquisar documentos fiscais, você poderá especificar um campo personalizado para o tipo de documento fiscal, como W-2, 1099 e assim por diante.
Antes de usar um campo de documento em uma consulta, ele deve ser mapeado para um campo de índice. Por exemplo, o campo do título pode ser mapeado para o campo`_document_title`. Para obter mais informações, consulte [Mapear campos](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). Para adicionar um novo campo, você deve criar um campo de índice para o qual mapear o campo. Você cria campos de índice usando o console ou usando a [UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html)API.
Você pode usar os campos do documento para filtrar respostas e criar resultados de pesquisa facetados. Por exemplo, você pode filtrar uma resposta para retornar somente uma versão específica de um documento ou filtrar pesquisas para retornar somente documentos fiscais do tipo 1099 que correspondam ao termo de pesquisa. Para obter mais informações, consulte [Filtrar e pesquisar por facetas](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html).
Você também pode usar os campos do documento para ajustar manualmente a resposta da consulta. Por exemplo, você pode optar por aumentar a importância do campo do título para aumentar o peso Amazon Kendra atribuído ao campo ao determinar quais documentos devem ser retornados na resposta. Para obter mais informações, consulte [Ajustar a relevância da pesquisa](https://docs.aws.amazon.com/kendra/latest/dg/tuning.html).
Se você estiver adicionando um documento diretamente a um índice, especifique os campos no parâmetro de entrada do [documento](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Document.html) para a [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API. Você especifica os valores do campo personalizado em uma matriz de [DocumentAttribute](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DocumentAttribute.html)objetos. Se você estiver usando uma fonte de dados, o método usado para adicionar os campos do documento dependerá da fonte de dados. Para obter mais informações, consulte [Mapear campos de fonte de dados](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
### Usando campos de documentos Amazon Kendra reservados ou comuns
Com a [UpdateIndex API](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html), você pode criar campos reservados ou comuns usando `DocumentMetadataConfigurationUpdates` e especificando o nome do campo de índice Amazon Kendra reservado para mapear para o attribute/field nome do documento equivalente. Você também pode criar campos personalizados. Se você usa um conector de fonte de dados, a maioria inclui mapeamentos de campo que mapeiam os campos do documento da fonte de dados para campos de Amazon Kendra índice. Se usar o console, atualize os campos selecionando a fonte de dados, a ação de edição e, em seguida, prosseguindo para a seção de mapeamentos de campo para configurar a fonte de dados.
Você pode configurar o objeto `Search` para definir um campo como exibível, facetável, pesquisável e classificável. Configure o objeto `Relevance` para definir a ordem de classificação, a duração do aumento ou o período de tempo de um campo a ser aplicado ao aumento, à atualização, ao valor de importância e aos valores de importância mapeados para valores de campo específicos. Se usar o console, defina as configurações de pesquisa de um campo selecionando a opção de faceta no menu de navegação. Para definir o ajuste de relevância, selecione a opção de pesquisar o índice no menu de navegação, insira uma consulta e use as opções do painel lateral para ajustar a relevância da pesquisa. Você não pode alterar o tipo de campo depois de criar o campo.
Amazon Kendra tem os seguintes campos de documento reservados ou comuns que você pode usar:
+ `_authors`: uma lista de um ou mais autores responsáveis pelo conteúdo do documento.
+ `_category`: uma categoria que coloca um documento em um grupo específico.
+ `_created_at`: a data e a hora no formato ISO 8601 em que o documento foi criado. Por exemplo, 2012-03-25T12:30:10\$101:00 é o formato de data e hora ISO 8601 para 25 de março de 2012 às 12h30 (mais 10 segundos) no horário da Europa Central.
+ `_data_source_id`: o identificador da fonte de dados que contém o documento.
+ `_document_body`: o conteúdo do documento de trabalho.
+ `_document_id`: o identificador exclusivo de cada documento.
+ `_document_title`: o título do documento.
+ `_excerpt_page_number`: o número da página em um arquivo PDF em que o trecho do documento aparece. Se o índice foi criado antes de 8 de setembro de 2020, você deve reindexar os documentos antes de poder usar esse atributo.
+ `_faq_id`: se for um documento do tipo pergunta e resposta (Perguntas frequentes), um identificador exclusivo para as Perguntas frequentes.
+ `_file_type`: o tipo de arquivo do documento, como pdf ou doc.
+ `_last_updated_at`: a data e a hora no formato ISO 8601 em que o documento foi atualizado pela última vez. Por exemplo, 2012-03-25T12:30:10\$101:00 é o formato de data e hora ISO 8601 para 25 de março de 2012 às 12h30 (mais 10 segundos) no horário da Europa Central.
+ `_source_uri`: o URI em que o documento está disponível. Por exemplo, o URI do documento no site da empresa.
+ `_version`: um identificador para a versão específica de um documento.
+ `_view_count`: o número de vezes que o documento foi visualizado.
+ `_language_code`(String): o código de um idioma que se aplica ao documento. O padrão é inglês se você não especificar um idioma. Para obter mais informações sobre os idiomas suportados, incluindo os códigos, consulte [Adicionar documentos em outros idiomas além do inglês](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-languages.html).
Para campos personalizados, você cria esses campos usando `DocumentMetadataConfigurationUpdates` com a API `UpdateIndex`, assim como faz ao criar um campo reservado ou comum. Você deve definir o tipo de dados apropriado para o campo personalizado. Se usar o console, atualize os campos selecionando a fonte de dados, a ação de edição e, em seguida, prosseguindo para a seção de mapeamentos de campo para configurar a fonte de dados. Algumas fontes de dados não oferecem suporte à adição de novos campos ou campos personalizados. Você não pode alterar o tipo de campo depois de criar o campo.
Estes são os tipos que podem ser definidos em campos personalizados:
+ Data
+ Número
+ String
+ Lista de strings
Se você adicionou documentos ao índice usando a [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API, `Attributes` fields/attributes lista seus documentos e cria campos usando o `DocumentAttribute` objeto.
Para documentos indexados de uma fonte de Amazon S3 dados, você cria campos usando um [arquivo de metadados JSON](https://docs.aws.amazon.com/kendra/latest/dg/s3-metadata.html) que inclui as informações dos campos.
Ao usar um banco de dados compatível como fonte de dados, poderá configurae as campos usando a [opção de mapeamentos de campo](https://docs.aws.amazon.com/kendra/latest/dg/data-source-database.html#data-source-procedure-database).
# Fontes de dados
Uma fonte de dados é um repositório de dados ou um local que Amazon Kendra se conecta e indexa seus documentos ou conteúdo. Por exemplo, você pode configurar Amazon Kendra para se conectar à Microsoft SharePoint para rastrear e indexar seus documentos armazenados nessa fonte. Você também pode indexar páginas da Web fornecendo o URLs formulário Amazon Kendra para rastreamento. Você pode sincronizar automaticamente uma fonte de dados com um Amazon Kendra índice para que documentos adicionados, atualizados ou excluídos na fonte de dados também sejam adicionados, atualizados ou excluídos do índice.
As fontes de dados compatíveis são:
+ Adobe Experience Manager
+ [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 (EM UM NetApp TOQUE)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-fsx-ontap.html)
+ [Fontes de dados do banco de dados](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 (Oráculo)](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 baldes](https://docs.aws.amazon.com/kendra/latest/dg/data-source-s3.html)
+ [Amazon Kendra Rastreador da Web](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)
+ [Fontes de dados personalizadas](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
+ [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)
Para obter uma lista dos tipos ou formatos de documentos suportados pelo, Amazon Kendra consulte [Tipos de documentos](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html). Você deve primeiro criar um índice antes de criar um conector de fonte de dados para indexar os documentos a partir da sua fonte de dados.
**nota**
Para criar um índice de documentos, você não precisa usar uma fonte de dados. Você pode adicionar documentos diretamente a um índice com o upload em lote. Para obter mais informações, consulte [Adicionar documentos diretamente a um índice](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-documents.html).
[Para ver um passo a passo sobre como usar o Amazon Kendra console, a AWS CLI ou consulte Introdução SDKs.](https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html)
# Consultas
Para obter respostas, os usuários consultam um índice. Os usuários podem usar linguagem natural em suas consultas. A resposta contém informações, como o título, um trecho do texto e a localização dos documentos no índice que fornecem a melhor resposta.
Amazon Kendra usa todas as informações que você fornece sobre seus documentos, não apenas o conteúdo dos documentos, para determinar se um documento é relevante para a consulta. Por exemplo, se seu índice contém informações sobre quando os documentos foram atualizados pela última vez, você pode pedir Amazon Kendra para atribuir uma relevância maior aos documentos que foram atualizados mais recentemente.
Uma consulta também pode conter critérios sobre como filtrar a resposta para que Amazon Kendra retorne somente documentos que satisfaçam os critérios do filtro. Por exemplo, ao criar um campo de índice chamado *departamento*, você pode filtrar a resposta para que somente documentos com o campo departamento definido como *legal* sejam retornados. Para obter mais informações, consulte [Filtrar pesquisa](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html).
Você pode influenciar os resultados de uma consulta ajustando a relevância de campos individuais no índice. O ajuste muda a importância de um campo nos resultados. Por exemplo, se você aumentar a importância de documentos com a categoria *nova*, é mais provável que documentos com essa categoria sejam incluídos na resposta. Para obter mais informações, consulte Ajustar a relevância da pesquisa e Ajustar as respostas.
Para obter mais informações sobre o uso de consultas, consulte [Pesquisar em um índice](https://docs.aws.amazon.com/kendra/latest/dg/searching.html).
# Tags
Gerencie seus índices, fontes de dados e FAQs atribua etiquetas ou rótulos. Você pode usar tags para categorizar seus Amazon Kendra recursos de várias maneiras. Por exemplo, por finalidade, por proprietário, por aplicativo ou por qualquer combinação. Cada tag consiste em uma *chave* e um *valor*, ambos definidos por você.
As tags ajudam a:
+ Identifique e organize seus AWS recursos. Muitos AWS serviços oferecem suporte à marcação, então você pode atribuir a mesma tag a recursos em serviços diferentes para indicar que os recursos estão relacionados. Por exemplo, você pode marcar um índice e o Amazon Lex bot que usa o índice com a mesma tag.
+ Alocar custos. Você ativa as tags no Gerenciamento de Faturamento e Custos da AWS painel. AWS usa tags para categorizar seus custos e entregar um relatório mensal de alocação de custos para você. Para obter mais informações, consulte [Alocação e marcação de custos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) em *Sobre o AWS Billing* and Cost Management.
+ Controle o acesso aos recursos da . Você pode usar tags em políticas do AWS Identity and Access Management (IAM) para controlar o acesso aos recursos do Amazon Kendra . Você pode anexar essas políticas a uma IAM função ou usuário para ativar o controle de acesso baseado em tags. Para obter mais informações, consulte [Autorização baseada em tags](https://docs.aws.amazon.com/kendra/latest/dg/security_iam_service-with-iam.html#security_iam_service-with-iam-tags).
Você pode criar e gerenciar tags usando o Console de gerenciamento da AWS, o AWS Command Line Interface (AWS CLI) ou a Amazon Kendra API.
## Marcar recursos
Se você estiver usando o Amazon Kendra console, poderá marcar recursos ao criá-los ou adicioná-los posteriormente. Também é possível usar o console para atualizar ou remover tags.
Se você estiver usando o AWS Command Line Interface (AWS CLI) ou a Amazon Kendra API, use as seguintes operações para gerenciar tags para seus recursos:
+ [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html)—Aplique tags ao criar uma fonte de dados.
+ [CreateFaq](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateFaq.html)—Aplique tags ao criar uma FAQ.
+ [CreateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateIndex.html)—Aplique tags ao criar um índice.
+ [ListTagsForResource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ListTagsForResource.html)—Visualize as tags associadas a um recurso.
+ [TagResource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TagResource.html)—Adicione e modifique tags para um recurso.
+ [UntagResource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UntagResource.html)—Remover tags de um recurso.
## Restrições de tags
As restrições a seguir se aplicam às tags nos Amazon Kendra recursos:
+ Número máximo de tags: 50
+ Tamanho máximo da chave: 128 caracteres
+ Tamanho máximo do valor: 256 caracteres
+ Caracteres válidos de chave e valor a-z, A-Z, 0-9, espaço e os seguintes caracteres: \$1 . : / = \$1 - e @
+ Chaves e valores diferenciam maiúsculas de minúsculas
+ Não use `aws:` como um prefixo para chaves, pois ele é reservado para uso da AWS