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

# Análise em tempo real para reconhecimento personalizado de entidades (API)
<a name="detecting-cer-real-time-api"></a>

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 [Utilizar endpoints do Amazon Comprehend](using-endpoints.md).

**Topics**
+ [Criação de um endpoint para detecção de entidades personalizadas](#detecting-cer-real-time-create-endpoint-api)
+ [Executar a detecção de entidades personalizadas em tempo real](#detecting-cer-real-time-run)

## Criação de um endpoint para detecção de entidades personalizadas
<a name="detecting-cer-real-time-create-endpoint-api"></a>

Para obter informações sobre os custos associados aos endpoints, consulte [Utilizar endpoints do Amazon Comprehend](using-endpoints.md).

### Criando um endpoint com o AWS CLI
<a name="detecting-cer-real-time-create-endpoint-examples"></a>

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

```
$ 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 [https://docs.aws.amazon.com/cli/latest/reference/comprehend/create-endpoint.html](https://docs.aws.amazon.com/cli/latest/reference/comprehend/create-endpoint.html) na Referência de comandos da AWS CLI .

## Executar a detecção de entidades personalizadas em tempo real
<a name="detecting-cer-real-time-run"></a>

Depois de criar um endpoint para seu modelo personalizado de reconhecimento de entidades, você usa o endpoint para executar a operação da [DetectEntities](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DetectEntities.html)API. Você pode fornecer entrada de texto usando os parâmetros`text` 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 [Configurar opções de extração de texto](idp-set-textract-options.md).

### Detectando entidades no texto usando o AWS CLI
<a name="detecting-cer-real-time-run-cli1"></a>

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

**Example : 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
<a name="detecting-cer-real-time-run-cli2"></a>

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

**Example : 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-types.html#parameter-type-blob) no Guia AWS Command Line Interface do usuário.   
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 [DetectEntities](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DetectEntities.html)Referência da API *Amazon Comprehend*.