カスタムエンティティ認識でのリアルタイム分析 (API)

Amazon Comprehend API では、カスタムモデルを使用してリアルタイム分析を実行できます。最初に、リアルタイム分析を実行するためのエンドポイントを作成します。エンドポイントの作成が完了したなら、リアルタイム分析を実行します。

エンドポイントのスループットのプロビジョニングとそれに関連するコストについては、「Amazon Comprehend エンドポイントの使用法」を参照してください。

カスタムエンティティ検出用のエンドポイントの作成

プロキシエンドポイントに関係するコストについては、「Amazon Comprehend エンドポイントの使用法」を参照してください。

AWS CLI を使用したエンドポイントの作成

AWS CLI を使用してエンドポイントサービスを作成するには、create-endpoint コマンドを使用します。

$ aws comprehend create-endpoint \
> --desired-inference-units number of inference units \
> --endpoint-name endpoint name \
> --model-arn arn:aws:comprehend:region:account-id:model/example \
> --tags Key=Key,Value=Value

コマンドが成功すると、Amazon Comprehend はその応答としてエンドポイントの ARN を返します。

{
   "EndpointArn": "Arn"
}

このコマンドとそのパラメータ引数、出力の詳細については、『AWS CLI コマンドリファレンス』の「create-endpoint」を参照してください。

カスタムエンティティ検出のリアルタイム実行

カスタムエンティティレコグナイザーモデルのエンドポイントを作成したら、エンドポイントを使用して DetectEntities API オペレーションを実行します。text　または　bytes　のパラメータを使用してテキストを入力できます。その他の種類の入力には、bytes パラメータを利用します。

画像および PDF ファイルの場合は、DocumentReaderConfig パラメーターを使用してデフォルトのテキスト抽出アクションをオーバーライドできます。詳細については、「テキスト抽出オプションの設定」を参照してください。

AWS CLI を使用したテキスト内のエンティティの検出

テキスト内のカスタムエンティティを検出するには、text パラメータに入力テキストを指定して detect-entities コマンド実行します。

例 CLI を使用して入力テキスト内のエンティティを検出する

$ aws comprehend detect-entities \
> --endpoint-arn arn \
> --language-code en \
> --text  "Andy Jassy is the CEO of Amazon."

コマンドの実行に成功すると、Amazon Comprehend はその応答として分析を開始します。Amazon Comprehend は、検出したエンティティごとにそのエンティティタイプとテキスト、場所、および信頼スコアを提供します。

AWS CLI を使用した半構造化ドキュメント内のエンティティの検出

PDF や Word、あるいは画像ファイル内のカスタムエンティティを検出するには、bytes パラメータに入力ファイルを指定して、detect-entities コマンドを実行します。

例 : CLI を使用してイメージファイル内のエンティティを検出する

この例では、fileb オプションを使用して画像ファイルを渡して、画像のバイトをbase64 でエンコードする方法を示します。詳細については、『AWS Command Line Interface ユーザーガイド』の「バイナリラージオブジェクト」を参照してください。

この例では、テキスト抽出オプションを設定するために config.json という名前の JSON ファイルも渡しています。

$ aws comprehend detect-entities \
> --endpoint-arn arn \
> --language-code en \
> --bytes fileb://image1.jpg   \
> --document-reader-config file://config.json   
        

config.json ファイルには次のコンテンツが含まれます。

 {
    "DocumentReadMode": "FORCE_DOCUMENT_READ_ACTION",
    "DocumentReadAction": "TEXTRACT_DETECT_DOCUMENT_TEXT"    
 }          
        

コマンド構文の詳細については、「Amazon Comprehend API リファレンスDetectEntities」の「」を参照してください。