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

# Eventos
<a name="how-events"></a>

**nota**  
Os recursos de modelagem de tópicos, detecção de eventos e classificação imediata de segurança do Amazon Comprehend não estão mais disponíveis para novos clientes. Nenhuma ação é necessária para contas que usaram esses recursos nos últimos 12 meses. Para obter mais informações, consulte [Alteração na disponibilidade do recurso Amazon Comprehend](comprehend-availability-change.md).

Use a *detecção de eventos* a fim de analisar documentos de texto para tipos específicos de eventos e suas entidades relacionadas. O Amazon Comprehend é compatível com a detecção de eventos em grandes coleções de documentos usando tarefas de análise assíncrona. Para mais informações sobre eventos, incluindo exemplos de tarefas de análise de eventos, consulte [Anunciando o lançamento do Amazon Comprehend Events](https://aws.amazon.com/blogs/machine-learning/announcing-the-launch-of-amazon-comprehend-events/)

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

Do texto de entrada, o Amazon Comprehend extrai uma lista de entidades relacionadas ao evento detectado. Uma *entidade* pode ser um objeto do mundo real, como uma pessoa, um lugar ou um local; uma entidade também pode ser um conceito, como uma medida, data ou quantidade. Cada ocorrência de uma entidade é identificada por uma *menção*, que é uma referência textual à entidade no texto de entrada. Para cada entidade exclusiva, todas as menções são agrupadas em uma lista. Essa lista fornece detalhes de cada local no texto de entrada em que a entidade ocorre. O Amazon Comprehend detecta somente as entidades associadas aos tipos de eventos compatíveis.

Cada entidade associada a um tipo de evento compatível retorna com os seguintes detalhes relacionados:
+ **Menções**: detalhes de cada ocorrência da mesma entidade no texto de entrada.
  + **BeginOffset**: um deslocamento de caracteres no texto de entrada que mostra onde a menção começa (o primeiro caractere está na posição 0). 
  + **EndOffset**: um deslocamento de caracteres no texto de entrada que mostra onde a menção termina.
  + **Score**: o nível de confiança que o Amazon Comprehend tem na precisão do tipo da entidade.
  + **GroupScore**: o nível de confiança do Amazon Comprehend de que a menção está corretamente agrupada com outras menções da mesma entidade.
  + **Texto**: o texto da entidade.
  + **Tipo**: o tipo da entidade. Para todos os tipos de entidades compatíveis, consulte [Tipos de entidade](#events-entity-types).

## Eventos
<a name="how-events-output"></a>

O Amazon Comprehend retorna a lista de eventos (dos tipos de eventos compatíveis) que ele detecta no texto de entrada. Cada evento retorna com os seguintes detalhes relacionados:
+ **Tipo**: o tipo do evento. Para uma lista dos tipos de evento compatíveis, consulte [Tipos de eventos](#events-types).
+ **Argumentos**: uma lista de argumentos relacionados ao evento detectado. Um *argumento* consiste em uma entidade relacionada ao evento detectado. O papel do argumento descreve o relacionamento, como *quem* fez *o quê*, *onde* e *quando*.
  + **EntityIndex**: um valor de índice que identifica uma entidade da lista de entidades que o Amazon Comprehend retornou para essa análise.
  + **Perfil**: o tipo de argumento, que descreve como a entidade desse argumento está relacionada ao evento. Para todos os tipos de argumentos compatíveis, consulte [Tipos de argumento](#events-argument-types).
  + **Score**: o nível de confiança que o Amazon Comprehend tem na precisão do tipo da entidade.
+ **Gatilhos**: uma lista de gatilhos para o evento detectado. Um *gatilho* é uma única palavra ou frase que indica a ocorrência do evento.
  + **BeginOffset**: um deslocamento de caracteres no texto de entrada que mostra onde o gatilho começa (o primeiro caractere está na posição 0).
  + **EndOffset**: um deslocamento de caracteres no texto de entrada que mostra onde o gatilho termina.
  + **Score**: o nível de confiança que o Amazon Comprehend tem na precisão da detecção.
  + **Texto**: o texto do gatilho.
  + **GroupScore**: o nível de confiança do Amazon Comprehend de que o gatilho está corretamente agrupado com outros gatilhos para o mesmo evento.
  + **Tipo**: o tipo de evento que esse gatilho indica.

## Detecte o formato de resultados de eventos
<a name="how-events-results"></a>

Quando sua tarefa de detecção de eventos é concluída, o Amazon Comprehend grava os resultados da análise no local de saída do Amazon S3 especificado ao iniciar a tarefa.

Para cada evento detectado, a saída fornece detalhes no seguinte formato:

```
{
   "Entities": [
     {
       "Mentions": [
         {
           "BeginOffset": number,
           "EndOffset": number,
           "Score": number,
           "GroupScore": number,
           "Text": "string",
           "Type": "string"
         }, ...
       ]    
     }, ...
   ],
   "Events": [
     {
       "Type": "string",
       "Arguments": [
         {                   
           "EntityIndex": number,   
           "Role": "string",
           "Score": number
         }, ...
       ],
       "Triggers": [
         {
           "BeginOffset": number,
           "EndOffset": number,
           "Score": number,
           "Text": "string",
           "GroupScore": number,
           "Type": "string"
         }, ...
       ]
     }, ...
   ]
 }
```

## Tipos compatíveis para entidades, eventos e argumentos
<a name="events-reference-types"></a>

### Tipos de entidade
<a name="events-entity-types"></a>


| Tipo | Description | 
| --- | --- | 
| DATE | Qualquer referência a uma data ou hora, seja específica ou geral. | 
| FACILITY | Edifícios, aeroportos, rodovias, pontes e outras estruturas permanentes feitas pelo homem e melhorias imobiliárias. | 
| LOCALIZAÇÃO | Localizações físicas, como ruas, cidades, estados, países, corpos d'água ou coordenadas geográficas. | 
| MONETARY\_VALUE | O valor de algo nos EUA ou em outra moeda. O valor pode ser específico ou aproximado. | 
| ORGANIZATION | Empresas e outros grupos de pessoas definidos por uma estrutura organizacional estabelecida. | 
| PERSON | Os nomes ou apelidos de indivíduos ou personagens fictícios. | 
| PERSON\_TITLE | Qualquer título que descreva uma pessoa, que geralmente é uma categoria de emprego (como CEO) ou honorífico (como Sr.). | 
| QUANTITY | Um número ou valor e a unidade de medida. | 
| STOCK\_CODE | Um símbolo de cotação da bolsa, como AMZN, um International Securities Identification Number (ISIN — Número Internacional de Identificação de Valores Mobiliários), Committee on Uniform Securities Identification Procedures (CUSIP — Comitê de Procedimentos Uniformes de Identificação de Valores Mobiliários) ou Stock Exchange Daily Official List (SEDOL — Lista Oficial Diária da Bolsa de Valores). | 

### Tipos de eventos
<a name="events-types"></a>


| Tipo | Description | 
| --- | --- | 
| BANKRUPTCY | Um processo legal envolvendo uma pessoa ou empresa incapaz de pagar dívidas pendentes. | 
| EMPLOYMENT | Ocorre quando um funcionário é contratado, demitido, aposentado ou muda de outra forma o estado de emprego.  | 
| CORPORATE\_ACQUISTION | Ocorre quando uma empresa obtém a posse da maioria ou de todas as ações ou ativos físicos de outra empresa para obter o controle dela. | 
| INVESTMENT\_GENERAL | Ocorre quando uma pessoa ou empresa compra um ativo com a perspectiva de gerar renda ou valorização futura. | 
| CORPORATE\_MERGER | Ocorre quando duas ou mais empresas se unem para criar uma nova entidade legal.  | 
| IPO | Uma initial public offering (IPO — oferta pública inicial) de ações de uma empresa privada ao público em uma nova emissão de ações. | 
| RIGHTS\_ISSUE | Um grupo de direitos oferecidos aos acionistas existentes para comprar ações adicionais, conhecidas como garantias de subscrição, na proporção de suas participações existentes. | 
| SECONDARY\_OFFERING | Uma oferta de valores mobiliários feita por um acionista de uma empresa.  | 
| SHELF\_OFFERING | Uma disposição da Securities and Exchange Commission (SEC — Comissão de Valores Mobiliários) que permite que um emissor registre uma nova emissão de título e venda partes da emissão por um período de tempo sem registrar novamente o título ou incorrer em penalidades. Também conhecido como registro de prateleira. | 
| TENDER\_OFFERING | Uma oferta para comprar algumas ou todas as ações dos acionistas de uma empresa. | 
| STOCK\_SPLIT | Ocorre quando o conselho de administração de uma empresa aumenta o número de ações em circulação emitindo mais ações aos acionistas atuais. Este evento também se aplica a divisões reversas de ações. | 

### Tipos de argumento
<a name="events-argument-types"></a>


**Tipos de argumentos para BANKRUPTCY**  

| Tipo de argumento | Description | 
| --- | --- | 
| FILER | A pessoa ou empresa que declara a falência.  | 
| DATE | A data ou hora da falência. | 
| PLACE | Local ou instalação onde (ou mais próximo de onde) ocorreu a falência. | 


**Tipos de argumentos para EMPLOYMENT**  

| Tipo | Description | 
| --- | --- | 
| EMPLOYEES | A pessoa empregada por uma empresa. | 
| EMPLOYEE\_TITLE | O título do funcionário. | 
| EMPLOYER | A pessoa ou empresa que emprega o funcionário. | 
| START\_DATE | A data ou hora de início do emprego. | 
| END\_DATE | A data ou hora de término do emprego. | 


**Tipos de argumentos para CORPORATE\_ACQUISTION e INVESTMENT\_GENERAL**  

| Tipo | Description | 
| --- | --- | 
| AMOUNT | O valor monetário associado à transação. | 
| INVESTEE | A pessoa ou empresa associada ao investimento. | 
| INVESTOR | A pessoa ou empresa que investe no ativo. | 
| DATE | A data ou a hora da aquisição ou do investimento. | 
| PLACE | Local onde (ou mais próximo de onde) a aquisição ou investimento ocorreu. | 


**Tipos de argumentos para CORPORATE\_MERGER**  

| Tipo | Description | 
| --- | --- | 
| DATE | A data ou a hora da fusão. | 
| NEW\_COMPANY | A nova entidade legal resultante da fusão. | 
| PARTICIPANT | A empresa envolvida na fusão. | 


**Tipos de argumentos para IPO, RIGHTS\_ISSUE, SECONDARY\_OFFERING, SHELF\_OFFERING e TENDER\_OFFERING**  

| Tipo | Description | 
| --- | --- | 
| EXPIRE\_DATE | A data ou hora de expiração da oferta. | 
| INVESTOR | A pessoa ou empresa que investe no ativo. | 
| OFFEREE | A pessoa ou empresa que recebe a oferta. | 
| OFFERING\_AMOUNT | O valor monetário associado à oferta. | 
| OFFERING\_DATE | A data ou hora da oferta. | 
| OFFEROR | A pessoa ou empresa que está iniciando a oferta. | 
| OFFEROR\_TOTAL\_VALUE | O valor monetário total associado à oferta. | 
| RECORD\_DATE | A data ou hora de registro da oferta. | 
| SELLING\_AGENT | A pessoa ou empresa que facilita a venda da oferta.  | 
| SHARE\_PRICE | O valor monetário associado ao preço da ação. | 
| SHARE\_QUANTITY | O número de ações associadas à oferta. | 
| UNDERWRITERS | A empresa associada à subscrição da oferta. | 


**Tipos de argumentos para STOCK\_SPLIT**  

| Tipo | Description | 
| --- | --- | 
| COMPANY | A empresa que emite ações do desdobramento de ações. | 
| DATE | A data ou hora do desdobramento de ações. | 
| SPLIT\_RATIO | A proporção entre o aumento do novo número de ações em circulação e o número atual de ações antes de seu desdobramento.  |