Associer l'algorithme du modèle configuré dans AWS Clean Rooms ML

Après avoir configuré l'algorithme du modèle, vous êtes prêt à l'associer à une collaboration. L'association d'un algorithme de modèle met celui-ci à la disposition de tous les membres de la collaboration.

L'image suivante montre l'association de l'algorithme de modèle configuré comme dernière étape, après la création de l'image d'apprentissage du conteneur et la configuration d'un algorithme de modèle.

Console

Note

Une fois que l'algorithme du modèle est associé, il ne peut pas être modifié. Pour apporter des modifications, vous pouvez supprimer l'algorithme du modèle associé et en associer un nouveau.

Pour associer un algorithme de modèle ML personnalisé (console)

1. Connectez-vous à la AWS Clean Rooms console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/cleanrooms.

2. Dans le volet de navigation de gauche, sélectionnez Modèles ML personnalisés.

3. Sur la page Modèles ML personnalisés, choisissez l'algorithme de modèle configuré que vous souhaitez associer à une collaboration, puis choisissez Associer à la collaboration.

4. Dans la fenêtre Associer un algorithme de modèle configuré, choisissez la collaboration à laquelle vous souhaitez vous associer.

5. Choisissez Choisir une collaboration.

6. Sur la page Associer un algorithme de modèle, pour les détails de l'association d'algorithmes de modèle, entrez un nom et une description facultative.

7. Pour Algorithme de modèle, choisissez un algorithme de modèle configuré.

8. Pour les configurations de confidentialité des exportations du modèle Trained,

   1. Pour exporter des fichiers modèles, cochez la case Fichiers modèles.

   2. Pour exporter les fichiers de sortie, cochez la case Fichiers de sortie.

   3. Entrez une valeur de taille maximale pour les données exportées. La valeur doit être comprise entre 0,01 et 10.

9. (Facultatif) Si vous souhaitez envoyer des journaux d'erreurs complets ou des résumés d'erreurs plus courts aux membres, sous Configuration de la confidentialité des tâches d'inférence de modèles entraînés,

   1. Sous Journaux complets, sélectionnez un ou plusieurs comptes IDs dans la liste déroulante.

   2. (Facultatif) Si vous souhaitez envoyer des journaux correspondant à un modèle de filtre, entrez un modèle de filtre.

   3. (Facultatif) Si vous souhaitez ajouter un autre compte et un modèle de filtre facultatif, choisissez Ajouter une politique de journalisation.

   4. Sous Résumés des erreurs, sélectionnez un ou plusieurs comptes IDs dans la liste déroulante.

   5. (Facultatif) Sélectionnez une ou plusieurs entités à supprimer pour spécifier les entités qui seront supprimées du journal des erreurs ou des résumés d'erreurs.

      • PII — supprimer les informations personnelles identifiables

      • Chiffres — expurgez les numéros

      • Personnalisé : rédaction basée sur le modèle de rédaction personnalisé

      1. Si vous avez choisi Personnalisé à l'étape précédente, entrez un modèle de rédaction personnalisé. Cela enregistre les informations qui correspondent à ce modèle.

      2. (Facultatif) Si vous souhaitez ajouter un autre modèle de rédaction personnalisé, choisissez Ajouter un autre modèle personnalisé.

10. (Facultatif) Si vous souhaitez configurer les métriques du modèle entraîné, sous Configuration des métriques du modèle entraîné, sélectionnez un niveau de bruit dans la liste déroulante.

    Vous pouvez choisir Aucun, Faible, Moyen et Élevé.

11. (Facultatif) Si vous souhaitez définir la taille maximale des artefacts, sous Configuration des artefacts, entrez la valeur de la taille maximale des artefacts. La valeur doit être comprise entre 0,01 et 10.

12. (Facultatif) Si vous souhaitez activer les balises, choisissez Ajouter une nouvelle balise, puis entrez la paire clé/valeur.

13. Choisissez Associer.

API

Pour associer un algorithme de modèle ML (API) personnalisé

Exécutez le code suivant avec vos paramètres spécifiques.

Vous fournissez également une politique de confidentialité qui définit qui a accès aux différents journaux, permet aux clients de définir l'expression régulière et quelle quantité de données peut être exportée à partir des sorties du modèle d'entraînement ou des résultats d'inférence.

Note

Les associations d'algorithmes de modèles configurées sont immuables.

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',
    configuredModelAlgorithmArn='arn:aws:cleanrooms-ml:region:account:membership/membershipIdentifier/configured-model-algorithm/identifier',
    privacyConfiguration={
        "policies": {
            "trainedModelExports": {
                "filesToExport": ['files to export'],
                "containerLogs": [
                    {
                        "allowedAccountIds": ['member_account_id'],
                        "filterPattern": ['filter pattern'],
                        "logRedactionConfiguration": {
                            "entitiesToRedact": [
                                'ALL_PERSONALLY_IDENTIFIABLE_INFORMATION',
                                'NUMBERS',
                                'CUSTOM'
                            ],
                            "customEntityConfig": {
                                "customDataIdentifiers": [
                                    'custom_regex_1',
                                    'custom_regex_2'
                                ] 
                            } 
                        } 
                    }
                ],
                "containerMetrics": {
                    "noiseLevel": 'noise value'
                },
                "maxArtifactSize": {
                    "unit": 'unit',
                    "value": 'number'
                }
            },
            "trainedModelInferenceJobs": {
                "containerLogs": [
                    {
                        "allowedAccountIds": ['member_account_id'],
                        "filterPattern": ['filter pattern'],     
                        "logRedactionConfiguration": {
                            "entitiesToRedact": [
                                'ALL_PERSONALLY_IDENTIFIABLE_INFORMATION',
                                'NUMBERS',
                                'CUSTOM'
                            ],
                            "customEntityConfig": {
                                "customDataIdentifiers": [
                                    'custom_regex_1',
                                    'custom_regex_2'
                                ] 
                            }
                        }
                    }
                ],
                "maxOutputSize": {
                    "unit": 'unit',
                    "value": 'number'
                }
            }
        }
    },
    tags={
        'tag': 'tag'
    }
)

Une fois que l'algorithme du modèle configuré est associé à la collaboration, les fournisseurs de données de formation doivent ajouter une règle d'analyse de collaboration à leur table. Cette règle permet à l'association d'algorithmes du modèle configuré d'accéder à sa table configurée. Tous les fournisseurs de données de formation contributeurs doivent exécuter le code suivant :

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': []
            }
        }
    }
)

Note

Les associations d'algorithmes de modèles configurés étant immuables, nous recommandons aux fournisseurs de données de formation qui souhaitent autoriser l'utilisation de modèles de liste d'utiliser des caractères génériques allowedAdditionalAnalyses lors des premières itérations de configuration de modèles personnalisés. Cela permet aux fournisseurs de modèles d'itérer leur code sans obliger les autres prestataires de formation à s'associer à nouveau avant d'entraîner leur code de modèle mis à jour avec des données.