イベント

イベント検出を使用して、特定のタイプのイベントとそれに関連するエンティティについてテキストドキュメントを分析することができます。Amazon Comprehend では、非同期分析ジョブを使用して、大量のドキュメントコレクションにまたがるイベント検出を行うことができます。イベント分析ジョブの例を含むイベントの詳細については、「Amazon Comprehend Events の開始のお知らせ」を参照してください。

エンティティ

Amazon Comprehend は、入力テキストから、検出されたイベントに関連するエンティティのリストを抽出します。エンティティは、人や位置、あるいは場所などの現実世界のオブジェクトである場合もあれば、測定値や日付、あるいは数量などの概念である場合もあります。エンティティが出現すると、それぞれメンションで識別されます。メンションは、入力テキスト内のエンティティに対するテキスト参照です。一意のエンティティごとに、すべてのメンションが 1 つのリストにまとめられます。このリストには、エンティティが出現する入力テキスト内の各場所の詳細情報が提供されます。Amazon Comprehend は、サポートされているイベントタイプに関連付けられているエンティティのみを検出します。

サポートされているイベントタイプに関連付けられている各エンティティについて、以下の関連情報が返されます。

• MenMentions: 入力テキストにおける同じエンティティの各出現に関する詳細情報。

  • BeginOffset: 言及が始まる場所を示す入力テキストの文字オフセット (最初の文字は位置 0)。

  • EndOffset: 言及が終了する場所を示す入力テキストの文字オフセット。

  • Score: Amazon Comprehend におけるエンティティのタイプの精度の信頼度。

  • GroupScore: Amazon Comprehend から、同じエンティティの他のメンションと正しくグループ化されているという信頼度。

  • Text: エンティティのテキスト。

  • Type: エンティティのタイプ。サポートされているすべてのエンティティタイプについては、「エンティティタイプ」を参照してください。

イベント

Amazon Comprehend は、入力テキストで検出されたイベント(サポートされているイベントタイプのイベント)のリストを返します。各イベントについて、以下の関連情報が返されます。

• Type: イベントのタイプ。サポートされているすべてのエンティティタイプについては、「イベントタイプ」を参照してください。

• Arguments: 検出されたイベントに関連する引数のリスト。引数は、検出されたイベントに関連するエンティティ 1 つで構成されます。引数の役割は、誰がいつ、どこで何をしたかなどの関係を表すことです。

  • EntityIndex: Amazon Comprehend がこの分析のために返したエンティティのリストからエンティティを識別するインデックス値。

  • Role: 引数のタイプ。この引数のエンティティとイベントとの関係を表します。サポートされているすべての引数の型については、引数の型を参照してください。

  • Score: Amazon Comprehend における役割検出の精度の信頼度。

• Triggers: 検出されたイベントのトリガーのリスト。トリガーとは、イベントの発生を示す 1 つの単語またはフレーズです。

  • BeginOffset: トリガーが始まる場所を示す入力テキストの文字オフセット (最初の文字は位置 0)。

  • EndOffset: トリガーの終了位置を示す入力テキストの文字オフセット。

  • Score: Amazon Comprehend における検出の精度の信頼度。

  • Text: トリガーのテキスト。

  • GroupScore: トリガーが同じイベントの他のトリガーと正しくグループ化されているという Amazon Comprehend の信頼度。

  • Type: このトリガーが示すイベントのタイプ。

イベント検出結果の形式

イベント検出ジョブが完了すると、Amazon Comprehend は、ジョブの開始時に指定された Amazon S3 上の出力場所に分析結果を書き込みます。

検出された各イベントの出力には、以下の形式でその詳細が提供されます。

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

サポートされているエンティティ、イベント、引数のタイプ

エンティティタイプ

型	説明
DATE	日付または時刻の参照 (具体的か否かを問わず)。
FACILITY	建物、空港、高速道路、橋、その他の恒久的な人工構造物および不動産の改良。
LOCATION	道路、都市、州、国、水域、地理座標などの物理的な場所。
MONETARY_VALUE	米国またはその他の通貨でのモノの価値。価値は具体的なこともあれば、概算値のこともあります。
ORGANIZATION	企業または確立された組織体制で団体。
PERSON	個人または架空の人物の名前またはニックネーム。
PERSON_TITLE	個人を説明する任意のタイトル。通常は雇用カテゴリー (CEO など) または敬語 (Mr. など)。
QUANTITY	数値または値と測定単位。
STOCK_CODE	AMZN、国際証券識別番号 (ISIN)、統一証券識別手続き委員会 (CUSIP)、証券取引所日報公式リスト (SEDOL) などの株式ティッカーシンボル。

イベントタイプ

型	説明
BANKRUPTCY	個人または企業が未払いの債務を返済できないこに伴う法的手続き。
EMPLOYMENT	従業員の採用、解雇、退職、その他の雇用状態の変化があると発生するイベント。
CORPORATE_ACQUISTION	会社が他社の株式または有形資産のほとんどまたは全部の所有権を取得して、その会社の支配権を獲得すると発生するイベント。
INVESTMENT_GENERAL	個人または企業が将来の収入または評価を生み出す見込みのある資産を購入すると発生するイベント。
CORPORATE_MERGER	2 つ以上の会社が合併して新しい法人を設立すると発生するイベント。
IPO	新規株式発行時に民間企業の株式を一般に公開する新規株式公開（IPO）を行うと発生するベント。
RIGHTS_ISSUE	既存の株主に既存の保有株式に比例して追加の株式を購入するために提供される一群の権利 (新株予約権と呼ばれる)。
SECONDARY_OFFERING	会社の株主による有価証券の売り出し。
SHELF_OFFERING	証券取引委員会 (SEC) の規定。発行者が証券を再登録したり、罰金を科されたりすることなく、新規発行証券を登録し、一定期間にわたってその一部を売却することを許可する規定。シェルフレジストレーションともいいます。
TENDER_OFFERING	会社の株主の株式の一部または全部を購入する申し出。
STOCK_SPLIT	企業の取締役会が、現在の株主に発行する株式数を増やして発行済株式数を増やすと発生するイベント。このイベントは株式の逆分割にも当てはまります。

引数の型

BANKRUPTCYの引数の型
引数の型	説明
FILER	破産を申請した個人または会社。
DATE	破産した日付または時刻。
PLACE	破産が発生した (またはその場所に最も近い) 場所または施設。

EMPLOYMENTの引数の型
型	説明
EMPLOYEES	会社に雇用されている人。
EMPLOYEE_TITLE	従業員の役職。
EMPLOYER	従業員を雇用している個人または会社。
START_DATE	雇用の開始日または時刻。
END_DATE	雇用の終了日または時刻。

CORPORATE_ACQUISTION、INVESTMENT_GENERAL の引数の型
型	説明
AMOUNT	取引に関係する金銭的価値。
INVESTEE	投資に関係する個人または会社。
INVESTOR	資産に投資にした個人または会社。
DATE	買収または投資の日付または時刻。
PLACE	買収または投資が行われた (またはその場所に最も近い) 場所。

CORPORATE_MERGER の引数の型
型	説明
DATE	合併の日付または時刻。
NEW_COMPANY	合併で生まれた新しい法人。
PARTICIPANT	合併に関わった会社。

IPO、RIGHTS_ISSUE、SECONDARY_OFFERING、SHELF_OFFERING、TENDER_OFFERING の引数の型
型	説明
有効期限	売り出しの有効期限または時刻。
INVESTOR	資産に投資にした個人または会社。
OFFEREE	売り出しを受けた個人または会社。
OFFERING_AMOUNT	売り出しに関係する金銭的価値。
OFFERING_DATE	売り出しの日付または時刻。
OFFEROR	売り出しを開始した個人または会社。
OFFEROR_TOTAL_VALUE	売り出しに関係する金銭的価値の合計。
RECORD_DATE	売り出しの記録日付または時刻。
SELLING_AGENT	売り出しの販売を促進する個人または会社。
SHARE_PRICE	株式価格に関係する金銭的価値。
SHARE_QUANTITY	売り出しに関係する株式数。
UNDERWRITERS	売り出しの引受に関係する会社。

STOCK_SPLIT の引数の型
型	説明
COMPANY	株式分割の株式を発行する会社。
DATE	株式分割の日付または時刻。
SPLIT_RATIO	株式分割前の現在の株式数に対する新規発行済株式数の増加率。