Personnaliser le déploiement du modèle

Workflow guidé interactif pour déployer des modèles Azure OpenAI avec contrôle total de la personnalisation sur la version, la SKU, la capacité, le filtrage de contenu et les options avancées.

Référence rapide

Quand utiliser cette compétence

Utilisez cette compétence quand vous avez besoin d'un contrôle précis de la configuration de déploiement :

• ✅ Choisir une version spécifique du modèle (pas seulement la dernière)
• ✅ Sélectionner la SKU de déploiement (GlobalStandard vs Standard vs PTU)
• ✅ Définir la capacité exacte dans la plage disponible
• ✅ Configurer le filtrage de contenu (sélection de la politique RAI)
• ✅ Activer les fonctionnalités avancées (quota dynamique, traitement prioritaire, débordement)
• ✅ Déploiements PTU (Provisioned Throughput Units)

Alternative : Utilisez preset pour un déploiement rapide vers la meilleure région disponible avec configuration automatique.

Comparaison : customize vs preset

Prérequis

• Abonnement Azure avec rôle Cognitive Services Contributor ou Owner
• ID de ressource du projet Azure AI Foundry (format : /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{account}/projects/{project})
• Azure CLI installé et authentifié (az login)
• Optionnel : Définir la variable d'environnement PROJECT_RESOURCE_ID

Vue d'ensemble du workflow

Flux complet (14 phases)

1. Verify Authentication
2. Get Project Resource ID
3. Verify Project Exists
4. Get Model Name (if not provided)
5. List Model Versions → User Selects
6. List SKUs for Version → User Selects
7. Get Capacity Range → User Configures
   7b. If no capacity: Cross-Region Fallback → Query all regions → User selects region/project
8. List RAI Policies → User Selects
9. Configure Advanced Options (if applicable)
10. Configure Version Upgrade Policy
11. Generate Deployment Name
12. Review Configuration
13. Execute Deployment & Monitor

Chemin rapide (Valeurs par défaut)

Si l'utilisateur accepte toutes les valeurs par défaut (dernière version, SKU GlobalStandard, capacité recommandée, politique RAI par défaut, politique de mise à niveau standard), le déploiement s'effectue en ~5 interactions.

Résumés des phases

⚠️ À LIRE ABSOLUMENT : Avant d'exécuter une phase, chargez references/customize-workflow.md pour les scripts complets et les détails d'implémentation. Les résumés ci-dessous décrivent ce que fait chaque phase — le fichier de référence contient le comment (commandes CLI, modèles de quota, formules de capacité, logique de basculement cross-région).

Gestion des erreurs

Problèmes courants et résolutions

Commandes de dépannage

# Vérifier le statut du déploiement
az cognitiveservices account deployment show --name <account> --resource-group <rg> --deployment-name <name>

# Lister tous les déploiements
az cognitiveservices account deployment list --name <account> --resource-group <rg> -o table

# Vérifier l'utilisation du quota
az cognitiveservices usage list --name <account> --resource-group <rg>

# Supprimer un déploiement échoué
az cognitiveservices account deployment delete --name <account> --resource-group <rg> --deployment-name <name>

Guides de sélection et sujets avancés

Pour les tableaux de comparaison des SKU, les formules de dimensionnement PTU et les détails des options avancées, chargez references/customize-guides.md.

Sélection SKU : GlobalStandard (production/HA) → Standard (dev/test) → ProvisionedManaged (haut volume/débit garanti) → DataZoneStandard (résidence des données).

Capacité : Les SKU basées sur TPM vont de 1K (dev) à 100K+ (grande production). Les SKU basées sur PTU utilisent la formule : (Input TPM × 0.001) + (Output TPM × 0.002) + (Requests/min × 0.1).

Options avancées : Quota dynamique (GlobalStandard uniquement), traitement prioritaire (PTU uniquement, coût supplémentaire), débordement (débordement vers déploiement de secours).

Compétences associées

• preset - Déploiement rapide vers la meilleure région avec configuration automatique
• microsoft-foundry - Compétence parente pour toutes les opérations Azure AI Foundry
• quota — Pour l'affichage des quotas, les demandes d'augmentation et le dépannage des erreurs de quota, reportez-vous à cette compétence au lieu de dupliquer les conseils
• rbac - Gérer les permissions et le contrôle d'accès

Notes

• Définir la variable d'environnement PROJECT_RESOURCE_ID pour ignorer l'invite
• Toutes les SKU ne sont pas disponibles dans toutes les régions ; la capacité varie selon l'abonnement/région/modèle
• Les politiques RAI personnalisées peuvent être configurées dans le portail Azure
• Les mises à niveau automatiques de version se produisent pendant les fenêtres de maintenance
• Utiliser Azure Monitor et Application Insights pour les déploiements en production