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á.
# Configuração do Amazon Kendra
Antes de usar o Amazon Kendra, é necessário ter uma conta da Amazon Web Services (AWS). Depois de criar uma conta da AWS, você poderá acessar o Amazon Kendra por meio do console do Amazon Kendra, do AWS Command Line Interface (AWS CLI), ou dos SDKs da AWS.
Este guia inclui exemplos para AWS CLI, Java e Python.
**Topics**
+ [Cadastre-se na AWS](#aws-kendra-set-up-aws-account)
+ [Regiões e endpoints](#endpoints)
+ [Configuração da AWS CLI](aws-kendra-set-up-aws-cli.md)
+ [Configurar os SDKs da AWS](aws-kendra-set-up-sdks.md)
## Cadastre-se na AWS
Quando você se cadastra na Amazon Web Services (AWS), sua conta da é cadastrada automaticamente em todos os produtos da AWS, inclusive o Amazon Kendra. A cobrança incorrerá apenas pelos serviços utilizados.
Se já tiver uma conta da AWS, passe para a próxima tarefa. Se ainda não possuir uma conta da AWS, use o procedimento a seguir para criar uma.
**Para cadastrar-se na AWS**
1. Abra [https://aws.amazon.com](https://aws.amazon.com/) e selecione **Criar um conta da AWS**.
1. Siga as instruções na tela para concluir a criação da conta. Anote o número de 12 dígitos da conta da AWS. Parte do procedimento de cadastro envolve uma chamada telefônica e a digitação de um PIN usando o teclado do telefone.
1. Crie um usuário administrador do AWS Identity and Access Management (IAM). Consulte [Criar seu primeiro grupo e usuário do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html) no *Guia do usuário do AWS Identity and Access Management* para obter instruções.
## Regiões e endpoints
Um endpoint é um URL que é o ponto de entrada para um serviço da Web. Cada endpoint é associado a uma região específica da AWS. Se você usa uma combinação do console do Amazon Kendra, da AWS CLI e dos SDKs do Amazon Kendra, preste atenção às suas regiões padrão, pois todos os componentes do Amazon Kendra de uma determinada campanha (índice, consulta etc.) devem ser criados na mesma região. Para obter uma lista de todas as regiões e endpoints com suporte pelo o Amazon Kendra, consulte [Regiões e endpoints](https://docs.aws.amazon.com/general/latest/gr/kendra.html).
# Configuração da AWS CLI
A interface de linha de comando da AWS (AWS CLI) é uma ferramenta de desenvolvedor unificada para gerenciar os serviços da AWS, incluindo o Amazon Kendra. Recomendamos que você a instale.
1. Para instalar a AWS CLI, siga as instruções em [Instalar a interface de linha de comando da AWS](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) no *Guia do usuário da interface de linha de comando da AWS*.
1. Para configurar a AWS CLI e criar um perfil para chamar a AWS CLI, siga as instruções em [Configurar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) no *AWSGuia do usuário da interface da linha de comando*.
1. Para confirmar se o perfil da AWS CLI está configurado corretamente, execute o seguinte comando:
```
aws configure --profile default
```
Se o seu perfil foi configurado corretamente, você verá uma saída semelhante a esta:
```
AWS Access Key ID [****************52FQ]:
AWS Secret Access Key [****************xgyZ]:
Default region name [us-west-2]:
Default output format [json]:
```
1. Para verificar se a AWS CLI está configurada para ser usada com o Amazon Kendra, execute os seguintes comandos:
```
aws kendra help
```
Se a AWS CLI estiver configurada corretamente, você visualizará uma lista de comandos da AWS CLI com suporte pelo Amazon Kendra, runtime do Amazon Kendra e eventos do Amazon Kendra.
# Configurar os SDKs da AWS
Faça download e instale os SDKs da AWS que você deseja usar. Este guia fornece exemplos para Python. Para obter mais informações sobre outros SDKs da AWS, consulte [Ferramentas para a Amazon Web Services](https://aws.amazon.com/tools/).
O pacote para o SDK do Python é chamado de *Boto3*.
Antes de executar os comandos Python abaixo, você deverá primeiro baixar e instalar o [Python 3.6 ou posterior](https://www.python.org/downloads/) no sistema operacional. O suporte para Python 3.5 e versões anteriores está obsoleto. Se não tiver pip incluído no seu diretório de scripts do Python, você poderá baixar o [get-pip.py](https://bootstrap.pypa.io/get-pip.py) e armazená-lo no seu diretório de scripts. Você também poderá definir seu diretório Python como um [Caminho ou variável de ambiente](https://docs.python.org/3/using/cmdline.html#envvar-PYTHONPATH) usando um programa de terminal.
```
# Install the latest Boto3 release via pip
pip install boto3
# You can install a specific version of Boto3 for compatibility reasons
# Install Boto3 version 1.0 specifically
pip install boto3==1.0.0
# Make sure Boto3 is no older than version 1.15.0
pip install boto3>=1.15.0
# Avoid versions of Boto3 newer than version 1.15.3
pip install boto3<=1.15.3
```
Para usar o Boto3, configure as credenciais de autenticação para sua conta da AWS usando o [console do IAM.](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey)