Análise em tempo real para reconhecimento personalizado de entidades (API)

Você pode usar a API do Amazon Comprehend para executar a análise em tempo real com um modelo personalizado. Primeiro, crie um endpoint para executar a análise em tempo real. Depois de criá-lo, execute a análise em tempo real.

Para informações sobre o fornecimento do throughput do endpoint e os custos associados, consulte Usando endpoints do Amazon Comprehend.

Criação de um endpoint para detecção de entidades personalizadas

Para obter informações sobre os custos associados aos endpoints, consulte Usando endpoints do Amazon Comprehend.

Criando um endpoint com o AWS CLI

Para criar um endpoint usando o AWS CLI, use comando create-endpoint:

$ aws comprehend create-endpoint \
> --desired-inference-units number of inference units \
> --endpoint-name endpoint name \
> --model-arn arn:aws:comprehend:region:account-id:model/example \
> --tags Key=Key,Value=Value

Se seu comando for executado com êxito, o Amazon Comprehend responderá com o ARN do endpoint:

{
   "EndpointArn": "Arn"
}

Para obter mais informações sobre esse comando, seus argumentos de parâmetro e seu resultado consulte create-endpoint na Referência de comandos da AWS CLI.

Executando a detecção de entidades personalizadas em tempo real

Depois de criar um endpoint para seu modelo personalizado de reconhecimento de entidades, você usa o endpoint para executar a operação da DetectEntitiesAPI. Você pode fornecer entrada de texto usando os parâmetrostext ou bytes. Insira os outros tipos de entrada usando o parâmetro bytes.

Para arquivos de imagem e arquivos PDF, você pode usar o parâmetro DocumentReaderConfig para substituir as ações padrão de extração de texto. Para obter detalhes, consulte Configurando opções de extração de texto.

Detectando entidades no texto usando o AWS CLI

Para detectar entidades personalizadas no texto, execute o comando detect-entities com o texto de entrada no parâmetro text.

exemplo : use a CLI para detectar entidades no texto de entrada

$ aws comprehend detect-entities \
> --endpoint-arn arn \
> --language-code en \
> --text  "Andy Jassy is the CEO of Amazon."

Se seu comando for executado com êxito, o Amazon Comprehend responderá com a análise. Para cada entidade que o Amazon Comprehend detecta, ele fornece o tipo de entidade, o texto, a localização e a pontuação de confiança.

Detectando entidades em documentos semiestruturados usando o AWS CLI

Para detectar entidades personalizadas de um arquivo em PDF, Word ou de imagem, execute o comando detect-entities com o arquivo de entrada no parâmetro bytes.

exemplo : use a CLI para detectar entidades em um arquivo de imagem

Este exemplo mostra como passar o arquivo de imagem usando a opção fileb para codificar os bytes da imagem em base64. Para obter mais informações, consulte objetos binários grandes no Guia do usuário do AWS Command Line Interface.

Esse exemplo também passa um arquivo JSON chamado config.json para definir as opções de extração de texto.

$ aws comprehend detect-entities \
> --endpoint-arn arn \
> --language-code en \
> --bytes fileb://image1.jpg   \
> --document-reader-config file://config.json   
        

O arquivo config.json contém o conteúdo a seguir.

 {
    "DocumentReadMode": "FORCE_DOCUMENT_READ_ACTION",
    "DocumentReadAction": "TEXTRACT_DETECT_DOCUMENT_TEXT"    
 }          
        

Para obter mais informações sobre a sintaxe do comando, consulte a DetectEntitiesReferência da API Amazon Comprehend.