Translation not up to date
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:
Poskytněte parametr dotazu
bss_account_id
progetcatalogtype
metoda.Zadejte
asset_type
jakomodel_entry_user
, pokud aktualizujete atributy promodel_entry
. Zadejteasset_type
jakomodelfacts_user
, pokud aktualizujete atributy pro fakta modelu.Načtěte aktuální definici typu aktiva pomocí
getcatalogtype
metody , kdeasset_type
je buďmodelfacts_user
, nebomodel_entry_user
.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
Po aktualizaci JSON s použitím nových vlastností spusťte změny pomocí
replaceassettype
metody. Poskytněte informační obsahasset_type
,bss_account_id
a 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
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.
Vyvolejte příkaz rozhraní API pro createassetattributenewv2.
Použijte tento informační obsah s příkazem:
{ "name": "modelfacts_system", "entity": { } }
kde
asset_id
jemodel_id
. Zadejte buďproject_id
, nebospace_id
, nebocatalog_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.