Add and manage artifacts

Add artifacts at the model or documentation section level, update your artifacts to include proposed remediation plans and supporting documentation, or delete artifacts that no longer need to be tracked.

Prerequisites

• You are logged in to ValidMind.
• The model is registered in the model inventory.¹
• Model documentation is completed or in progress for your model.²
• Artifact statuses have been set up for use with artifacts.³
• You are a Validator or assigned another role with sufficient permissions to perform the tasks in this guide.⁴

¹ Register models in the inventory

² Working with model documentation

³ Manage artifact types

⁴ Manage permissions

Add artifacts on documentation

1. In the left sidebar, click Inventory.

2. Select a model or find your model by applying a filter or searching for it.⁵

3. In the left sidebar that appears for your model, click Documents and select a Documentation type file.⁶

4. On your model’s Documentation page, click Add Model Artifact.

5. Select the artifact type⁷ you want to add:

   • Validation Issue
   • Policy Exception
   • Model Limitation

6. On the modal that opens, provide information for your artifact.

7. When you are done, click Save to submit the artifact.

   Once created, you can then add supporting documentation to your artifact.⁸

⁵ Working with the model inventory

⁶ Working with model documents

⁷ Manage artifact types

⁸ Manage supporting documentation

Add artifacts on validation reports

When linking artifacts to validation reports,⁹ you can add artifacts as you assess a model’s compliance:

⁹ Link artifacts to reports

1. In the left sidebar, click Inventory.

2. Select a model or find your model by applying a filter or searching for it.¹⁰

3. In the left sidebar that appears for your model, click Documents and select a Validation Report type file.¹¹

4. In any section of the report where the button is available, click Link Artifact to Report and select the artifact type¹² you want to add:

   • Validation Issue
   • Policy Exception
   • Model Limitation

5. On the Link Artifact to Report modal that opens, click Add {Artifact Type}.

6. On the modal that opens, provide information for your artifact.

7. When you are done, click Add {Artifact Type} to submit the artifact.

¹⁰ Working with the model inventory

¹¹ Working with model documents

¹² Manage artifact types

Update artifacts

As artifacts get resolved or require other changes during the model validation process, you can update them:

1. Locate the artifact you want to update.¹³

2. Click on a field to make changes.

   You can also add comments to an artifact.

¹³ View and filter artifacts

Most updates are applied immediately but you must click Save to make changes to the artifact title, description, proposed remediation plan, and attachments effective.

Track artifact resolution

As you prepare your validation report, review open or past due artifacts, close resolved ones, or add a mitigation plan:

1. In the left sidebar, click Inventory.

2. Select a model or find your model by applying a filter or searching for it.¹⁴

¹⁴ Working with the model inventory

Track resolution of validation issues

1. In the left sidebar that appears for your model, click Validation Issues to view a list of validation issues associated with that model.

2. Go through the open validation issues one-by-one:

   • If the validation issue has been addressed —

     • Add any final comments to assess how the issue was resolved.
     • Under status, select Closed.

   • If part or all of the validation issue remains to be addressed —

     • Assess if the issue identified by the validation issue prevents the model from being approved.
     • If a remediation plan is required, enter the details in the Proposed Remediation Plan section of the validation issue.

3. Track open issues until all validation issues are resolved or a remediation plan is in place for post-approval issues.

Track resolution of other artifact types

1. In the left sidebar that appears for your model, click Artifacts to view lists of other artifact types associated with that model.

2. Select an artifact type¹⁵ for a list of that artifact type:

   • Policy Exception
   • Model Limitation

3. Go through the open artifacts one-by-one:

   • If the artifact has been addressed —

     • Add any final comments to assess how the issue was resolved.
     • Under status, select Closed.

   • If part or all of the artifact remains to be addressed —

     • Assess if the issue identified by the artifact prevents the model from being approved.
     • Add comments indicating next required steps.

4. Track open artifacts until all artifacts are resolved or plans are in place for post-approval issues.

¹⁵ Manage artifact types

Manage supporting documentation

After an artifact is created, you’re able to add supporting documentation to it.

Add attachments to artifacts

Uploaded files must be less than 50 MB each in size.

1. On the artifacts detail page, click on the attachments header.

2. Click Select Files to add a file.

   • Add a note to the file by clicking on the menu, then select Add Note.
   • Update a note by making your changes in the existing text field.

3. Click Save to submit the upload.

   

   Adding attachment notes

Remove attachments from artifacts

1. On the artifacts detail page, click on the attachments header.

2. Locate the file you want to remove, and click on the menu.

   • Select Delete File to remove the file. After you confirm, the attachment will be removed from the list.
   • Select Remove Notes to delete any notes.

3. Click Save to apply the deletion.

   After you save, the attachment or notes will be removed permanently.

   

   Deleting attachment notes and attachments

Delete artifacts

ImportantArtifact deletion is permanent.

• While artifact deletion will be logged under your Model Activity,¹⁶ deleted artifacts cannot be retrieved.
• Deleting an artifact will also remove it from any validation reports¹⁷ it was previously attached to.

¹⁷ Link artifacts to reports

¹⁶ View model activity

If you logged an artifact in error or otherwise no longer need to track that artifact, you can delete it:

1. Locate the artifact you want to delete.¹⁸

2. On the artifact’s detail page, click Delete {Artifact Type}¹⁹ in the right sidebar.

3. After you confirm, the artifact will be permanently deleted.

¹⁸ View and filter artifacts

¹⁹ Manage artifact types