Create a training run using the Foundation Model Training UI

Important

This feature is in Public Preview. Reach out to your Databricks account team to enroll in the Public Preview.

This article describes how to create and configure a training run using the Foundation Model Training UI. You can also create a run using the API. For instructions, see Create a training run using the Foundation Model Training API.

Requirements

See Requirements.

Create a training run using the UI

Follow these steps to create a training run using the UI.

  1. In the left sidebar, click Experiments.

  2. On the Foundation Model Training card, click Create Foundation Model Experiment.

    Foundation model experiment form
  3. The Foundation Model Training form opens. Items marked with an asterisk are required. Make your selections, and then click Start Training.

    Type: Select the task to perform.

    Task

    Description

    Instruction Finetuning

    Continue training a foundation model with prompt-and-response input to optimize the model for a specific task.

    Continued Pre-training

    Continue training a foundation model to give it domain-specific knowledge.

    Chat Completion

    Continue training a foundation model with chat logs to optimize it for Q&A or conversation applications.

    Select Foundation Model: Select the model to tune or train. For a list of supported models, see Supported models.

    Training data: Click Browse to select a table in Unity Catalog, or enter the full URL for a Hugging Face dataset. For data size recommendations, see Recommended data size for model training.

    If you select a table in Unity Catalog, you must also select the compute to use to read the table.

    Register to location: Select the Unity Catalog catalog and schema from the drop-down menus. The trained model is saved to this location.

    Model name: The model is saved with this name in the catalog and schema you specified. A default name appears in this field, which you can change if desired.

    Advanced options: For more customization, you can configure optional settings for evaluation, hyperparameter tuning, or train from an existing proprietary model.

    Setting

    Description

    Training duration

    Duration of the training run, specified in epochs (for example, 10ep) or tokens (for example, 1000000tok). Default is 1ep.

    Learning rate

    The learning rate for model training. Default is 5e-7. The optimizer is DecoupledLionW with betas of 0.99 and 0.95 and no weight decay. The learning rate scheduler is LinearWithWarmupSchedule with a warmup of 2% of the total training duration and a final learning rate multiplier of 0.

    Context length

    The maximum sequence length of a data sample. Data longer than this setting is truncated. The default depends on the model selected.

    Evaluation data

    Click Browse to select a table in Unity Catalog, or enter the full URL for a Hugging Face dataset. If you leave this field blank, no evaluation is performed.

    Model evaluation prompts

    Type optional prompts to use to evaluate the model.

    Experiment name

    By default, a new, automatically generated name is assigned for each run. You can optionally enter a custom name or select an existing experiment from the drop-down list.

    Custom weights

    By default, training begins by using the original weights of the selected model. To start with custom weights from a Composer checkpoint, enter the path to the Unity Catalog table that contains the checkpoint values.