Merge pull request #276130 from v-thepet/designer1

243805 - What is designer v1

Author: v-regandowner

articles/machine-learning/media/concept-designer/designer-workflow-diagram.png

@@ -1,130 +1,126 @@
 ---
-title: What is the Azure Machine Learning designer(v1)?
+title: What is Designer (v1)?
 titleSuffix: Azure Machine Learning
-description: Learn what the Azure Machine Learning designer is and what tasks you can use it for. The drag-and-drop UI enables model training and deployment. 
+description: Learn about how the drag-and-drop Designer (v1) UI in Azure Machine Learning studio enables model training and deployment tasks.
 services: machine-learning
 ms.service: machine-learning
 ms.subservice: core
 ms.topic: conceptual
 ms.author: lagayhar
 ms.reviewer: lagayhar
 author: lgayhardt
-ms.date: 05/25/2023
+ms.date: 05/22/2024
 ms.custom: UpdateFrequency5, designer, training
 ---
 
-# What is Azure Machine Learning designer (v1)? 
+# What is Designer (v1) in Azure Machine Learning?
 
-Azure Machine Learning designer is a drag-and-drop interface used to train and deploy models in Azure Machine Learning. This article describes the tasks you can do in the designer.
+The Azure Machine Learning designer is a drag-and-drop interface used to train and deploy models in Azure Machine Learning studio. This article describes the tasks you can do in the designer.
 
->[!Note]
-> Designer supports two types of components, classic prebuilt components（v1） and custom components(v2). These two types of components are NOT compatible. 
->
->Classic prebuilt components provide prebuilt components majorly for data processing and traditional machine learning tasks like regression and classification. This type of component continues to be supported but will not have any new components added. 
->
->Custom components allow you to wrap your own code as a component. It supports sharing components across workspaces and seamless authoring across Studio, CLI v2, and SDK v2 interfaces. 
->
->For new projects, we highly suggest you use custom component, which is compatible with AzureML V2 and will keep receiving new updates. 
->
->This article applies to classic prebuilt components and not compatible with CLI v2 and SDK v2.
+> [!IMPORTANT]
+> Designer in Azure Machine Learning supports two types of pipelines that use classic prebuilt (v1) or custom (v2) components. The two component types aren't compatible within pipelines, and designer v1 isn't compatible with CLI v2 and SDK v2. **This article applies to pipelines that use classic prebuilt (v1) components.**
+> 
+> - **Classic prebuilt components (v1)** include typical data processing and machine learning tasks like regression and classification. Azure Machine Learning continues to support the existing classic prebuilt components, but no new prebuilt components are being added.
+> 
+> - **Custom components (v2)** let you wrap your own code as components, enabling sharing across workspaces and seamless authoring across Azure Machine Learning studio, CLI v2, and SDK v2 interfaces. It's best to use custom components for new projects, because they're compatible with Azure Machine Learning v2 and continue to receive new updates. For more information about custom components and Designer (v2), see [Azure Machine Learning designer (v2)](../concept-designer.md?view=azureml-api-2&preserve-view=true).
 
- - To get started with the designer, see [Tutorial: Train a no-code regression model](tutorial-designer-automobile-price-train-score.md). 
- - To learn about the components available in the designer, see the [Algorithm and component reference](../algorithm-module-reference/module-reference.md).
+The following animated GIF shows how you can build a pipeline visually in Designer by dragging and dropping assets and connecting them.
 
 :::image type="content" source="../media/concept-designer/designer-drag-and-drop.gif" alt-text="GIF of a building a pipeline in the designer." lightbox= "../media/concept-designer/designer-drag-and-drop.gif":::
 
+To learn about the components available in the designer, see the [Algorithm and component reference](../algorithm-module-reference/module-reference.md). To get started with the designer, see [Tutorial: Train a no-code regression model](tutorial-designer-automobile-price-train-score.md).
+
+## Model training and deployment
+
 The designer uses your Azure Machine Learning [workspace](../concept-workspace.md) to organize shared resources such as:
 
-+ [Pipelines](#pipeline)
-+ [Data](#data)
-+ [Compute resources](#compute)
-+ [Registered models](concept-azure-machine-learning-architecture.md#models)
-+ [Published pipelines](#publish)
-+ [Real-time endpoints](#deploy)
+- [Pipelines](#pipelines)
+- [Data](#data)
+- [Compute resources](#compute)
+- [Registered models](concept-azure-machine-learning-architecture.md#models)
+- [Published pipeline jobs](#publish)
+- [Real-time endpoints](#deploy)
 
-## Model training and deployment
+The following diagram illustrates how you can use the designer to build an end-to-end machine learning workflow. You can train, test, and deploy models, all in the designer interface.
 
-Use a visual canvas to build an end-to-end machine learning workflow. Train, test, and deploy models all in the designer:
+:::image type="content" source="../media/concept-designer/designer-workflow-diagram.png" alt-text="Workflow diagram for training, batch inference, and real-time inference in the designer." border="false":::
 
-+ Drag-and-drop [data assets](#data) and [components](#component) onto the canvas.
-+ Connect the components to create a [pipeline draft](#pipeline-draft).
-+ Submit a [pipeline run](#pipeline-job) using the compute resources in your Azure Machine Learning workspace.
-+ Convert your **training pipelines** to **inference pipelines**.
-+ [Publish](#publish) your pipelines to a REST **pipeline endpoint** to submit a new pipeline that runs with different parameters and data assets.
-    + Publish a **training pipeline** to reuse a single pipeline to train multiple models while changing parameters and data assets.
-    + Publish a **batch inference pipeline** to make predictions on new data by using a previously trained model.
-+ [Deploy](#deploy) a **real-time inference pipeline** to an online endpoint to make predictions on new data in real time.
+- Drag and drop [data assets](#data) and [components](#components) onto the designer visual canvas, and connect the components to create a [pipeline draft](#pipeline-drafts).
+- Submit a [pipeline job](#pipeline-jobs) that uses the compute resources in your Azure Machine Learning workspace.
+- Convert your **training pipelines** to **inference pipelines**.
+- [Publish](#publish) your pipelines to a REST **pipeline endpoint** to submit new pipelines that run with different parameters and data assets.
+  - Publish a **training pipeline** to reuse a single pipeline to train multiple models while changing parameters and data assets.
+  - Publish a **batch inference pipeline** to make predictions on new data by using a previously trained model.
+- [Deploy](#deploy) a **real-time inference pipeline** to an online endpoint to make predictions on new data in real time.
 
-:::image type="content" source="../media/concept-designer/designer-workflow-diagram.png" alt-text="Workflow diagram for training, batch inference, and real-time inference in the designer.":::
+## Data
 
-## Pipeline
+A machine learning data asset makes it easy to access and work with your data. The designer includes several [sample data assets](samples-designer.md#datasets) for you to experiment with. You can [register](how-to-create-register-datasets.md) more data assets as you need them.
 
-A [pipeline](../concept-ml-pipelines.md) consists of data assets and analytical components, which you connect. Pipelines have many uses: you can make a pipeline that trains a single model, or one that trains multiple models. You can create a pipeline that makes predictions in real time or in batch, or make a pipeline that only cleans data. Pipelines let you reuse your work and organize your projects.
+## Components
 
-### Pipeline draft
+A component is an algorithm that you can run on your data. The designer has several components ranging from data ingress functions to training, scoring, and validation processes.
 
-As you edit a pipeline in the designer, your progress is saved as a **pipeline draft**. You can edit a pipeline draft at any point by adding or removing components, configuring compute targets, creating parameters, and so on.
+A component can have parameters that you use to configure the component's internal algorithms. When you select a component on the canvas, the component's parameters and other settings display in a properties pane at the right of the canvas. You can modify the parameters and set the compute resources for individual components in that pane.
 
-A valid pipeline has these characteristics:
+:::image type="content" source="../media/concept-designer/properties.png" alt-text="Screenshot showing the component properties.":::
 
-* Data assets can only connect to components.
-* components can only connect to either data assets or other components.
-* All input ports for components must have some connection to the data flow.
-* All required parameters for each component must be set.
+For more information about the library of available machine learning algorithms, see the [Algorithm and component reference](../component-reference/component-reference.md). For help with choosing an algorithm, see the [Azure Machine Learning Algorithm Cheat Sheet](algorithm-cheat-sheet.md).
 
-When you're ready to run your pipeline draft, you submit a pipeline job.
+## Pipelines
 
-### Pipeline job
+A [pipeline](../concept-ml-pipelines.md) consists of data assets and analytical components that you connect. Pipelines help you reuse your work and organize your projects.
 
-Each time you run a pipeline, the configuration of the pipeline and its results are stored in your workspace as a **pipeline job**. You can go back to any pipeline job to inspect it for troubleshooting or auditing. **Clone** a pipeline job to create a new pipeline draft for you to edit.
+Pipelines have many uses. You can create pipelines that:
 
-Pipeline jobs are grouped into experiments to organize job history. You can set the experiment for every pipeline job. 
+- Train a single model.
+- Train multiple models.
+- Make predictions in real time or in batch.
+- Clean data only.
 
-## Data
+### Pipeline drafts
 
-A machine learning data asset makes it easy to access and work with your data. Several [sample data assets](samples-designer.md#datasets) are included in the designer for you to experiment with. You can [register](how-to-create-register-datasets.md) more data assets as you need them.
+As you edit a pipeline in the designer, your progress is saved as a *pipeline draft*. You can edit a pipeline draft at any point by adding or removing components, configuring compute targets, or setting parameters.
 
-## Component
+A valid pipeline has the following characteristics:
 
-A component is an algorithm that you can perform on your data. The designer has several components ranging from data ingress functions to training, scoring, and validation processes.
+- Data assets can connect only to components.
+- Components can connect only to data assets or to other components.
+- All input ports for components must have some connection to the data flow.
+- All required parameters for each component must be set.
 
-A component may have a set of parameters that you can use to configure the component's internal algorithms. When you select a component on the canvas, the component's parameters are displayed in the Properties pane to the right of the canvas. You can modify the parameters in that pane to tune your model. You can set the compute resources for individual components in the designer.
+When you're ready to run your pipeline draft, you save the pipeline and submit a pipeline job.
 
-:::image type="content" source="../media/concept-designer/properties.png" alt-text="Screenshot showing the component properties.":::
+### Pipeline jobs
 
+Each time you run a pipeline, the configuration of the pipeline and its results are stored in your workspace as a *pipeline job*. Pipeline jobs are grouped into *experiments* to organize job history.
 
-For some help navigating through the library of machine learning algorithms available, see [Algorithm & component reference overview](../component-reference/component-reference.md). For help with choosing an algorithm, see the [Azure Machine Learning Algorithm Cheat Sheet](algorithm-cheat-sheet.md).
+You can go back to any pipeline job to inspect it for troubleshooting or auditing. **Clone** a pipeline job to create a new pipeline draft to edit.
 
 ## <a name="compute"></a> Compute resources
 
-Use compute resources from your workspace to run your pipeline and host your deployed models as online endpoints or pipeline endpoints (for batch inference). The supported compute targets are:
+Compute targets are attached to your [Azure Machine Learning workspace](../concept-workspace.md) in [Azure Machine Learning studio](https://ml.azure.com). Use compute resources from your workspace to run your pipeline and host your deployed models as online endpoints or as pipeline endpoints for batch inference. The supported compute targets are as follows:
 
 | Compute target | Training | Deployment |
 | ---- |:----:|:----:|
 | Azure Machine Learning compute | ✓ | |
-| Azure Kubernetes Service | | ✓ |
-
-Compute targets are attached to your [Azure Machine Learning workspace](../concept-workspace.md). You manage your compute targets in your workspace in the [Azure Machine Learning studio](https://ml.azure.com).
+| Azure Kubernetes Service (AKS) | | ✓ |
 
 ## Deploy
 
-To perform real-time inferencing, you must deploy a pipeline as an [online endpoint](../concept-endpoints-online.md). The online endpoint creates an interface between an external application and your scoring model. A call to an online endpoint returns prediction results to the application in real time. To make a call to an online endpoint, you pass the API key that was created when you deployed the endpoint. The endpoint is based on REST, a popular architecture choice for web programming projects.
+To do real-time inferencing, you must deploy a pipeline as an [online endpoint](../concept-endpoints-online.md). The online endpoint creates an interface between an external application and your scoring model. The endpoint is based on REST, a popular architecture choice for web programming projects. A call to an online endpoint returns prediction results to the application in real time.
 
-Online endpoints must be deployed to an Azure Kubernetes Service cluster.
-
-To learn how to deploy your model, see [Tutorial: Deploy a machine learning model with the designer](tutorial-designer-automobile-price-deploy.md).
+To make a call to an online endpoint, you pass the API key that was created when you deployed the endpoint. Online endpoints must be deployed to an AKS cluster. To learn how to deploy your model, see [Tutorial: Deploy a machine learning model with the designer](tutorial-designer-automobile-price-deploy.md).
 
 ## Publish
 
-You can also publish a pipeline to a **pipeline endpoint**. Similar to an online endpoint, a pipeline endpoint lets you submit new pipeline jobs from external applications using REST calls. However, you cannot send or receive data in real time using a pipeline endpoint.
-
-Published pipelines are flexible, they can be used to train or retrain models, [perform batch inferencing](how-to-run-batch-predictions-designer.md), process new data, and much more. You can publish multiple pipelines to a single pipeline endpoint and specify which pipeline version to run.
+You can also publish a pipeline to a *pipeline endpoint*. Similar to an online endpoint, a pipeline endpoint lets you submit new pipeline jobs from external applications by using REST calls. However, you can't send or receive data in real time by using a pipeline endpoint.
 
-A published pipeline runs on the compute resources you define in the pipeline draft for each component.
+Published pipeline endpoints are flexible and can be used to train or retrain models, [do batch inferencing](how-to-run-batch-predictions-designer.md), or process new data. You can publish multiple pipelines to a single pipeline endpoint and specify which pipeline version to run.
 
-The designer creates the same [PublishedPipeline](/python/api/azureml-pipeline-core/azureml.pipeline.core.graph.publishedpipeline) object as the SDK.
+A published pipeline runs on the compute resources you define in the pipeline draft for each component. The designer creates the same [PublishedPipeline](/python/api/azureml-pipeline-core/azureml.pipeline.core.graph.publishedpipeline) object as the SDK.
 
-## Next steps
+## Related content
 
-* Learn the fundamentals of predictive analytics and machine learning with [Tutorial: Predict automobile price with the designer](tutorial-designer-automobile-price-train-score.md)
-* Learn how to modify existing [designer samples](samples-designer.md) to adapt them to your needs.
+- Learn the fundamentals of predictive analytics and machine learning with [Tutorial: Predict automobile price with the designer](tutorial-designer-automobile-price-train-score.md).
+- Learn how to modify existing [designer samples](samples-designer.md) to adapt them to your needs.