Eventos

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

Entidades

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.

Eventos

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.

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

  • 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

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

Tipos de entidade

Tipo	Descrição
DATA	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

Tipo	Descrição
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

Tipos de argumentos para BANKRUPTCY
Tipo de argumento	Descrição
FILER	A pessoa ou empresa que declara a falência.
DATA	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	Descrição
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	Descrição
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.
DATA	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	Descrição
DATA	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	Descrição
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	Descrição
COMPANY	A empresa que emite ações do desdobramento de ações.
DATA	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.