Add custom model versions¶

If you want to update a model, you can create a new minor version of the model (1.1, 1.2, etc.). To do this, open the custom model in the Workshop and navigate to the Assemble tab. On the Assemble tab, any changes to the Environment, Files, or Settings sections will create a new minor version.

To create a new major version of a model (1.0, 2.0, etc.), you can choose to copy contents from a previous version or create an empty version, then you can configure the version settings:

1. To create a new major version of a custom model, do either of the following:

   • Open the custom model you want to create a version of, and, on the Assemble tab, in the Version section, click + Add version.

     

   • Open the custom model you want to create a version of, click the Versions tab, and then, on the Versions tab, click + Add version.

     

2. In the Create new model version dialog box, select a version content option and configure the new version:

   

   Setting	Description
   Content	Copy contents of previous version: Add the contents of the current version to the new version of the custom model. Create empty version: Discard the contents of the current version and add new files for the new version of the custom model.
   Base Environment	Select the base execution environment of the new version. The execution environment of the current custom model version is selected by default. In addition, if the selected execution environment does not change, the version of that execution environment persists from the previous custom model version, even if a newer environment version is available. For more information on how to ensure the custom model version uses the latest version of the execution environment, see Trigger base execution environment update.
   New version description	Enter a description of the new version. The version description is optional.
   Keep training data from previous version	Enable or disable adding the training data from the current version to the new custom model version. This setting is enabled by default.

3. Click Create new version.

View version information¶

After you create a custom model and assemble at least one model version, you can view version information and download the code of the custom model represented by that version. To view version information, open the custom model containing the version you want to view, click the Versions tab, and then open the panel for a version where you can view the following sections:

• Overview
• Environment info
• Datasets
• Insights
• Resources
• Runtime Parameters (if defined)
• Files
• Lineage

In a custom model version panel, you can configure a version description and perform a number of other actions (in addition to reviewing custom model version information listed above):

View asset lineage¶

The Lineage section provides an end-to-end visualization of the relationships and dependencies between your MLOps assets. This feature is essential for auditing complex workflows, tracking asset lifecycles, and managing the various components of agentic and generative AI systems. The lineage is presented as a Directed Acyclic Graph (DAG) consisting of nodes (assets) and edges (relationships).

When reviewing nodes, the asset you are currently viewing is distinguished by a purple outline. Nodes display key information such as ID, name (or version number), creator, and the last modification information (user and date).

When reviewing edges, solid lines represent concrete, persistent relationships within the platform, such as a registered model used to create a deployment. Dashed lines indicate relationships inferred from runtime parameters. These are considered less reliable as they may change if a user modifies the underlying code or parameters. Arrows generally flow from the "ancestor" or container to the "descendant" or content (e.g., Registered model version to Deployment).

The view is highly interactive, allowing for deep exploration of your asset ecosystem. To interact with the graph area, use the following controls:

Control	Description
Legend	View the legend defining how lines correspond to edges.
and	Control the magnification level of the graph view.
	Reset the magnification level and center the graph view on the focused node.
	Open a fullscreen view of the related items lineage graph.
and	In fullscreen view, navigate the history of selected nodes (assets/nodes viewed ).

To interact with the related item nodes, use the following controls when they appear: