smom-dbis-138/docs/azure/AZURE_AI_ML_PROVIDERS.md

# Azure AI/ML/OpenAI Resource Providers Status

## Overview

This document tracks the registration status of all AI, ML, OpenAI, and related Azure Resource Providers and Preview Features.

## Required AI/ML Resource Providers

### Core AI/ML Services

| Provider | Status | Purpose | Notes |
|----------|--------|---------|-------|
| **Microsoft.CognitiveServices** | ⚠️ Registering | Azure Cognitive Services (includes Azure OpenAI) | Required for Azure OpenAI Service |
| **Microsoft.MachineLearningServices** | ⚠️ Registering | Azure Machine Learning | Core ML platform |
| **Microsoft.BotService** | ⚠️ Registering | Azure Bot Framework | AI-powered bots |
| **Microsoft.Search** | ⚠️ Registering | Azure AI Search | Cognitive search services |
| **Microsoft.Synapse** | ⚠️ Registering | Azure Synapse Analytics | ML integration and analytics |
| **Microsoft.Databricks** | ⚠️ Registering | Azure Databricks | ML platform and data processing |
| **Microsoft.DataFactory** | ⚠️ Registering | Azure Data Factory | ML pipelines and data orchestration |
| **Microsoft.OperationalInsights** | ✅ Registered | Log Analytics | Used by AI/ML services for monitoring |

### Provider Namespaces Not Found

The following namespaces were checked but not found (may not exist or require special access):

- `Microsoft.MachineLearning` (legacy, may be deprecated)
- `Microsoft.AI` (may not be a separate namespace)
- `Microsoft.OpenAI` (Azure OpenAI uses Microsoft.CognitiveServices)
- `Microsoft.AzureOpenAI` (Azure OpenAI uses Microsoft.CognitiveServices)
- `Microsoft.Cognitive` (legacy, replaced by Microsoft.CognitiveServices)

## Registration Status

### Currently Registering

The following providers are in the process of being registered:

1. **Microsoft.CognitiveServices** - Registration initiated
2. **Microsoft.MachineLearningServices** - Registration initiated
3. **Microsoft.BotService** - Registration initiated
4. **Microsoft.Search** - Registration initiated
5. **Microsoft.Synapse** - Registration initiated
6. **Microsoft.Databricks** - Registration initiated
7. **Microsoft.DataFactory** - Registration initiated

**Note**: Provider registration typically takes 1-5 minutes. Some providers may require subscription approval.

### Verify Registration Status

Check current registration status:

```bash
./scripts/azure/check-ai-ml-providers.sh
```

Or manually check:

```bash
az provider show --namespace Microsoft.CognitiveServices --query "registrationState" -o tsv
az provider show --namespace Microsoft.MachineLearningServices --query "registrationState" -o tsv
```

## Azure OpenAI Service

### Access Requirements

Azure OpenAI Service requires:

1. ✅ **Microsoft.CognitiveServices** provider registered
2. ⚠️ **Access Request** - Azure OpenAI requires explicit access approval
   - Request access: https://aka.ms/oai/access
   - Access is typically granted within 1-2 business days

### Check OpenAI Resources

Once access is granted, check for OpenAI resources:

```bash
az cognitiveservices account list --query "[?kind=='OpenAI'].{Name:name, ResourceGroup:resourceGroup, Kind:kind}" -o table
```

## Azure Machine Learning

### Requirements

1. ✅ **Microsoft.MachineLearningServices** provider registered
2. ⚠️ **Workspace Creation** - Create ML workspace after provider registration

### Check ML Workspaces

```bash
az ml workspace list --query "[].{Name:name, ResourceGroup:resourceGroup}" -o table
```

## Preview Features

### Current Status

No specific AI/ML preview features are currently configured or required.

### Available Preview Features

To check for available preview features:

```bash
# Cognitive Services preview features
az feature list --namespace Microsoft.CognitiveServices --query "[?properties.state=='Registered' || properties.state=='Registering'].{Name:name, State:properties.state}" -o table

# Machine Learning preview features
az feature list --namespace Microsoft.MachineLearningServices --query "[?properties.state=='Registered' || properties.state=='Registering'].{Name:name, State:properties.state}" -o table
```

## Registration Commands

### Register All AI/ML Providers

```bash
for provider in Microsoft.CognitiveServices Microsoft.MachineLearningServices Microsoft.BotService Microsoft.Search Microsoft.Synapse Microsoft.Databricks Microsoft.DataFactory; do
  az provider register --namespace "$provider" --wait
done
```

### Register Individual Providers

```bash
# Cognitive Services (includes Azure OpenAI)
az provider register --namespace Microsoft.CognitiveServices --wait

# Machine Learning
az provider register --namespace Microsoft.MachineLearningServices --wait

# Bot Service
az provider register --namespace Microsoft.BotService --wait

# AI Search
az provider register --namespace Microsoft.Search --wait

# Synapse Analytics
az provider register --namespace Microsoft.Synapse --wait

# Databricks
az provider register --namespace Microsoft.Databricks --wait

# Data Factory
az provider register --namespace Microsoft.DataFactory --wait
```

## Verification Script

Use the automated verification script:

```bash
./scripts/azure/check-ai-ml-providers.sh
```

This script will:
- ✅ Discover all AI/ML related providers
- ✅ Check registration status
- ✅ Register missing providers
- ✅ Verify Azure OpenAI access
- ✅ Check Azure ML workspace access
- ✅ List preview features

## Next Steps

1. ⏳ **Wait for Registration** - Provider registrations typically complete in 1-5 minutes
2. ✅ **Verify Status** - Run verification script: `./scripts/azure/check-ai-ml-providers.sh`
3. ⚠️ **Request Azure OpenAI Access** - If needed: https://aka.ms/oai/access
4. 📝 **Create Resources** - After registration, create AI/ML resources as needed

## Related Services

### Additional AI/ML Related Providers

The following providers were discovered but may not be directly AI/ML focused:

- `Microsoft.HealthDataAIServices` - Health data AI services
- `ArizeAi.ObservabilityEval` - Third-party AI observability

### Monitoring and Analytics

- `Microsoft.OperationalInsights` - ✅ Registered (Log Analytics for AI/ML monitoring)
- `Microsoft.Insights` - ✅ Registered (Azure Monitor)

## Troubleshooting

### Provider Registration Stuck

If a provider remains in "Registering" state for more than 10 minutes:

1. Check subscription status: `az account show`
2. Verify permissions: Ensure you have Contributor or Owner role
3. Try manual registration: `az provider register --namespace <provider> --wait`
4. Check Azure Service Health: Some providers may have temporary issues

### Azure OpenAI Access Denied

If you receive access denied errors:

1. Verify provider is registered: `az provider show --namespace Microsoft.CognitiveServices`
2. Request access: https://aka.ms/oai/access
3. Wait for approval (typically 1-2 business days)
4. Verify access: `az cognitiveservices account list --query "[?kind=='OpenAI']"`

### Machine Learning Workspace Creation Fails

If ML workspace creation fails:

1. Verify provider registration: `az provider show --namespace Microsoft.MachineLearningServices`
2. Check quota: `az ml quota list --location westeurope`
3. Verify permissions: Ensure Contributor role on subscription

## References

- [Azure Cognitive Services](https://azure.microsoft.com/services/cognitive-services/)
- [Azure OpenAI Service](https://azure.microsoft.com/products/cognitive-services/openai-service/)
- [Azure Machine Learning](https://azure.microsoft.com/services/machine-learning/)
- [Azure AI Search](https://azure.microsoft.com/services/search/)
- [Resource Provider Registration](https://docs.microsoft.com/azure/azure-resource-manager/management/resource-providers-and-types)