azure-machine-learning

name	azure-machine-learning
description	Expert knowledge for Azure Machine Learning development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Azure ML workspaces, AutoML, Prompt Flow, online/batch endpoints, or the Python SDK/CLI, and other Azure Machine Learning related development tasks. Not for Azure Databricks (use azure-databricks), Azure Synapse Analytics (use azure-synapse-analytics), Azure Data Science Virtual Machines (use azure-data-science-vm), Azure HDInsight (use azure-hdinsight).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-04-19","generator":"docs2skills/1.0.0"}

Azure Machine Learning Skill

This skill provides expert guidance for Azure Machine Learning. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

• Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
• Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category	Lines	Description
Troubleshooting	L37-L71	Diagnosing and fixing Azure ML issues: pipelines, AutoML, endpoints (online/batch), networking (VNet/private/Kubernetes), environments/images, prompt flow, feature store, and known bugs.
Best Practices	L72-L95	Best practices for Azure ML training, AutoML, and LLM/prompt flow: cost and compute optimization, data prep, monitoring, deployment scripts, performance tuning, and ethical data use.
Decision Making	L96-L124	Guidance on Azure ML design choices: algorithm selection, training methods, networking and DR, cost optimization, and detailed migration/upgrade paths from SDK v1 to v2 and between services.
Architecture & Design Patterns	L125-L131	Designing Azure ML inference architectures: choosing endpoint types, planning real-time online endpoints, and structuring data movement and multistep pipeline components.
Limits & Quotas	L132-L140	Info on Azure ML regional/sovereign availability, VM SKUs, and service limits, plus how to view, plan, and manage quotas and capacity for model deployments and endpoints.
Security	L141-L194	Securing Azure ML workspaces, data, and endpoints with encryption, identity/RBAC, Key Vault, policies, and network isolation (VNets, private access, exfiltration prevention).
Configuration	L195-L467	Configuring Azure ML: designer components, AutoML, compute, networking, data, monitoring, registries, prompt flow, and full CLI/SDK/YAML setup for training, deployment, and ops.
Integrations & Coding Patterns	L468-L511	Integrating Azure ML with data sources, Spark/Databricks/Synapse, MLflow, REST/HTTP, prompt flow, and batch/online endpoints, plus patterns for logging, storage, and deployment.
Deployment	L512-L553	Deploying and operationalizing models and prompt flows: online/batch endpoints, AKS/ACI, CI/CD, MLOps/GenAIOps, blue‑green rollouts, pipelines, and cross-workspace consumption.

Troubleshooting

Topic	URL
Troubleshoot Azure ML designer component error codes	https://learn.microsoft.com/en-us/azure/machine-learning/component-reference/designer-error-codes?view=azureml-api-2
Resolve common Azure AutoML forecasting issues	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-automl-forecasting-faq?view=azureml-api-2
Debug Azure ML online endpoints locally with VS Code	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-debug-managed-online-endpoints-visual-studio-code?view=azureml-api-2
Troubleshoot ParallelRunStep failures in Azure ML pipelines	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-debug-parallel-run-step?view=azureml-api-1
Debug Azure ML pipeline failures in studio	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-debug-pipeline-failure?view=azureml-api-2
Diagnose Azure ML pipeline performance issues with profiling	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-debug-pipeline-performance?view=azureml-api-2
Diagnose and fix Azure ML pipeline reuse issues	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-debug-pipeline-reuse-issues?view=azureml-api-2
Troubleshoot Azure ML SDK v1 pipelines	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-debug-pipelines?view=azureml-api-1
Troubleshoot Azure automated ML experiment failures	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-troubleshoot-auto-ml?view=azureml-api-2

Best Practices

Topic	URL
Mitigate overfitting and imbalance in Azure AutoML	https://learn.microsoft.com/en-us/azure/machine-learning/concept-manage-ml-pitfalls?view=azureml-api-2
Understand Azure ML model monitoring concepts and practices	https://learn.microsoft.com/en-us/azure/machine-learning/concept-model-monitoring?view=azureml-api-2
Optimize and manage Azure Machine Learning costs	https://learn.microsoft.com/en-us/azure/machine-learning/concept-plan-manage-cost?view=azureml-api-2
Ethical best practices for sourcing human data	https://learn.microsoft.com/en-us/azure/machine-learning/concept-sourcing-human-data?view=azureml-api-2
Design feature set transformations in Azure ML	https://learn.microsoft.com/en-us/azure/machine-learning/feature-set-specification-transformation-concepts?view=azureml-api-2
Author batch scoring scripts for AML batch deployments	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-batch-scoring-script?view=azureml-api-2
Write advanced Azure ML entry scripts for inference	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-deploy-advanced-entry-script?view=azureml-api-1
Profile AML model CPU and memory usage before deployment	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-deploy-profile-model?view=azureml-api-1
Tune Azure ML Kubernetes inference router performance	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-kubernetes-inference-routing-azureml-fe?view=azureml-api-2

Decision Making

Topic	URL
Choose Azure ML designer algorithms with cheat sheet	https://learn.microsoft.com/en-us/azure/machine-learning/algorithm-cheat-sheet?view=azureml-api-1
Plan Azure ML registries for multi-environment MLOps	https://learn.microsoft.com/en-us/azure/machine-learning/concept-machine-learning-registries-mlops?view=azureml-api-2
Choose between managed and custom network isolation in Azure ML	https://learn.microsoft.com/en-us/azure/machine-learning/concept-network-isolation-configurations?view=azureml-api-2
Choose the right Azure ML training method	https://learn.microsoft.com/en-us/azure/machine-learning/concept-train-machine-learning-model?view=azureml-api-2
Choose migration paths from Azure ML Data Import to Fabric	https://learn.microsoft.com/en-us/azure/machine-learning/data-import-migration-guide?view=azureml-api-2
Plan failover and disaster recovery for Azure ML	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-high-availability-machine-learning?view=azureml-api-2
Manage and migrate imported data assets in Azure ML	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-manage-imported-data-assets?view=azureml-api-2
Decide when and how to upgrade AML v1 to v2	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-migrate-from-v1?view=azureml-api-2
Move Azure ML workspaces between subscriptions	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-move-workspace?view=azureml-api-2

Architecture & Design Patterns

Topic	URL
Plan real-time inference with Azure ML online endpoints	https://learn.microsoft.com/en-us/azure/machine-learning/concept-endpoints-online?view=azureml-api-2
Understand Azure ML endpoint types for inference	https://learn.microsoft.com/en-us/azure/machine-learning/concept-endpoints?view=azureml-api-2
Design data movement patterns in Azure ML pipelines	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-move-data-in-out-of-pipelines?view=azureml-api-1

Limits & Quotas

Topic	URL
Check regional availability for standard model deployments	https://learn.microsoft.com/en-us/azure/machine-learning/concept-endpoint-serverless-availability?view=azureml-api-2
Manage Azure ML resource quotas and limits	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-manage-quotas?view=azureml-api-2
Check Azure ML feature availability by sovereign cloud	https://learn.microsoft.com/en-us/azure/machine-learning/reference-machine-learning-cloud-parity?view=azureml-api-2
Supported VM SKUs for Azure ML managed online endpoints	https://learn.microsoft.com/en-us/azure/machine-learning/reference-managed-online-endpoints-vm-sku-list?view=azureml-api-2
Plan capacity with Azure Machine Learning service limits	https://learn.microsoft.com/en-us/azure/machine-learning/resource-limits-capacity?view=azureml-api-2

Security

Topic	URL
Use customer-managed keys with Azure Machine Learning	https://learn.microsoft.com/en-us/azure/machine-learning/concept-customer-managed-keys?view=azureml-api-2
Understand data encryption for Azure ML compute and storage	https://learn.microsoft.com/en-us/azure/machine-learning/concept-data-encryption?view=azureml-api-2
Understand data handling and privacy for Model Catalog deployments	https://learn.microsoft.com/en-us/azure/machine-learning/concept-data-privacy?view=azureml-api-2
Understand auth and RBAC for AML online endpoints	https://learn.microsoft.com/en-us/azure/machine-learning/concept-endpoints-online-auth?view=azureml-api-2
Plan enterprise security and governance for Azure ML	https://learn.microsoft.com/en-us/azure/machine-learning/concept-enterprise-security?view=azureml-api-2
Secret injection concepts for AML online endpoints	https://learn.microsoft.com/en-us/azure/machine-learning/concept-secret-injection?view=azureml-api-2
Understand secure network traffic flow in Azure ML VNets	https://learn.microsoft.com/en-us/azure/machine-learning/concept-secure-network-traffic-flow?view=azureml-api-2
Network isolation concepts for AML managed endpoints	https://learn.microsoft.com/en-us/azure/machine-learning/concept-secure-online-endpoint?view=azureml-api-2
Manage vulnerabilities for Azure ML images and components	https://learn.microsoft.com/en-us/azure/machine-learning/concept-vulnerability-management?view=azureml-api-2

Configuration

Topic	URL
Configure AutoML Classification component with ML Tables	https://learn.microsoft.com/en-us/azure/machine-learning/component-reference-v2/classification?view=azureml-api-2
Configure AutoML Forecasting component in designer	https://learn.microsoft.com/en-us/azure/machine-learning/component-reference-v2/forecasting?view=azureml-api-2
Configure AutoML Image Multi-label Classification	https://learn.microsoft.com/en-us/azure/machine-learning/component-reference-v2/image-classification-multilabel?view=azureml-api-2
Configure AutoML Image Classification component	https://learn.microsoft.com/en-us/azure/machine-learning/component-reference-v2/image-classification?view=azureml-api-2
Configure AutoML Image Instance Segmentation component	https://learn.microsoft.com/en-us/azure/machine-learning/component-reference-v2/image-instance-segmentation?view=azureml-api-2
Configure AutoML Image Object Detection component	https://learn.microsoft.com/en-us/azure/machine-learning/component-reference-v2/image-object-detection?view=azureml-api-2
Configure AutoML Regression component with ML Tables	https://learn.microsoft.com/en-us/azure/machine-learning/component-reference-v2/regression?view=azureml-api-2
Configure AutoML Text Multi-label Classification component	https://learn.microsoft.com/en-us/azure/machine-learning/component-reference-v2/text-classification-multilabel?view=azureml-api-2
Configure AutoML Text Classification component	https://learn.microsoft.com/en-us/azure/machine-learning/component-reference-v2/text-classification?view=azureml-api-2

Integrations & Coding Patterns

Topic	URL
Configure input data sources for AML batch endpoint jobs	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-access-data-batch-endpoints-jobs?view=azureml-api-2
Set up Azure Databricks with AutoML in Azure ML	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-configure-databricks-automl-environment?view=azureml-api-1
Ingest data to Azure ML with Data Factory	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-data-ingest-adf?view=azureml-api-1
Wrangle data using Synapse Spark with Azure ML	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-data-prep-synapse-spark-pool?view=azureml-api-1
Configure Azure ML datastores for storage access	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-datastore?view=azureml-api-2
Configure Azure ML datastores for storage access	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-datastore?view=azureml-api-2
Run MLflow models in Azure ML Spark jobs	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-deploy-mlflow-model-spark-jobs?view=azureml-api-2
Deploy AML models as custom skills for Azure AI Search	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-deploy-model-cognitive-search?view=azureml-api-1
Deploy Hugging Face transformer models to Azure ML endpoints	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-deploy-models-from-huggingface?view=azureml-api-2

Deployment

Topic	URL
Consume Azure ML standard deployments across workspaces	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-connect-models-serverless?view=azureml-api-2
Convert ML notebooks to production scripts with MLOpsPython	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-convert-ml-experiment-to-production?view=azureml-api-1
Deploy AutoML models to AML online endpoints	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-deploy-automl-endpoint?view=azureml-api-2
Deploy AML models to Azure Container Instances with CLI v1	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-deploy-azure-container-instance?view=azureml-api-1
Deploy AML models to Azure Kubernetes Service with SDK/CLI v1	https://learn.microsoft.com/en-us/azure/machine-learning/how-to-deploy-azure-kubernetes-service?view=azureml-api-1