View a markdown version of this page

Pré-requisitos - Amazon Kendra
Inscreva-se para um Conta da AWSAmazon Kendra recursos: AWS CLI, SDK, console

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á.

Pré-requisitos

As etapas a seguir são pré-requisitos para os exercícios de conceitos básicos. As etapas mostram como configurar sua conta, criar uma IAM função que dê Amazon Kendra permissão para fazer chamadas em seu nome e indexar documentos de um Amazon S3 bucket. Um bucket do S3 é usado como exemplo, mas você pode usar outras fontes de dados compatíveis com o Amazon Kendra . Escolha as Fontes de dados.

Inscreva-se para um Conta da AWS

Para começar AWS, você precisa de um Conta da AWS. Para obter informações sobre como criar um Conta da AWS, consulte Introdução a um Conta da AWS no Guia de AWS Gerenciamento de contas referência.

  • Se você estiver usando um bucket do S3 contendo documentos para testar Amazon Kendra, crie um bucket do S3 na mesma região que você está usando. Amazon Kendra Para obter instruções, consulte Como criar um bucket do S3 no Guia do usuário do Amazon Simple Storage Service.

    Carregar os documentos no bucket do S3. Para obter mais informações, consulte Upload, download e gerenciamento de objetos no Manual do usuário do Amazon Simple Storage Service.

    Se estiver usando outra fonte de dados, use um site ativo e credenciais para se conectar à fonte de dados.

Se estiver usando o console, comece com Conceitos básicos do Amazon Kendra console.

Amazon Kendra recursos: AWS CLI, SDK, console

Há certas permissões necessárias para usar a CLI, o SDK ou o console.

Amazon Kendra Para usar a CLI, o SDK ou o console, você deve ter permissões Amazon Kendra para criar e gerenciar recursos em seu nome. Dependendo do seu caso de uso, essas permissões incluem acesso à própria Amazon Kendra API, AWS KMS keys se você quiser criptografar seus dados por meio de uma CMK personalizada, o diretório do Identity Center se quiser se integrar Centro de Identidade do AWS IAM ou criar uma experiência de pesquisa. Para obter uma lista completa de permissões para diferentes casos de uso, consulte as Funções do IAM.

Primeiro, anexe as permissões abaixo ao seu usuário do IAM.

JSON
{
  "Version":"2012-10-17",
  "Statement": [
    {
      "Sid": "Stmt1644430853544",
      "Action": [
        "kms:CreateGrant",
        "kms:DescribeKey"
      ],
      "Effect": "Allow",
      "Resource": "*"
    },
    {
      "Sid": "Stmt1644430878150",
      "Action": "kendra:*",
      "Effect": "Allow",
      "Resource": "*"
    },
    {
      "Sid": "Stmt1644430973706",
      "Action": [
        "sso:AssociateProfile",
        "sso:CreateManagedApplicationInstance",
        "sso:DeleteManagedApplicationInstance",
        "sso:DisassociateProfile",
        "sso:GetManagedApplicationInstance",
        "sso:GetProfile",
        "sso:ListDirectoryAssociations",
        "sso:ListProfileAssociations",
        "sso:ListProfiles"
      ],
      "Effect": "Allow",
      "Resource": "*"
    },
    {
      "Sid": "Stmt1644430999558",
      "Action": [
        "sso-directory:DescribeGroup",
        "sso-directory:DescribeGroups",
        "sso-directory:DescribeUser",
        "sso-directory:DescribeUsers"
      ],
      "Effect": "Allow",
      "Resource": "*"
    },
    {
      "Sid": "Stmt1644431025960",
      "Action": [
        "identitystore:DescribeGroup",
        "identitystore:DescribeUser",
        "identitystore:ListGroups",
        "identitystore:ListUsers"
      ],
      "Effect": "Allow",
      "Resource": "*"
    }
  ]
}

Segundo, se você usa a CLI ou o SDK, também deve criar uma IAM função e uma política para acessar. Amazon CloudWatch Logs Se você estiver usando o console, não precisará criar uma IAM função e uma política para isso. Você cria isso como parte do procedimento do console.

Para criar um IAM papel e política para o AWS CLI e SDK que permite Amazon Kendra para acessar seu Amazon CloudWatch Logs.

  1. Faça login no Console de gerenciamento da AWS e abra o console do IAM em https://console.aws.amazon.com/iam/.

  2. À esquerda, escolha Políticas e selecione Criar política.

  3. Escolha JSON e substitua a política padrão conforme a seguir:

    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "cloudwatch:PutMetricData"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "cloudwatch:namespace": "AWS/Kendra"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "logs:DescribeLogGroups"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "logs:CreateLogGroup"
            ],
            "Resource": [
                "arn:aws:logs:us-east-1:123456789012:log-group:/aws/kendra/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "logs:DescribeLogStreams",
                "logs:CreateLogStream",
                "logs:PutLogEvents"
            ],
            "Resource": [
                "arn:aws:logs:us-east-1:123456789012:log-group:/aws/kendra/*:log-stream:*"
            ]
        }
    ]
}

  4. Escolha Revisar política.

  5. Nomeie a política como "KendraPolicyForGettingStartedIndex" e clique em Criar política.

  6. No painel de navegação, escolha Funções e Criar função.

  7. Escolha Outra AWS conta e digite o ID da sua conta em ID da conta. Escolha Próximo: permissões.

  8. Escolha a política criada acima e, em seguida, escolha Próximo: tags

  9. Não adicione tag nenhuma. Escolha Próximo: revisar.

  10. Nomeie a função como "KendraRoleForGettingStartedIndex" e clique em Criar função.

  11. Encontre a função que você acabou de criar. Escolha o nome da função para abrir o Resumo. Escolha Relações de confiança e selecione Editar relação de confiança.

  12. Substitua o relacionamento de confiança existente pelo seguinte:

    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
      {
        "Effect": "Allow",
        "Principal": {
          "Service": "kendra.amazonaws.com"
        },
        "Action": "sts:AssumeRole"
      }
    ]
}

  13. Selecione Atualizar política de confiança.

Em terceiro lugar, se você usa um Amazon S3 para armazenar seus documentos ou está usando o S3 para testar Amazon Kendra, você também deve criar uma IAM função e uma política para acessar seu bucket. Se estiver usando outra fonte de dados, consulte Funções do IAM para fontes de dados.

Para criar um IAM papel e política que permitem Amazon Kendra para acessar e indexar seu Amazon S3 balde.

  1. Faça login no Console de gerenciamento da AWS e abra o console do IAM em https://console.aws.amazon.com/iam/.

  2. À esquerda, escolha Políticas e selecione Criar política.

  3. Escolha JSON e substitua a política padrão conforme a seguir:

    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Action": [
                "s3:GetObject"
            ],
            "Resource": [
                "arn:aws:s3:::bucket name/*"
            ],
            "Effect": "Allow"
        },
        {
            "Action": [
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::bucket name"
            ],
            "Effect": "Allow"
        },
        {
            "Effect": "Allow",
            "Action": [
                "kendra:BatchPutDocument",
                "kendra:BatchDeleteDocument"
            ],
            "Resource": "arn:aws:kendra:us-east-1:123456789012:index/*"
        }
    ]
}

  4. Escolha Revisar política.

  5. Nomeie a política KendraPolicyForGettingStartedDataSource "" e escolha Criar política.

  6. No painel de navegação, escolha Funções e Criar função.

  7. Escolha Outra AWS conta e digite o ID da sua conta em ID da conta. Escolha Próximo: permissões.

  8. Escolha a política criada acima e, em seguida, escolha Próximo: tags

  9. Não adicione tag nenhuma. Escolha Próximo: revisar.

  10. Nomeie a função KendraRoleForGettingStartedDataSource "" e escolha Criar função.

  11. Encontre a função que você acabou de criar. Escolha o nome da função para abrir o Resumo. Escolha Relações de confiança e selecione Editar relação de confiança.

  12. Substitua o relacionamento de confiança existente pelo seguinte:

    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
      {
        "Effect": "Allow",
        "Principal": {
          "Service": "kendra.amazonaws.com"
        },
        "Action": "sts:AssumeRole"
      }
    ]
}

  13. Selecione Atualizar política de confiança.

Dependendo de como você deseja usar a Amazon Kendra API, faça o seguinte.