Événements

Utilisez la détection d'événements pour analyser des documents texte afin de détecter des types d'événements spécifiques et leurs entités associées. Amazon Comprehend prend en charge la détection d'événements dans de grandes collections de documents à l'aide de tâches d'analyse asynchrones. Pour plus d'informations sur les événements, y compris des exemples de tâches d'analyse d'événements, consultez Annonce du lancement d'Amazon Comprehend Events

Entités

À partir du texte saisi, Amazon Comprehend extrait une liste d'entités associées à l'événement détecté. Une entité peut être un objet du monde réel, tel qu'une personne, un lieu ou un lieu ; une entité peut également être un concept, tel qu'une mesure, une date ou une quantité. Chaque occurrence d'une entité est identifiée par une mention, qui est une référence textuelle à l'entité dans le texte saisi. Pour chaque entité unique, toutes les mentions sont regroupées dans une liste. Cette liste fournit des détails pour chaque emplacement dans le texte d'entrée où l'entité apparaît. Amazon Comprehend détecte uniquement les entités associées aux types d'événements pris en charge.

Chaque entité associée à un type d'événement pris en charge renvoie les informations associées suivantes :

• Mentions : détails pour chaque occurrence de la même entité dans le texte saisi.

  • BeginOffset: décalage de caractères dans le texte saisi qui indique le début de la mention (le premier caractère est à la position 0).

  • EndOffset: décalage de caractères dans le texte saisi qui indique la fin de la mention.

  • Score : niveau de confiance d'Amazon Comprehend quant à la précision du type d'entité.

  • GroupScore: le niveau de confiance d'Amazon Comprehend quant au fait que la mention est correctement regroupée avec d'autres mentions de la même entité.

  • Texte : texte de l'entité.

  • Type : type de l'entité. Pour tous les types d'entités pris en charge, consultezTypes d'entités.

Événements

Amazon Comprehend renvoie la liste des événements (des types d'événements pris en charge) détectés dans le texte saisi. Chaque événement revient avec les informations connexes suivantes :

• Type : type d'événement. Pour tous les types d'événements pris en charge, consultezTypes d’événements.

• Arguments : liste d'arguments liés à l'événement détecté. Un argument est constitué d'une entité associée à l'événement détecté. Le rôle de l'argument décrit la relation, par exemple qui a fait quoi, où et quand.

  • EntityIndex: valeur d'index identifiant une entité dans la liste des entités renvoyées par Amazon Comprehend pour cette analyse.

  • Rôle : type d'argument, qui décrit comment l'entité associée à cet argument est liée à l'événement. Pour tous les types d'arguments pris en charge, consultezTypes d'arguments.

  • Score : niveau de confiance d'Amazon Comprehend quant à la précision de la détection des rôles.

• Déclencheurs : liste des déclencheurs pour l'événement détecté. Un déclencheur est un mot ou une phrase unique qui indique la survenance de l'événement.

  • BeginOffset: décalage de caractères dans le texte saisi qui indique le point de départ du déclencheur (le premier caractère est à la position 0).

  • EndOffset: décalage de caractères dans le texte saisi qui indique où se termine le déclencheur.

  • Score : niveau de confiance d'Amazon Comprehend quant à la précision de la détection.

  • Texte : texte du déclencheur.

  • GroupScore: le niveau de confiance d'Amazon Comprehend quant au fait que le déclencheur est correctement regroupé avec d'autres déclencheurs pour le même événement.

  • Type : type d'événement indiqué par ce déclencheur.

Format des résultats de détection des événements

Lorsque votre tâche de détection d'événements est terminée, Amazon Comprehend écrit les résultats de l'analyse sur l'emplacement de sortie Amazon S3 que vous avez spécifié lorsque vous avez commencé la tâche.

Pour chaque événement détecté, la sortie fournit des détails au format suivant :

{
   "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"
         }, ...
       ]
     }, ...
   ]
 }

Types pris en charge pour les entités, les événements et les arguments

Types d'entités

Type	Description
DATE	Toute référence à une date ou à une heure, qu'elle soit spécifique ou générale.
INSTALLATION	Bâtiments, aéroports, autoroutes, ponts et autres structures humaines permanentes et améliorations immobilières.
LOCATION	Emplacements physiques tels que les rues, les villes, les États, les pays, les plans d'eau ou les coordonnées géographiques.
VALEUR_MONÉTAIRE	La valeur d'un objet en dollars américains ou dans une autre devise. La valeur peut être spécifique ou approximative.
ORGANISATION	Entreprises et autres groupes de personnes définis par une structure organisationnelle établie.
LA PERSONNE	Les noms ou surnoms d'individus ou de personnages fictifs.
TITRE DE LA PERSONNE	Tout titre décrivant une personne, qui est généralement une catégorie d'emploi (comme PDG) ou honorifique (comme M.).
QUANTITÉ	Un nombre ou une valeur et l'unité de mesure.
STOCK_CODE	Un symbole boursier, tel que AMZN, un numéro international d'identification des titres (ISIN), le Committee on Uniform Securities Identification Procedures (CUSIP) ou la Stock Exchange Daily Official List (SEDOL).

Types d’événements

Type	Description
FAILLITE	Procédure judiciaire impliquant une personne ou une entreprise incapable de rembourser ses dettes impayées.
EMPLOI	Se produit lorsqu'un employé est embauché, licencié, mis à la retraite ou change de statut d'emploi de toute autre manière.
ACQUISITION D'ENTREPRISE	Se produit lorsqu'une entreprise obtient la possession de la plupart ou de la totalité des actions ou des actifs physiques d'une autre société pour prendre le contrôle de cette société.
INVESTISSEMENT_GÉNÉRAL	Se produit lorsqu'une personne ou une entreprise achète un actif dans la perspective de générer des revenus ou une appréciation futurs.
FUSION_ENTREPRISE	Se produit lorsque deux entreprises ou plus s'unissent pour créer une nouvelle entité juridique.
INTRODUCTION EN BOURSE	Une offre publique initiale (IPO) d'actions d'une société privée au public dans le cadre d'une nouvelle émission d'actions.
PROBLÈME_DROIT	Un ensemble de droits offerts aux actionnaires existants pour acheter des actions supplémentaires, appelés bons de souscription, proportionnellement à leurs avoirs existants.
OFFRE_SECONDAIRE	Offre de titres par un actionnaire d'une société.
SHELF_OFFERING	Une disposition de la Securities and Exchange Commission (SEC) qui permet à un émetteur d'enregistrer une nouvelle émission de titre et d'en vendre des parties sur une certaine période sans réenregistrer le titre ni encourir de pénalités. Également connu sous le nom d'enregistrement en rayon.
OFFRE_D'OFFRES	Offre d'achat d'une partie ou de la totalité des actions détenues par les actionnaires d'une entreprise.
STOCK_SPLIT	Se produit lorsque le conseil d'administration d'une entreprise augmente le nombre d'actions en circulation en émettant davantage d'actions aux actionnaires actuels. Cet événement s'applique également aux scissions inversées d'actions.

Types d'arguments

Types d'arguments en cas de FAILLITE

Type d'argument	Description
FILTRE	La personne ou l'entreprise qui déclare faillite.
DATE	La date ou l'heure de la faillite.
ENDROIT	Lieu ou établissement où (ou le plus proche de l'endroit) la faillite a eu lieu.

Types d'arguments en faveur de l'EMPLOI

Type	Description
EMPLOYÉ	La personne employée par une entreprise.
TITLE_EMPLOYÉ	Titre de l'employé.
EMPLOYEUR	La personne ou l'entreprise qui emploie l'employé.
START_DATE	La date ou l'heure de début de l'emploi.
DATE DE FIN	La date ou l'heure de fin de l'emploi.

Types d'arguments pour CORPORATE_ACQUISTION, INVESTMENT_GENERAL

Type	Description
MONTANT	La valeur monétaire associée à la transaction.
ENTITÉ INVESTIE	La personne ou l'entreprise associée à l'investissement.
INVESTISSEUR	La personne ou l'entreprise qui investit dans l'actif.
DATE	Date ou heure de l'acquisition ou de l'investissement.
ENDROIT	Lieu où (ou le plus proche de l'endroit) l'acquisition ou l'investissement a eu lieu.

Types d'arguments pour CORPORATE_MERGER

Type	Description
DATE	Date ou heure de la fusion.
NOUVELLE_ENTREPRISE	La nouvelle entité juridique issue de la fusion.
PARTICIPANT	La société impliquée dans la fusion.

Types d'arguments pour IPO, RIGHTS_ISSUE, SECONDARY_OFFERING, SHELF_OFFERING, TENDER_OFFERING

Type	Description
DATE_D'EXPIRATION	Date ou heure d'expiration de l'offre.
INVESTISSEUR	La personne ou l'entreprise qui investit dans l'actif.
DESTINATAIRE	La personne ou l'entreprise qui reçoit l'offre.
MONTANT_DE L'OFFRE	La valeur monétaire associée à l'offre.
DATE_D'OFFRE	La date ou l'heure de l'offre.
QUI OFFRE	La personne ou l'entreprise à l'origine de l'offre.
VALEUR_TOTAL_DE L'OFFREUR	La valeur monétaire totale associée à l'offre.
DATE_D'ENREGISTREMENT	Date ou heure d'enregistrement de l'offre.
AGENT DE VENTE	La personne ou l'entreprise qui facilite la vente de l'offre.
PRIX_ACTION	La valeur monétaire associée au cours de l'action.
PARTAGER_QUANTITÉ	Le nombre d'actions associées à l'offre.
SOUSCRIPTEURS	La société associée à la souscription de l'offre.

Types d'arguments pour STOCK_SPLIT

Type	Description
ENTREPRISE	La société émettrice des actions s'est scindée.
DATE	Date ou heure du fractionnement des actions.
RATIO DE DIVISION	Le ratio entre l'augmentation du nombre de nouvelles actions en circulation et le nombre actuel d'actions avant le fractionnement des actions.