Démarrage rapide : Configurer des ressources Microsoft Foundry

• Installez le Azure CLI version 2.80.0 ou ultérieure. Vérifiez votre version avec az version, puis exécutez az upgrade si vous en avez besoin une plus récente.

  La version 2.80.0 a ajouté les az cognitiveservices account project commandes que ces étapes utilisent. Sur une version antérieure, les commandes échouent avec unrecognized arguments ou 'project' is misspelled or not recognized by the system.

• Connectez-vous à Azure :

  az login
  

• Accédez au portail Microsoft Foundry.

1. Créez un groupe de ressources ou utilisez-en un existant. Par exemple, créez my-foundry-rg dans eastus:

   az group create --name my-foundry-rg --location eastus
   

   Vérifiez que le groupe de ressources existe :

   az group show --name my-foundry-rg --query properties.provisioningState --output tsv
   

   La sortie affiche Succeeded.

2. Créez la ressource Foundry avec la gestion de projet activée. Par exemple, créez my-foundry-resource dans le my-foundry-rg groupe de ressources :

   az cognitiveservices account create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --kind AIServices \
       --sku S0 \
       --location eastus \
       --custom-domain my-foundry-resource \
       --assign-identity \
       --allow-project-management true
   

   Utilisez ces valeurs :

   Paramètre	Purpose
   --assign-identity	Crée l’identité managée requise par la gestion de projet. Sans cela, la création du projet échoue avec une erreur indiquant qu’une identité managée doit être activée sur la ressource.
   --allow-project-management	Active la gestion des projets. Vous ne pouvez pas modifier ce paramètre après avoir créé la ressource.
   --custom-domain	Il doit être globalement unique. Si my-foundry-resource est utilisé, la commande échoue en renvoyant CustomDomainInUse. Choisissez un autre nom et réexécutez la commande.

3. Créez un projet. Par exemple, créez my-foundry-project dans :my-foundry-resource

   az cognitiveservices account project create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project \
       --location eastus
   

4. Vérifiez que la ressource est provisionnée :

   az cognitiveservices account show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --query properties.provisioningState --output tsv
   

   La sortie doit afficher Succeeded. Si la sortie affiche un état différent, vérifiez vos autorisations, disponibilité de région et quotas de ressources. Pour plus d’aide, consultez Créer une ressource multiservices.

5. Vérifiez que le projet a été créé :

   az cognitiveservices account project show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project \
       --query properties.provisioningState --output tsv
   

   La sortie doit afficher Succeeded. Si la commande échoue avec un message indiquant qu’une identité managée doit être activée, vérifiez que vous avez créé la ressource avec --assign-identity.

Référence : az cognitiveservices account project

1. Connectez-vous à Microsoft Foundry. Vérifiez que le commutateur New Foundry est activé. Ces étapes font référence à Foundry (nouveau).

   

2. Créez un projet.

   • S’il s’agit de votre première utilisation de Foundry, vous êtes invité à créer ou à rechercher un projet à poursuivre. Sélectionnez Créer un projet dans la liste déroulante.
   • Si vous avez déjà chargé un projet, sélectionnez son nom dans le coin supérieur gauche, puis sélectionnez Créer un projet.

3. Entrez un nom de projet, tel que my-foundry-project.

4. Sélectionnez Options avancées pour configurer le groupe de ressources et l’emplacement :

   • Groupe de ressources : Créez un groupe de ressources ou sélectionnez-en un existant. Si vous créez un groupe de ressources, vous pouvez gérer plus facilement le projet et toutes ses ressources ensemble.
   • Emplacement : sélectionnez la région la plus proche de votre équipe.

5. Sélectionnez Créer un projet.

   Attendez que le projet soit créé. Lorsque la page vue d’ensemble du projet s’affiche, votre projet est prêt.

1. Répertoriez les modèles disponibles dans votre région afin de pouvoir confirmer le nom et la version du modèle :

   az cognitiveservices model list \
       --location eastus \
       --query "[?model.name=='gpt-5-mini'].{version:model.version,skus:join(',',model.skus[].name)}" \
       --output table
   

2. Déployez le modèle :

   az cognitiveservices account deployment create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --deployment-name gpt-5-mini \
       --model-name gpt-5-mini \
       --model-version "2025-08-07" \
       --model-format OpenAI \
       --sku-capacity 10 \
       --sku-name GlobalStandard
   

   Si la commande échoue avec DeploymentModelNotSupported, le modèle, la version ou la référence SKU n’est pas disponible dans votre région. Utilisez la sortie de l’étape précédente pour choisir une combinaison prise en charge.

3. Vérifiez que le déploiement a réussi :

   az cognitiveservices account deployment show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --deployment-name gpt-5-mini \
       --query properties.provisioningState --output tsv
   

   La sortie indique Succeeded quand le déploiement est prêt.

Référence : déploiement de compte az cognitiveservices

1. Sélectionnez Découvrir dans le volet supérieur droit, puis Modèles dans le volet gauche.
2. Recherchez gpt-5-mini.
3. Sélectionnez Déployer>les paramètres par défaut pour l’ajouter à votre projet.
4. Notez le nom du déploiement (par exemple, gpt-5-mini). Votre équipe a besoin de ce nom pour utiliser le modèle.

Obtenez le point de terminaison du projet :

az cognitiveservices account project show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --project-name my-foundry-project \
    --query 'properties.endpoints."AI Foundry API"' --output tsv

La sortie est votre point de terminaison de projet, sous la forme https://my-foundry-resource.services.ai.azure.com/api/projects/my-foundry-project. Utilisez cette valeur dans d’autres guides de démarrage rapide et didacticiels.

1. Connectez-vous à Microsoft Foundry à l’aide de votre compte Azure.
2. Sélectionnez votre projet.
3. Recherchez votre point de terminaison de projet sur l’écran d’accueil du projet.
4. Copiez la valeur du point de terminaison. Vous utilisez cette valeur dans d’autres guides de démarrage rapide et didacticiels.

1. Obtenez l’ID de ressource du projet :

   PROJECT_ID=$(az cognitiveservices account project show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project \
       --query id -o tsv)
   

2. Attribuez le rôle Utilisateur Foundry à un membre de l’équipe :

   Important

   Les rôles Foundry RBAC ont été récemment renommés. Foundry User, Foundry Owner, Propriétaire du compteFoundry et Foundry Project Manager ont été précédemment nommés Azure utilisateur IA, Azure propriétaire d’IA, propriétaire Azure compte IA et Azure gestionnaire Project IA. Il se peut que vous voyiez encore les anciens noms à certains endroits pendant le déploiement de ce changement de nom. Les ID de rôle et les autorisations de base ne sont pas modifiés par ce changement de nom.

   az role assignment create \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --assignee "user@contoso.com" \
       --assignee-principal-type User \
       --scope $PROJECT_ID
   

Pour ajouter un groupe de sécurité au lieu d’un utilisateur individuel :

az role assignment create \
    --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
    --assignee-object-id "<security-group-object-id>" \
    --assignee-principal-type Group \
    --scope $PROJECT_ID

1. Vérifiez l’attribution de rôle :

   az role assignment list \
       --scope $PROJECT_ID \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --output table
   

Référence : attribution de rôle AZ

1. Dans le portail Foundry, sélectionnez Gérer dans le volet de navigation supérieur droit.
2. Sélectionnez Détails du projet dans le volet de gauche.
3. Cliquez sur l’onglet Utilisateurs.
4. Sélectionnez Ajouter un utilisateur en haut à droite.
5. Entrez l’adresse e-mail du membre de l’équipe.
6. Sélectionnez Ajouter.

Répétez ces étapes pour chaque membre de l’équipe ou groupe de sécurité.

az group delete --name my-foundry-rg --yes --no-wait

La suppression s’exécute en arrière-plan. Pour vérifier que le groupe de ressources a bien été supprimé, exécutez :

az group exists --name my-foundry-rg

La sortie affiche false une fois la suppression terminée.

Dans le portail Azure, recherchez et sélectionnez votre groupe de ressources. Sélectionnez Supprimer et confirmer pour supprimer le groupe de ressources et toutes ses ressources associées.