Etapa 2: executar um trabalho de análise de entidades no Amazon Comprehend - Amazon Kendra
executando um trabalho de análise de entidades no Amazon Comprehend

Etapa 2: executar um trabalho de análise de entidades no Amazon Comprehend

Depois de armazenar o conjunto de dados de amostra no bucket do S3, execute um trabalho de análise de entidades do Amazon Comprehend para extrair entidades dos documentos. Essas entidades formarão atributos personalizados do Amazon Kendra e ajudarão você a filtrar os resultados da pesquisa no índice. Para obter mais informações, consulte Detectar eventos.

executando um trabalho de análise de entidades no Amazon Comprehend

Depois de armazenar o conjunto de dados,, execute um trabalho de análise de entidades do Amazon Comprehend.

Se estiver usando a CLI AWS nesta etapa, primeiro crie e anexe uma função e um perfil do IAM da AWS para o Amazon Comprehend e, em seguida, execute um trabalho de análise de entidades. Para executar um trabalho de análise de entidades dos dados de amostra, o Amazon Comprehend precisa de:

  • um perfil do IAM da AWS Identity and Access Management que a reconhece como uma entidade confiável

  • uma política do IAM da AWS que tenha permissões suficientes para acessar o bucket do S3.

Para obter mais informações, consulte Como o Amazon Comprehend funciona com o IAM e Políticas baseadas em identidade para o Amazon Comprehend.

  1. Abra o console do Amazon Comprehend em https://console.aws.amazon.com/comprehend/.

    Importante

    Certifique-se de que você esteja na mesma região em que você criou o bucket do Amazon S3. Se estiver em outra região, escolha a região da AWS na qual você criou o bucket do S3 no Seletor de Regiões na barra de navegação na parte superior.

  2. Escolha Executar o Amazon Comprehend).

  3. No painel de navegação à esquerda, escolha Trabalhos de análise.

  4. Escolha Criar trabalho.

  5. Na seção Configurações de trabalho, faça o seguinte:

    1. Em Nome, insira data-entities-analysis.

    2. Em Tipo de análise, escolha Entidades.

    3. Em Idioma, escolha Inglês.

    4. Mantenha a Criptografia do trabalho desativada.

  6. Na seção Dados de entrada, faça o seguinte:

    1. Em Fonte de dados, escolha Meus documentos.

    2. Para a Localização do S3, escolha Procurar no S3.

    3. Em Escolher recursos, clique no nome do bucket na lista de buckets.

    4. Em Objetos, selecione o botão de opção para data e escolha Escolher.

    5. Em Formato de entrada, escolha Um documento por linha.

  7. Na seção Dados de saída, faça o seguinte:

    1. Para a Localização do S3, escolha Procurar no S3 e, em seguida, escolha a caixa de opção para o bucket na lista de buckets e escolha Escolher.

    2. Mantenha a Criptografia desativada.

  8. Na seção Permissões de acesso, faça o seguinte:

    1. Em Perfil do IAM), escolha Criar um perfil do IAM).

    2. Em Permissões para acessar, escolha Buckets do S3 de entrada e saída.

    3. Em Sufixo do nome, insira comprehend-role. Esse perfil fornece acesso ao bucket do Amazon S3.

  9. Mantenha a Configuração da VPC padrão.

  10. Escolha Criar trabalho.

  1. Para criar e anexar um perfil do IAM para a Amazon Comprehend que a reconheça como uma entidade confiável, faça o seguinte:

    1. Salve a política de confiança a seguir como um arquivo JSON chamado comprehend-trust-policy.json em um editor ou texto em seu computador.

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

    2. Para criar um perfil do IAM chamado comprehend-role e anexar o arquivo comprehend-trust-policy.json salvo para ele, use o comando create-role:

      Linux
      aws iam create-role \
          --role-name comprehend-role \
          --assume-role-policy-document file://path/comprehend-trust-policy.json

      Em que:

      • path/ é o caminho do arquivo para a pasta comprehend-trust-policy.json no dispositivo local.

      macOS
      aws iam create-role \
          --role-name comprehend-role \
          --assume-role-policy-document file://path/comprehend-trust-policy.json

      Em que:

      • path/ é o caminho do arquivo para a pasta comprehend-trust-policy.json no dispositivo local.

      Windows
      aws iam create-role ^
          --role-name comprehend-role ^
          --assume-role-policy-document file://path/comprehend-trust-policy.json

      Em que:

      • path/ é o caminho do arquivo para a pasta comprehend-trust-policy.json no dispositivo local.

    3. Copie o nome do recurso da Amazon (ARN) no editor de texto e salve-o localmente como comprehend-role-arn.

      nota

      O ARN tem um formato semelhante a arn:aws:iam::123456789012:role/comprehend-role. Você precisa do ARN no qual você salvou comprehend-role-arn para executar o trabalho de análise do Amazon Comprehend.

  2. Para criar e anexar uma política do IAM ao seu perfil do IAM do IAM que conceda permissões para acessar seu bucket do S3, faça o seguinte:

    1. Salve a política de confiança a seguir como um arquivo JSON chamado comprehend-S3-access-policy.json em um editor ou texto em seu computador.

      JSON
      {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Action": [
                "s3:GetObject"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket/*"
            ],
            "Effect": "Allow"
        },
        {
            "Action": [
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket"
            ],
            "Effect": "Allow"
        },
        {
            "Action": [
                "s3:PutObject"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket/*"
            ],
            "Effect": "Allow"
        }
    ]
}

    2. Para criar uma política do IAM chamada comprehend-S3-access-policy para acessar o bucket do S3, use o comando create-policy:

      Linux
      aws iam create-policy \
          --policy-name comprehend-S3-access-policy \
          --policy-document file://path/comprehend-S3-access-policy.json

      Em que:

      • path/ é o caminho do arquivo para a pasta comprehend-S3-access-policy.json no dispositivo local.

      macOS
      aws iam create-policy \
          --policy-name comprehend-S3-access-policy \
          --policy-document file://path/comprehend-S3-access-policy.json

      Em que:

      • path/ é o caminho do arquivo para a pasta comprehend-S3-access-policy.json no dispositivo local.

      Windows
      aws iam create-policy ^
          --policy-name comprehend-S3-access-policy ^
          --policy-document file://path/comprehend-S3-access-policy.json

      Em que:

      • path/ é o caminho do arquivo para a pasta comprehend-S3-access-policy.json no dispositivo local.

    3. Copie o nome do recurso da Amazon (ARN) no editor de texto e salve-o localmente como comprehend-S3-access-arn.

      nota

      O ARN tem um formato semelhante a arn:aws:iam::123456789012:role/comprehend-S3-access-policy. Você precisa do ARN em que salvou comprehend-S3-access-arn para anexar comprehend-S3-access-policy ao perfil do IAM.

    4. Use o comando attach-role-policy para anexar comprehend-S3-access-policy ao perfil do IAM:

      Linux
      aws iam attach-role-policy \
          --policy-arn policy-arn \
          --role-name comprehend-role

      Em que:

      • policy-arn é o ARN com o qual você salvou comprehend-S3-access-arn.

      macOS
      aws iam attach-role-policy \
          --policy-arn policy-arn \
          --role-name comprehend-role

      Em que:

      • policy-arn é o ARN com o qual você salvou comprehend-S3-access-arn.

      Windows
      aws iam attach-role-policy ^
          --policy-arn policy-arn ^
          --role-name comprehend-role

      Em que:

      • policy-arn é o ARN com o qual você salvou comprehend-S3-access-arn.

  3. Para executar um trabalho de análise de entidades do Amazon Comprehend, use o comando start-entities-detection-job:

    Linux
    aws comprehend start-entities-detection-job \
        --input-data-config S3Uri=s3://amzn-s3-demo-bucket/data/,InputFormat=ONE_DOC_PER_FILE \
        --output-data-config S3Uri=s3://amzn-s3-demo-bucket/ \
        --data-access-role-arn role-arn \
        --job-name data-entities-analysis \
        --language-code en \
        --region aws-region

    Em que:

    • amzn-s3-demo-bucket é o nome do bucket do S3.

    • policy-arn é o ARN com o qual você salvou comprehend-role-arn.

    • aws-region é sua região da AWS.

    macOS
    aws comprehend start-entities-detection-job \
        --input-data-config S3Uri=s3://amzn-s3-demo-bucket/data/,InputFormat=ONE_DOC_PER_FILE \
        --output-data-config S3Uri=s3://amzn-s3-demo-bucket/ \
        --data-access-role-arn role-arn \
        --job-name data-entities-analysis \
        --language-code en \
        --region aws-region

    Em que:

    • amzn-s3-demo-bucket é o nome do bucket do S3.

    • policy-arn é o ARN com o qual você salvou comprehend-role-arn.

    • aws-region é sua região da AWS.

    Windows
    aws comprehend start-entities-detection-job ^
        --input-data-config S3Uri=s3://amzn-s3-demo-bucket/data/,InputFormat=ONE_DOC_PER_FILE ^
        --output-data-config S3Uri=s3://amzn-s3-demo-bucket/ ^
        --data-access-role-arn role-arn ^
        --job-name data-entities-analysis ^
        --language-code en ^
        --region aws-region

    Em que:

    • amzn-s3-demo-bucket é o nome do bucket do S3.

    • policy-arn é o ARN com o qual você salvou comprehend-role-arn.

    • aws-region é sua região da AWS.

  4. Copie a análise das entidades JobId e salve-a em um editor de texto como comprehend-job-id. JobId ajuda a rastrear o status do trabalho de análise de entidades.

  5. Para acompanhar o progresso do trabalho de análise de entidades, use o comando describe-entities-detection-job:

    Linux
    aws comprehend describe-entities-detection-job \
        --job-id entities-job-id \
        --region aws-region

    Em que:

    • entities-job-id é o comprehend-job-id salvo

    • aws-region é sua região da AWS.

    macOS
    aws comprehend describe-entities-detection-job \
        --job-id entities-job-id \
        --region aws-region

    Em que:

    • entities-job-id é o comprehend-job-id salvo

    • aws-region é sua região da AWS.

    Windows
    aws comprehend describe-entities-detection-job ^
        --job-id entities-job-id ^
        --region aws-region

    Em que:

    • entities-job-id é o comprehend-job-id salvo

    • aws-region é sua região da AWS.

Pode levar vários minutos para que JobStatus seja alterado para COMPLETED.

Ao final dessa etapa, o Amazon Comprehend armazena os resultados da análise de entidades como um arquivo output.tar.gz compactado dentro de uma pasta dentro de output uma pasta gerada automaticamente no bucket do S3. O status do trabalho de análise deve estar concluído antes de passar para a próxima etapa.