Mise à jour d'un modèle ou d'un cas d'utilisation de modèle à l'aide d'un programme

Vous pouvez mettre à jour un cas d'utilisation de modèle ou une fiche de modèle avec des informations supplémentaires. Par exemple, certaines sociétés disposent d'un ensemble standard de détails qu'elles souhaitent joindre à un cas d'utilisation de modèle ou à des faits de modèle.

Actuellement, vous devez mettre à jour les types d'actif de niveau titulaire en modifiant les attributs utilisateur qui utilisent l' API REST de donnéesWatson pour mettre à jour l'actif.

Mise à jour d'un type d'actif personnalisé

Pour mettre à jour un type d'actif personnalisé, procédez comme suit :

1. Indiquez le paramètre de requête bss_account_id pour Méthode getcatalogtype.

2. Indiquez asset_type comme model_entry_user si vous mettez à jour les attributs pour model_entry. Indiquezasset_type comme modelfacts_user si vous mettez à jour des attributs pour des faits de modèle.

3. Extrayez la définition de type d'actif en cours à l'aide de Méthode getcatalogtype , où asset_type correspond à modelfacts_user ou model_entry_user.

4. Mettez à jour la définition de type d'actif en cours avec les attributs personnalisés en les ajoutant à l'objet JSON de propriétés suivant le schéma défini dans la documentation d'API. Les types d'attribut suivants sont pris en charge pour l'affichage et l'édition à partir de l'interface utilisateur du modèle ou du cas d'utilisation du modèle:

   • chaîne
   • date
   • entier

5. Une fois le JSON mis à jour avec les nouvelles propriétés, démarrez les modifications à l'aide de la Méthode replaceassettype. Indiquez le asset_type , bss_account_idet le contenu de la demande.

Une fois la mise à jour terminée, vous pouvez afficher les attributs personnalisés dans la page des détails du cas d'utilisation du modèle et dans la page des détails du modèle.

Exemple 1: Extraction et mise à jour du type d'actif model_entry_user

Cette commande curl extrait le type d'actif model_entry_user :

curl -X GET --header 'Accept: application/json' --header "Authorization: Bearer ${MY_TOKEN}"  'https://api.dataplatform.cloud.ibm.com:443/v2/asset_types/model_entry_user?bss_account_id=<bss_account_id>'

Voici un exemple de contenu de réponse pour les détails d'utilisateur de cas d'utilisation de modèle:

{
    "description": "The model use case to capture user defined attributes.",
    "fields": [],
    "relationships": [],
    "properties": {},
    "decorates": [{
        "asset_type_name": "model_entry"
    }],
    "global_search_searchable": [],
    "localized_metadata_attributes": {
        "name": {
            "default": "Additional details",
            "en": "Additional details"
        }
    },
    "attribute_only": false,
    "name": "model_entry_user",
    "version": 1,
    "scope": "ACCOUNT"
}

Cette commande curl met à jour le type d'actif model_entry_user :

curl -X PUT --header 'Content-Type: application/json' --header 'Accept: application/json' --header "Authorization: Bearer ${MY_TOKEN}"  -d '@requestbody.json' 'https://api.dataplatform.cloud.ibm.com:443/v2/asset_types/model_entry_user?bss_account_id=<bss_account_id>'

Le contenu requestbody.json se présente comme suit:

{
    "description": "The model use case to capture user defined attributes.",
    "fields": [],
    "relationships": [],
    "properties": {
        "user_attribute1": {
            "type": "string",
            "description": "User attribute1",
            "placeholder": "User attribute1",
            "is_array": false,
            "required": true,
            "hidden": false,
            "readonly": false,
            "default_value": "None",
            "label": {
                "default": "User attribute1"
            }
        },
        "user_attribute2": {
            "type": "integer",
            "description": "User attribute2",
            "placeholder": "User attribute2",
            "is_array": false,
            "required": true,
            "hidden": false,
            "readonly": false,
            "label": {
                "default": "User attribute2"
            }
        },
        "user_attribute3": {
            "type": "date",
            "description": "User attribute3",
            "placeholder": "User attribute3",
            "is_array": false,
            "required": true,
            "hidden": false,
            "readonly": false,
            "default_value": "None",
            "label": {
                "default": "User attribute3"
            }
        
    }
    "decorates": [{
        "asset_type_name": "model_entry"
    }],
    "global_search_searchable": [],
    "attribute_only": false,
    "localized_metadata_attributes": {
        "name": {
            "default": "Additional details",
            "en": "Additional details"
        }
    }
}

Mise à jour des détails de l'utilisateur à l'aide du client Python

Vous pouvez également mettre à jour et remplacer un type d'actif par des propriétés à l'aide d'un script Python . Pour plus de détails, voir la description des éléments de fiche technique.

Après avoir mis à jour les définitions de type d'actif avec des attributs personnalisés, vous pouvez fournir des valeurs pour ces attributs à partir des pages de présentation de cas d'utilisation de modèle et de détails de modèle. Vous pouvez également mettre à jour les valeurs des attributs personnalisés à l'aide des méthodes client de l'API Python suivantes:

• Utilitaires d'actif de modèle
• Utilitaires d'entrée de modèle

Capture des faits de cellule pour un modèle

Lorsqu'un spécialiste des données développe un modèle dans un bloc-notes, il génère des visualisations pour les détails clés du modèle, tels que la courbe ROC, la matrice de confusion, le rapport de profilage panda ou la sortie de n'importe quelle exécution de cellule. Pour capturer ces faits dans le cadre d'un cas d'utilisation de modèle, utilisez la fonction 'capture_cell_facts ` dans la bibliothèque client AI Factsheets Python .

Traitement des incidents liés aux zones personnalisées

Une fois que vous avez personnalisé les zones et les avez mises à la disposition des utilisateurs, un utilisateur qui tente de mettre à jour les zones dans la section Détails supplémentaires des détails du modèle peut recevoir l'erreur suivante:

Update failed. To update an asset attribute, you must be a catalog Admin or an asset owner or member with the Editor role. Ask a catalog Admin to update your catalog role or ask an asset member with the Editor role to add you as a member.

Si l'utilisateur dispose déjà du droit d'édition sur le modèle et qu'il reçoit toujours le message d'erreur, procédez comme suit pour le résoudre.

1. Appelez la commande d'API pour createassetattributenewv2.

2. Utilisez ce contenu avec la commande:

   
   {
     "name": "modelfacts_system",
     "entity": {
     }
   }
   

   où asset_id est le model_id. Entrez project_id ou space_id ou catalog_id où se trouve le modèle.

En savoir plus

Pour plus d'informations, voir Types d'actifs personnalisés.

Découvrez comment utiliser un inventaire de modèles à l'aide d'un programme, à l'aide de la documentation IBM_AIGOV_FACTS_CLIENT.

Rubrique parent : Gestion d'un inventaire des actifs de modèle.