前提条件注釈前 Lambda 関数をテストする注釈後 Lambda 関数をテストする

注釈前および注釈後の Lambda 関数をテストする

Lambda コンソールで、注釈前と注釈後の Lambda 関数をテストできます。Lambda を初めて使用する場合は、 AWS Lambda デベロッパーガイドのコンソールで Lambda 関数を作成するのチュートリアルを使用し、Lambda 関数をコンソールでテストまたは呼び出す方法を学習できます。このページのセクションを使用して、 AWS Serverless Application Repository () を通じて提供される Ground Truth 注釈前テンプレートと注釈後テンプレートをテストする方法について説明しますSAR。

前提条件

このページで説明されているテストを使用するには、次の操作を行う必要があります。

Lambda コンソールへのアクセスと、Lambda 関数を作成して呼び出すためのアクセス許可が必要です。これらのアクセス許可の設定方法については、「AWS Lambda 関数を作成および選択するアクセス許可を付与する」を参照してください。
Ground Truth SARレシピをデプロイしていない場合は、の手順を使用してGround Truth テンプレートを使用して Lambda 関数を作成するデプロイします。

注釈後の Lambda 関数をテストするには、Amazon S3 にサンプル注釈データを含むデータファイルが必要です。簡単なテストでは、次のコードをコピーしてファイルに貼り付け、sample-annotations.json として保存し、このファイルを Amazon S3 にアップロードします。URI このファイルの S3 に注意してください。注釈後の Lambda テストを設定するには、この情報が必要です。


[{"datasetObjectId":"0","dataObject":{"content":"To train a machine learning model, you need a large, high-quality, labeled dataset. Ground Truth helps you build high-quality training datasets for your machine learning models."},"annotations":[{"workerId":"private.us-west-2.0123456789","annotationData":{"content":"{\"crowd-entity-annotation\":{\"entities\":[{\"endOffset\":8,\"label\":\"verb\",\"startOffset\":3},{\"endOffset\":27,\"label\":\"adjective\",\"startOffset\":11},{\"endOffset\":33,\"label\":\"object\",\"startOffset\":28},{\"endOffset\":51,\"label\":\"adjective\",\"startOffset\":46},{\"endOffset\":65,\"label\":\"adjective\",\"startOffset\":53},{\"endOffset\":74,\"label\":\"adjective\",\"startOffset\":67},{\"endOffset\":82,\"label\":\"adjective\",\"startOffset\":75},{\"endOffset\":102,\"label\":\"verb\",\"startOffset\":97},{\"endOffset\":112,\"label\":\"verb\",\"startOffset\":107},{\"endOffset\":125,\"label\":\"adjective\",\"startOffset\":113},{\"endOffset\":134,\"label\":\"adjective\",\"startOffset\":126},{\"endOffset\":143,\"label\":\"object\",\"startOffset\":135},{\"endOffset\":169,\"label\":\"adjective\",\"startOffset\":153},{\"endOffset\":176,\"label\":\"object\",\"startOffset\":170}]}}"}}]},{"datasetObjectId":"1","dataObject":{"content":"Sift 3 cups of flour into the bowl."},"annotations":[{"workerId":"private.us-west-2.0123456789","annotationData":{"content":"{\"crowd-entity-annotation\":{\"entities\":[{\"endOffset\":4,\"label\":\"verb\",\"startOffset\":0},{\"endOffset\":6,\"label\":\"number\",\"startOffset\":5},{\"endOffset\":20,\"label\":\"object\",\"startOffset\":15},{\"endOffset\":34,\"label\":\"object\",\"startOffset\":30}]}}"}}]},{"datasetObjectId":"2","dataObject":{"content":"Jen purchased 10 shares of the stock on Janurary 1st, 2020."},"annotations":[{"workerId":"private.us-west-2.0123456789","annotationData":{"content":"{\"crowd-entity-annotation\":{\"entities\":[{\"endOffset\":3,\"label\":\"person\",\"startOffset\":0},{\"endOffset\":13,\"label\":\"verb\",\"startOffset\":4},{\"endOffset\":16,\"label\":\"number\",\"startOffset\":14},{\"endOffset\":58,\"label\":\"date\",\"startOffset\":40}]}}"}}]},{"datasetObjectId":"3","dataObject":{"content":"The narrative was interesting, however the character development was weak."},"annotations":[{"workerId":"private.us-west-2.0123456789","annotationData":{"content":"{\"crowd-entity-annotation\":{\"entities\":[{\"endOffset\":29,\"label\":\"adjective\",\"startOffset\":18},{\"endOffset\":73,\"label\":\"adjective\",\"startOffset\":69}]}}"}}]}]

の手順に従って注釈にアクセスするための注釈後の Lambda アクセス許可を付与する、ラベル付けジョブの作成に使用する実行ロールを引き受けるための注釈後の Lambda 関数 SageMaker の実行ロールアクセス許可を付与する必要があります。注釈後 Lambda 関数は、 SageMaker 実行ロールを使用して S3 の注釈データファイル sample-annotations.jsonにアクセスします。

注釈前 Lambda 関数をテストする

Ground Truth AWS Serverless Application Repository （SAR) レシピをデプロイしたときに作成された注釈前 Lambda 関数をテストするには、次の手順に従います。

Ground Truth SARレシピの注釈前 Lambda 関数をテストする

Lambda コンソールの [Functions] (関数) ページを開きます。
Ground Truth SARレシピからデプロイされた注釈前関数を選択します。この関数の名前は、serverlessrepo-aws-sagema-GtRecipePreHumanTaskFunc-<id> と同様の名前になります。
[Code source] (コードソース) セクションで、[Test] (テスト) の横にある矢印を選択します。
[Configure test event] (テストイベントを構成する) を選択します。
[Create new test event] (新しいテストイベントの作成) オプションを選択したままにします。
イベントテンプレート で、SageMakerGround Truth PreHumanTaskを選択します。
テストにイベント名を付けます。
[作成] を選択します。
再度 Test (テスト) の横にある矢印を選択すると、作成したテストが選択されて表示されます。これはイベント名のドットで識別できます。選択されていない場合は、選択します。
[Test] (テスト) を選択して、テストを実行します。

テストを実行した後、[Execution results] (実行結果) を表示できます。[Function logs] (関数ログ) に、次のような応答が表示されます。


START RequestId: cd117d38-8365-4e1a-bffb-0dcd631a878f Version: $LATEST
Received event: {
  "version": "2018-10-16",
  "labelingJobArn": "arn:aws:sagemaker:us-east-2:123456789012:labeling-job/example-job",
  "dataObject": {
    "source-ref": "s3://sagemakerexample/object_to_annotate.jpg"
  }
}
{'taskInput': {'taskObject': 's3://sagemakerexample/object_to_annotate.jpg'}, 'isHumanAnnotationRequired': 'true'}
END RequestId: cd117d38-8365-4e1a-bffb-0dcd631a878f
REPORT RequestId: cd117d38-8365-4e1a-bffb-0dcd631a878f	Duration: 0.42 ms	Billed Duration: 1 ms	Memory Size: 128 MB	Max Memory Used: 43 MB

この応答では、Lambda 関数の出力が必須の注釈前応答構文と一致していることがわかります。


{'taskInput': {'taskObject': 's3://sagemakerexample/object_to_annotate.jpg'}, 'isHumanAnnotationRequired': 'true'}

注釈後 Lambda 関数をテストする

Ground Truth AWS Serverless Application Repository （SAR) レシピをデプロイしたときに作成された注釈後の Lambda 関数をテストするには、次の手順に従います。

Ground Truth SARレシピの注釈後の Lambda のテスト

Lambda コンソールの [Functions] (関数) ページを開きます。
Ground Truth SARレシピからデプロイされた注釈後関数を選択します。この関数の名前は、serverlessrepo-aws-sagema-GtRecipeAnnotationConsol-<id> と同様の名前になります。
[Code source] (コードソース) セクションで、[Test] (テスト) の横にある矢印を選択します。
[Configure test event] (テストイベントを構成する) を選択します。
[Create new test event] (新しいテストイベントの作成) オプションを選択したままにします。
イベントテンプレート で、SageMakerGround Truth AnnotationConsolidationを選択します。
テストにイベント名を付けます。
指定されたテンプレートコードを次のように変更します。
- の Amazon リソースネーム (ARN) roleArn を、ラベル付けジョブの作成に使用した SageMaker 実行ロールARNのに置き換えます。
- URI の S3 s3Uri URIを、Amazon S3 に追加したsample-annotations.jsonファイルのに置き換えます。 Amazon S3
これらの変更を行った後、テストは次のようになります。
```
{
  "version": "2018-10-16",
  "labelingJobArn": "arn:aws:sagemaker:us-east-2:123456789012:labeling-job/example-job",
  "labelAttributeName": "example-attribute",
  "roleArn": "arn:aws:iam::222222222222:role/sm-execution-role",
  "payload": {
    "s3Uri": "s3://your-bucket/sample-annotations.json"
  }
}
```
[作成] を選択します。
再度 Test (テスト) の横にある矢印を選択すると、作成したテストが選択されて表示されます。これはイベント名のドットで識別できます。選択されていない場合は、選択します。
[Test] (テスト) を選択して、テストを実行します。

テストの実行後、[Function Logs] (関数ログ) に「-- Consolidated Output --」セクションが表示されます。これには、sample-annotations.json に含まれるすべての注釈のリストが掲載されています。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

Ground Truth テンプレートを使用して Lambda 関数を作成する

デモ: crowd-bounding-box を使用したイメージの注釈