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

# Entidades
<a name="how-entities"></a>

Uma *entidade* é uma referência textual ao nome exclusivo de um objeto do mundo real, como pessoas, lugares e itens comerciais, e a referências precisas a medidas, como datas e quantidades.

Por exemplo, no texto “John mudou-se para Mockingbird Lane, 1313 em 2012”, “John” pode ser reconhecido como um `PERSON`, “Mockingbird Lane, 1313” pode ser reconhecido como um `LOCATION` e “2012" pode ser reconhecido como um `DATE`.

Cada entidade também tem uma pontuação que indica o nível de confiança que o Amazon Comprehend tem de que ele detectou corretamente o tipo de entidade. Você pode filtrar as entidades com pontuações mais baixas para reduzir o risco de usar detecções incorretas.

A tabela a seguir lista os tipos de entidades. 


| Tipo | Description | 
| --- | --- | 
| COMMERCIAL\_ITEM | Um produto de marca | 
| DATE | Uma data completa (por exemplo, 11/25 /2017), dia (terça-feira), mês (maio) ou hora (8h30) | 
| EVENTO | Um evento, como um festival, concerto, eleição etc. | 
| LOCALIZAÇÃO | Um local específico, como um país, cidade, lago, prédio etc. | 
| ORGANIZATION | Grandes organizações, como governo, empresa, religião, equipe esportiva etc. | 
| OUTRO | Entidades que não se encaixam em nenhuma das outras categorias de entidades. | 
| PERSON | Indivíduos, grupos de pessoas, apelidos, personagens fictícios | 
| QUANTITY | Um valor quantificado, como moedas, porcentagens, números, bytes etc. | 
| TÍTULO | Nome oficial dado a qualquer criação ou trabalho criativo, como filmes, livros, músicas etc. | 

As operações de detecção de entidades podem ser realizadas usando qualquer uma das linguagens principais compatíveis com o Amazon Comprehend. Isso inclui somente a detecção de entidades predefinida (não personalizada). Todos os documentos devem estar no mesmo idioma.

Você pode usar qualquer uma das operações de API a seguir para detectar entidades em um documento ou conjunto de documentos.
+ [DetectEntities](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DetectEntities.html)
+  [BatchDetectEntities](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_BatchDetectEntities.html)
+  [StartEntitiesDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartEntitiesDetectionJob.html)

As operações retornam uma lista de objetos de [Entidades de API](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_Entity.html), uma para cada entidade no documento. A operação `BatchDetectEntities` retorna uma lista de objetos `Entity`, uma lista para cada documento no lote. A operação `StartEntitiesDetectionJob` inicia uma tarefa assíncrona que produz um arquivo contendo uma lista de objetos `Entity` para cada documento na tarefa.

O exemplo a seguir é a resposta da operação `DetectEntities`.

```
{
    "Entities": [
        {
            "Text": "today",
            "Score": 0.97,
            "Type": "DATE",
            "BeginOffset": 14,
            "EndOffset": 19
        },
        {
            "Text": "Seattle",
            "Score": 0.95,
            "Type": "LOCATION",
            "BeginOffset": 23,
            "EndOffset": 30
        }
    ],
    "LanguageCode": "en"
}
```