翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

**注記**  
Amazon Comprehend トピックモデリング、イベント検出、プロンプト安全分類機能は、新規のお客様に利用できなくなりました。過去 12 か月以内にこれらの機能を使用したアカウントには、アクションは必要ありません。詳細については、「[Amazon Comprehend 機能の可用性の変更](comprehend-availability-change.md)」を参照してください。

イベント検出を使用して、特定のタイプのイベントとそれに関連するエンティティについてテキストドキュメントを分析することができます。Amazon Comprehend では、非同期分析ジョブを使用して、大量のドキュメントコレクションにまたがるイベント検出を行うことができます。イベント分析ジョブの例を含むイベントの詳細については、「[Amazon Comprehend Events の開始のお知らせ](https://aws.amazon.com/blogs/machine-learning/announcing-the-launch-of-amazon-comprehend-events/)」を参照してください。

## エンティティ
<a name="how-events-entities"></a>

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

サポートされているイベントタイプに関連付けられている各エンティティについて、以下の関連情報が返されます。
+ **MenMentions**: 入力テキストにおける同じエンティティの各出現に関する詳細情報。
  + **BeginOffset**: 入力テキストにおけるメンションの開始位置を示す文字オフセット （先頭文字は位置 0）。
  + **EndOffset**: 入力テキストにおけるメンションの終了位置を示す文字オフセット。
  + **Score**: Amazon Comprehend におけるエンティティのタイプの精度の信頼度。
  + **GroupScore**: Amazon Comprehend における、このメンションと同じエンティティの他のメンションとの間のグループ化の正しさの信頼度。
  + **Text**: エンティティのテキスト。
  + **Type**: エンティティのタイプ。サポートされているすべてのエンティティタイプについては、「[エンティティタイプ](#events-entity-types)」を参照してください。

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

Amazon Comprehend は、入力テキストで検出されたイベント(サポートされているイベントタイプのイベント)のリストを返します。各イベントについて、以下の関連情報が返されます。
+ **Type**: イベントのタイプ。サポートされているすべてのイベントタイプについては、「[イベントタイプ](#events-types)」を参照してください。
+ **Arguments**: 検出されたイベントに関連する引数のリスト。引数は、検出されたイベントに関連するエンティティ 1 つで構成されます。引数の役割は、誰がいつ、どこで何をしたかなどの関係を表すことです。
  + **EntityIndex**: Amazon Comprehend がこの分析で返したエンティティのリストにあるエンティティを識別するインデックス値。
  + **Role**: 引数のタイプ。この引数のエンティティとイベントとの関係を表します。サポートされているすべての引数の型については、[引数の型](#events-argument-types)を参照してください。
  + **Score**: Amazon Comprehend における役割検出の精度の信頼度。
+ **Triggers**: 検出されたイベントのトリガーのリスト。トリガーとは、イベントの発生を示す 1 つの単語またはフレーズです。
  + **BeginOffset**: 入力テキストにおけるトリガーの開始位置を示す文字オフセット （先頭文字は位置 0）。
  + **EndOffset**: 入力テキストにおけるトリガーの終了位置を示す文字オフセット。
  + **Score**: Amazon Comprehend における検出の精度の信頼度。
  + **Text**: トリガーのテキスト。
  + **GroupScore**: Amazon Comprehend における、このトリガーと同じエンティティの他のトリガーとの間のグループ化の正しさの信頼度。
  + **Type**: このトリガーが示すイベントのタイプ。

## イベント検出結果の形式
<a name="how-events-results"></a>

イベント検出ジョブが完了すると、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"
         }, ...
       ]
     }, ...
   ]
 }
```

## サポートされているエンティティ、イベント、引数のタイプ
<a name="events-reference-types"></a>

### エンティティタイプ
<a name="events-entity-types"></a>


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

### イベントタイプ
<a name="events-types"></a>


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

### 引数の型
<a name="events-argument-types"></a>


**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 | 株式分割前の現在の株式数に対する新規発行済株式数の増加率。 |