Associando o algoritmo do modelo configurado no AWS Clean Rooms ML

Depois de configurar o algoritmo do modelo, você estará pronto para associar o algoritmo do modelo a uma colaboração. A associação de um algoritmo de modelo torna o algoritmo de modelo disponível para todos os membros da colaboração.

A imagem a seguir mostra a associação do algoritmo do modelo configurado como a última etapa, depois de criar a imagem de treinamento do contêiner e configurar um algoritmo de modelo.

Console

Para associar um algoritmo de modelo de ML personalizado (console)

1. Faça login no AWS Management Console e abra o AWS Clean Rooms console em https://console.aws.amazon.com/cleanrooms.

2. No painel de navegação esquerdo, escolha Modelos de ML personalizados.

3. Na página Modelos de ML personalizados, escolha o algoritmo de modelo configurado que você deseja associar a uma colaboração e clique em Associar à colaboração.

4. Na janela Associar algoritmo de modelo configurado, escolha a Colaboração à qual você deseja se associar.

5. Escolha Escolher colaboração.

API

Para associar um algoritmo de modelo de ML (API) personalizado

Execute o código a seguir com seus parâmetros específicos.

Você também fornece uma política de privacidade que define quem tem acesso aos diferentes registros, permite que os clientes definam o regex e quantos dados podem ser exportados das saídas do modelo de treinamento ou dos resultados da inferência.

nota

As associações de algoritmos de modelos configurados são imutáveis.

import boto3 
acr_ml_client= boto3.client('cleanroomsml')

acr_ml_client.create_configured_model_algorithm_association(
    name='configured_model_algorithm_association_name',
    description='purpose of the association',
    membershipIdentifier='membership_id',
    configuredModelAlgorithmArn= 'arn:aws:cleanrooms-ml:region:account:membership/membershipIdentifier/configured-model-algorithm/identifier',
    privacyConfiguration = {
        "policies": {
            "trainedModels": {
                "containerLogs": [
                    {
                        "allowedAccountIds": ['member_account_id'],
                        
                    },
                    {
                        "allowedAccountIds": ['member_account_id'],
                        "filterPattern": "INFO"
                    }
                ],
                "containerMetrics": {
                    "noiseLevel": 'noise value'
                }
            },
            "trainedModelInferenceJobs": {
                "containerLogs": [
                    {
                        "allowedAccountIds": ['member_account_id']
                    }
                ]
            },
            trainedModelExports: {
                maxSize: {
                    unit: GB,
                    value: 5
                },
                filesToExport: [
                    "MODEL",    // final model artifacts that container should write to /opt/ml/model directory
                    "OUTPUT"   // other artifacts that container should write to /opt/ml/output/data directory
                ]
            } 
        }
    }
)

Depois que o algoritmo do modelo configurado for associado à colaboração, os provedores de dados de treinamento devem adicionar uma regra de análise de colaboração à tabela. Essa regra permite que a associação do algoritmo do modelo configurado acesse sua tabela configurada. Todos os provedores de dados de treinamento contribuintes devem executar o seguinte código:

import boto3 
acr_client= boto3.client('cleanrooms')

acr_client.create_configured_table_association_analysis_rule(
    membershipIdentifier= 'membership_id',
    configuredTableAssociationIdentifier= 'configured_table_association_id',
    analysisRuleType= 'CUSTOM',
    analysisRulePolicy = {
        'v1': {
            'custom': {
                'allowedAdditionalAnalyses': ['arn:aws:cleanrooms-ml:region:*:membership/*/configured-model-algorithm-association/*''],
                'allowedResultReceivers': []
            }
        }
    }
)

nota

Como as associações de algoritmos de modelos configurados são imutáveis, recomendamos que os provedores de dados que desejam incluir modelos na lista de permissões usem curingas allowedAdditionalAnalyses durante as primeiras iterações da configuração do modelo personalizado. Isso permite que os provedores de modelo iterem seu código sem exigir que outros provedores de treinamento se reassociem antes de treinar seu código de modelo atualizado com os dados.