AWS Clean Rooms ML でのコラボレーションの作成と参加

コラボレーションクリエーターは、コラボレーションの作成、メンバーの招待、ロールの割り当てを担当します。招待されたメンバーはコラボレーションに参加し、コラボレーションの設定方法に応じて、結果設定、トレーニング済みモデルアーティファクトの送信先設定を指定し、支払い責任を受け入れます。

機械学習用のコラボレーションの作成

次の手順は、機械学習用のコラボレーションの作成、1 人以上のメンバーの招待、モデルトレーニングの開始、結果の受信、モデルアーティファクトやメトリクスを含むトレーニング済みモデル結果の受信、モデル推論結果の受信が可能なメンバーの割り当てを行う方法を示しています。コラボレーションクリエーターは、クエリコンピューティング、モデルトレーニング、モデル推論のコストを支払うメンバーも割り当てます。

Console

機械学習のコラボレーションを作成するには (コンソール）

コラボレーションを作成し、1 人以上のメンバーをコラボレーションに招待する
クエリとジョブを使用して、分析に次のメンバー機能を割り当てます。
- モデルトレーニングを開始するメンバーに実行クエリを割り当てます。
- クエリ結果を受け取るメンバーに、分析からの受信結果を割り当てる。
専用ワークフローを使用して、ML モデリングに次のメンバー機能を割り当てます。
- モデルアーティファクトやメトリクスなど、トレーニング済みモデルの結果を受け取るメンバーに、トレーニング済みモデルからの受信出力を割り当てます。
- モデル推論の結果を受け取るメンバーにモデル推論からの受信出力を割り当てます。
支払いを設定するには、クエリコンピューティング、モデルトレーニング、モデル推論のコストを支払うメンバーを指定します。これらのコストはそれぞれ、同じメンバーまたは異なるメンバーに割り当てることができます。招待されたメンバーが支払い費用の支払いを担当するメンバーである場合は、コラボレーションに参加する前に支払い責任を引き受ける必要があります。
メンバーシップを設定する では、コラボレーション作成者は今すぐメンバーシップに参加するか、後でメンバーシップを作成するかを決定できます。次に、コラボレーション作成者は ML 設定をセットアップする必要があります。
1. コラボレーション作成者が結果レシーバーでもある場合は、結果設定のデフォルトにクエリ結果の送信先と形式も指定する必要があります。
2. ML 設定は、Clean Rooms ML がメトリクスをに発行するためのロールを提供します AWS アカウント。コラボレーションクリエーターがトレーニング済みモデルアーティファクトも受信している場合は、結果の受信に使用する Amazon S3 バケットを指定できます。
3. ML 設定セクションで、ML 設定の作成を選択し、Amazon S3 のモデル出力先と、この場所へのアクセスに必要なサービスアクセスロールを指定します。
4. コラボレーション作成者が支払いコストの支払いを担当するメンバーである場合は、コラボレーションを作成する前に支払い責任を引き受ける必要があります。

API

機械学習 (API) のコラボレーションを作成するには

コラボレーションを作成し、1 人以上のメンバーをコラボレーションに招待する
コラボレーションメンバーに次のロールを割り当てます。
- CAN_QUERY - モデルトレーニングと推論を開始するメンバーに割り当てられます。
- CAN_RECEIVE_MODEL_OUTPUT - トレーニング済みモデル結果を受け取るメンバーに割り当てられます。
- CAN_RECEIVE_INFERENCE_OUTPUT - モデル推論結果を受け取るメンバーに割り当てられます。
コラボレーション作成者が結果レシーバーでもある場合は、コラボレーションの作成時にクエリ結果の送信先と形式も指定する必要があります。また、クエリ結果の送信先に結果を書き込むサービスロール Amazon リソースネーム (ARN) も付与します。
クエリコンピューティング、モデルトレーニング、モデル推論のコストを支払うメンバーを指定します。これらのコストはそれぞれ、同じメンバーまたは異なるメンバーに割り当てることができます。招待されたメンバーが支払い費用の支払いを担当するメンバーである場合は、コラボレーションに参加する前に支払い責任を引き受ける必要があります。

次のコードはコラボレーションを作成し、クエリを実行して結果を受け取ることができるメンバーを招待し、コラボレーション作成者をモデルアーティファクトレシーバーとして指定します。


import boto3 
acr_client= boto3.client('cleanrooms')
 
collaboration = a_acr_client.create_collaboration(
    members=[
        {
         'accountId': 'invited_member_accountId',
         'memberAbilities':["CAN_QUERY","CAN_RECEIVE_RESULTS"],
         'displayName': 'member_display_name'
        }
    ],
    name='collaboration_name',
    description=collaboration_description,
    creatorMLMemberAbilities= {
        'customMLMemberAbilities':["CAN_RECEIVE_MODEL_OUTPUT", "CAN_RECEIVE_INFERENCE_OUTPUT"],
    },
    creatorDisplayName='creator_display_name',
    queryLogStatus="ENABLED",
    analyticsEngine="SPARK",
    creatorPaymentConfiguration={
        "queryCompute": {
            "isResponsible": True
        },
        "machineLearning": {
            "modelTraining": {
                "isResponsible": True
            },
            "modelInference": {
                "isResponsible": True
            }
        }
    }
)
 
collaboration_id = collaboration['collaboration']['id']
print("collaborationId: {collaboration_id}")

member_membership = a_acr_client.create_membership(
    collaborationIdentifier = collaboration_id,
    queryLogStatus = 'ENABLED',
    paymentConfiguration={
        "queryCompute": {
            "isResponsible": True
        },
        "machineLearning": {
            "modelTraining": {
                "isResponsible": True
            },
            "modelInference": {
                "isResponsible": True
            }
        }
    }
)

次に、コラボレーション作成者は ML 設定をセットアップする必要があります。ML 設定は、Clean Rooms ML がメトリクスとログをに発行するためのロールを提供します AWS アカウント。コラボレーション作成者が結果 (モデルアーティファクトまたは推論結果) も受信している場合は、結果の受信に使用する Amazon S3 バケットを指定できます。
```
import boto3 
acr_ml_client= boto3.client('cleanroomsml')

acr_ml_client.put_ml_configuration(
        membershipIdentifier=membership_id,
        defaultOutputLocation={
           'roleArn':'arn:aws:iam::account:role/roleName',
           'destination':{
                's3Destination':{
                    's3Uri':"s3://bucketName/prefix"
                }
            }
        }
    )
```

コラボレーションへの参加

コラボレーションクリエーターがタスクを完了したら、招待されたメンバーはタスクを完了する必要があります。

Console

メンバーシップを作成してコラボレーションに参加するには (コンソール）

招待されたメンバーはメンバーシップを作成し、コラボレーションに参加します。
招待されたメンバーが、クエリコンピューティング、モデルトレーニング、モデル推論コストなど、支払いを担当するメンバーである場合は、コラボレーションに参加する前に支払い責任を引き受ける必要があります。
招待されたメンバーは ML 設定をセットアップします。これにより、Clean Rooms ML がモデルメトリクスをに発行するロールが提供されます AWS アカウント。トレーニング済みモデルアーティファクトを受け取るメンバーでもある場合は、トレーニング済みモデルアーティファクトが保存されている Amazon S3 バケットを提供する必要があります。

API

メンバーシップを作成してコラボレーションに参加するには (API)

招待されたメンバーが結果を受け取れるメンバーである場合は、そのメンバーがクエリ結果の送信先と形式を指定します。また、サービスがクエリ結果の送信先に書き込むことを許可するサービスロール ARN も提供します。

招待されたメンバーが、クエリコンピューティング、モデルトレーニング、モデル推論コストなど、支払いを担当するメンバーである場合は、コラボレーションに参加する前に支払い責任を引き受ける必要があります。

招待されたメンバーがカスタムモデリングのモデルトレーニングとモデル推論の支払いを担当するメンバーである場合は、コラボレーションに参加する前に支払い責任を引き受ける必要があります。

次のコードは、クエリログ記録を有効にしてメンバーシップを作成します。
```
import boto3 
acr_client= boto3.client('cleanrooms')

acr_client.create_membership(
    membershipIdentifier='membership_id',
    queryLogStatus='ENABLED'
)
```
招待されたメンバーは ML 設定をセットアップします。これにより、Clean Rooms ML がモデルメトリクスをに発行するロールが提供されます AWS アカウント。トレーニング済みモデルアーティファクトを受け取るメンバーでもある場合は、トレーニング済みモデルアーティファクトが保存されている Amazon S3 バケットを提供する必要があります。
```
import boto3 
acr_ml_client= boto3.client('cleanroomsml')

acr_ml_client.put_ml_configuration(
        membershipIdentifier='membership_id',
        defaultOutputLocation={
           'roleArn':"arn:aws:iam::account:role/role_name",
           'destination':{
                's3Destination':{
                    's3Uri':"s3://bucket_name/prefix"
                }
            }
        }
    )
```

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

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

ドキュメントの表記規則

カスタムモデリング

トレーニングデータの提供