在 AWS Clean Rooms ML 中建立和加入協同合作

協作建立者負責建立協作、邀請成員並指派其角色。受邀成員加入協同合作並指定結果設定、訓練模型成品目的地設定，以及接受付款責任，具體取決於協同合作的設定方式。

建立機器學習的協同合作

下列程序說明如何建立機器學習的協同合作、邀請一或多個成員，以及指派可以開始模型訓練、接收結果、接收訓練過的模型結果，包括模型成品和指標，以及接收模型推論結果的成員。協同合作建立者也會指派將支付查詢運算、模型訓練和模型推論成本的成員。

Console

建立機器學習的協同合作 （主控台）

1. 建立協同合作並邀請一或多個成員加入協同合作

2. 使用查詢和任務指派下列成員分析能力：

   • 將執行查詢指派給將開始模型訓練的成員。

   • 將從分析接收結果指派給將接收查詢結果的成員。

3. 使用專用工作流程為 ML 建模指派下列成員能力：

   • 將接收來自訓練模型的輸出指派給將接收訓練模型結果的成員，包括模型成品和指標。

   • 將接收來自模型推論的輸出指派給將接收模型推論結果的成員。

4. 針對設定付款，指定將支付查詢運算、模型訓練和模型推論成本的成員。這些成本都可以指派給相同或不同的成員。如果受邀成員是負責支付付款費用的成員，則必須在加入協同合作之前接受其付款責任。

5. 對於設定成員資格，協同合作建立者現在可以決定加入成員資格，或稍後建立成員資格。協作建立者接著必須設定 ML 組態。

   1. 如果協同合作建立者也是結果接收者，他們也必須在結果設定預設值中指定查詢結果目的地和格式。

   2. ML 組態為 Clean Rooms ML 提供將指標發佈至 的角色 AWS 帳戶。如果協同合作建立者也收到訓練過的模型成品，他們可以指定用於接收結果的 Amazon S3 儲存貯體。

   3. 在 ML 組態區段中，選取建立 ML 組態，然後在 Amazon S3 上指定模型輸出目的地，以及存取此位置所需的服務存取角色。

   4. 如果協作建立者是負責支付付款成本的成員，他們必須在建立協作之前接受其付款責任。

API

建立機器學習 (API) 的協同合作

1. 建立協同合作並邀請一或多個成員加入協同合作

2. 將下列角色指派給協同合作成員：

   • CAN_QUERY - 指派給將開始模型訓練和推論的成員。

   • CAN_RECEIVE_MODEL_OUTPUT - 指派給將收到訓練模型結果的成員。

   • CAN_RECEIVE_INFERENCE_OUTPUT - 指派給將收到模型推論結果的成員。

   如果協作建立者也是結果接收者，他們也必須在協作建立期間指定查詢結果目的地和格式。他們也會提供服務角色 Amazon Resource Name (ARN) 將結果寫入查詢結果目的地。

3. 指定將支付查詢運算、模型訓練和模型推論成本的成員。這些成本都可以指派給相同或不同的成員。如果受邀成員是負責支付付款費用的成員，則必須在加入協同合作之前接受其付款責任。

4. 下列程式碼會建立協同合作、邀請可執行查詢和接收結果的成員，並將協同合作建立者指定為模型成品接收者。

   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
               }
           }
       }
   )

5. 協作建立者接著必須設定 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

建立成員資格並加入協同合作 （主控台）

1. 受邀成員會建立成員資格並加入協同合作。

2. 如果受邀成員是負責付款的成員，包括查詢運算、模型訓練和模型推論成本，他們必須在加入協同合作之前接受其付款責任。

3. 受邀成員會設定 ML 組態，為 Clean Rooms ML 提供將模型指標發佈至 的角色 AWS 帳戶。如果他們也是接收訓練模型成品的成員，則必須提供存放訓練模型成品的 Amazon S3 儲存貯體。

API

建立成員資格並加入協作 (API)

1. 如果受邀成員是可以接收結果的成員，他們會指定查詢結果目的地和格式。他們也提供服務角色 ARN，允許服務寫入查詢結果目的地

   如果受邀成員是負責付款的成員，包括查詢運算、模型訓練和模型推論成本，他們必須在加入協同合作之前接受其付款責任。

   如果受邀成員是負責支付模型訓練和模型推論以進行自訂建模的成員，則必須在加入協作之前接受其付款責任。

   下列程式碼會在啟用查詢記錄的情況下建立成員資格。

   import boto3 
   acr_client= boto3.client('cleanrooms')
   
   acr_client.create_membership(
       membershipIdentifier='membership_id',
       queryLogStatus='ENABLED'
   )

2. 受邀成員會設定 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"
                   }
               }
           }
       )