0 / 0
Go back to the English version of the documentation
Přizpůsobení podrobností pro informační list (AI Factsheets)
Last updated: 03. 11. 2023
Přizpůsobení podrobností pro informační list (AI Factsheets)

Pomocí AI Factsheetsmůžete programově upravit informace o příkladu použití modelu nebo modelu, abyste rozšířili informační list, který sleduje životní cyklus modelu. Například programově připojte soubory a obrázky, abyste rozšířili případ použití. Používejte upravené informační listy jako součást strategie regulace AI.

Programová aktualizace modelu nebo příkladu použití modelu

Možná budete chtít aktualizovat příklad použití modelu nebo informační list modelu o další informace. Například některé společnosti mají standardní sadu podrobností, které chtějí doprovázet modelový příklad použití nebo modelová fakta.

Momentálně musíte aktualizovat typy aktiv na úrovni tenanta úpravou atributů uživatele, které používají rozhraní Watson Data REST API k aktualizaci aktiva.

Aktualizace vlastního typu aktiva

Chcete-li aktualizovat vlastní typ aktiva, postupujte takto:

  1. Poskytněte parametr dotazu bss_account_id pro getcatalogtype metoda.

  2. Zadejte asset_type jako model_entry_user , pokud aktualizujete atributy pro model_entry. Zadejte asset_type jako modelfacts_user , pokud aktualizujete atributy pro fakta modelu.

  3. Načtěte aktuální definici typu aktiva pomocí getcatalogtype metody , kde asset_type je buď modelfacts_user , nebo model_entry_user.

  4. Aktualizujte aktuální definici typu aktiva pomocí vlastních atributů jejich přidáním do objektu JSON vlastností podle schématu, které je definováno v dokumentaci k rozhraní API. Následující typy atributů jsou podporovány pro zobrazení a úpravy z uživatelského rozhraní modelu případu použití nebo modelu:

    • řetězec
    • datum
    • celočíselná hodnota
  5. Po aktualizaci JSON s použitím nových vlastností spusťte změny pomocí replaceassettype metody. Poskytněte informační obsah asset_type , bss_account_ida požadavek.

Po dokončení aktualizace můžete zobrazit vlastní atributy na stránce s podrobnostmi o případu použití modelu a na stránce s podrobnostmi o modelu.

Příklad 1: Načtení a aktualizace typu aktiva model_entry_user

Pozn.:

Tento příklad aktualizuje uživatelská data příkladu použití modelu. Můžete použít stejný formát, ale nahradit modelfacts_user , abyste načetli a aktualizovali podrobnosti pro faktlist modelu.

Tento příkaz curl načte typ aktiva model_entry_user:

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

Toto je ukázkový informační obsah odezvy pro podrobnosti o uživateli příkladu použití modelu:

{
    "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"
}

Tento příkaz curl aktualizuje typ aktiva model_entry_user :

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

Obsah souboru requestbody.json vypadá takto:

{
    "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"
        }
    }
}

Aktualizace podrobností o uživateli pomocí klienta Python

Můžete také aktualizovat a nahradit typ aktiva vlastnostmi pomocí skriptu Python . Podrobnosti viz popis prvků listu faktů.

Poté, co aktualizujete definice typu aktiva pomocí vlastních atributů, můžete poskytnout hodnoty pro tyto atributy ze stránek přehledu příkladu použití modelu a podrobností modelu. Můžete také aktualizovat hodnoty na vlastní atributy pomocí těchto metod klienta rozhraní API Python :

Zachycení faktů buňky pro model

Když datový vědec vyvíjí model v zápisníku, generuje vizualizace pro klíčové podrobnosti modelu, jako je křivka ROC, matice zmatení, sestava profilování panda nebo výstup provedení buňky. Chcete-li zachytit tato fakta jako součást příkladu použití modelu, použijte funkci ' capture_cell_facts ` v knihovně klienta AI Factsheets Python .

Odstraňování problémů s vlastními poli

Poté, co upravíte pole a zpřístupníte je uživatelům, může uživatel, který se pokouší aktualizovat pole v sekci Další podrobnosti podrobností modelu, získat tuto chybu:

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.

Pokud již uživatel má oprávnění k úpravám modelu a stále dostává chybovou zprávu, postupujte takto a vyřešte ji.

  1. Vyvolejte příkaz rozhraní API pro createassetattributenewv2.

  2. Použijte tento informační obsah s příkazem:

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

    kde asset_id je model_id. Zadejte buď project_id , nebo space_id , nebo catalog_id , kde existuje model.

Další informace

Další informace viz vlastní typy aktiv.

Pomocí dokumentace IBM_AIGOV_FACTS_CLIENTzjistíte, jak programově pracovat s inventářem modelu.

Další informace

Nadřízené téma: Správa inventáře modelových aktiv.

Generative AI search and answer
These answers are generated by a large language model in watsonx.ai based on content from the product documentation. Learn more