I modelli Jinja sono la struttura backend di un documento di scheda modello. Il Model Card Toolkit viene fornito con alcuni modelli predefiniti, ma puoi modificare liberamente questi modelli o persino crearne uno tuo. In questo documento discuteremo come eseguire questa operazione.
Quello che segue è il modo standard per inizializzare il Model Card Toolkit.
mct_directory = ... # where the Model Card assets will be generated
toolkit = ModelCardToolkit(mct_directory)
model_card = toolkit.scaffold_assets()
... # set the model_card's fields here
toolkit.update_model_card(model_card)
Quando esegui toolkit.scaffold_assets()
, il contenuto di model_card_toolkit/template viene copiato in mct_directory/template
. Ciò include modelli predefiniti come default_template.html.jinja e default_template.md.jinja .
L'oggetto model_card
generato sopra può essere popolato manualmente. Una volta che sei pronto per generare un documento Model Card, puoi passare nuovamente model_card
in MCT con toolkit.update_model_card(model_card)
.
Utilizza un modello di scheda modello già pronto
Possiamo quindi generare un documento Model Card utilizzando uno dei modelli predefiniti, tramite il codice seguente.
template_path = os.path.join(mct_directory, 'template/html/default_template.html.jinja')
toolkit.export_format(template_path=template_path, output_file='model_card.html')
Modificare il modello della scheda modello
Puoi modificare liberamente un modello predefinito per cambiare stile, riorganizzare le informazioni, ecc. Dovresti avere familiarità con l' API Jinja e le strutture di controllo . I nomi dei campi della scheda modello sono presi da model_card.py .
Creazione di un nuovo modello di scheda modello
La creazione di un nuovo modello di scheda modello funziona allo stesso modo della modifica di uno esistente.
my_custom_template_path = ... # where the template is stored
toolkit.export_format(template_path=my_custom_template_path, output_file'model_card.html') # generate the final Model Card