Partager via


Démarrage rapide : Configurer les ressources Microsoft Foundry

Dans ce guide de démarrage rapide, vous allez créer un Microsoft Foundry project et déployer un modèle. Si vous gérez une équipe, vous accordez également access aux membres de l'équipe. Une fois ces étapes effectuées, vous ou votre équipe pouvez commencer à créer des applications IA à l’aide du modèle déployé.

Conseil / Astuce

Ce guide de démarrage rapide vous montre comment créer des ressources pour créer un agent avec une configuration de base. Pour des scénarios plus avancés qui utilisent vos propres ressources, consultez Configurer votre environnement pour le développement d’agents.

Prerequisites

  • Un compte Azure avec un abonnement actif. Si vous n'en avez pas, créez un compte Azure gratuit, qui inclut un abonnement d'essai gratuit.
  • Si vous créez le project vous-même :
    • Accès à un rôle qui vous permet de créer une ressource Foundry, telle que Propriétaire de l'IA du compte Azure ou Propriétaire de l'IA Azure sur l’abonnement ou le groupe de ressources. Pour plus d'informations sur les autorisations, consultez Contrôle d'accès basé sur les rôles pour Microsoft Foundry.
  • Si vous créez le project pour une équipe :
    • Accès à un rôle qui vous permet d’effectuer des attributions de rôles, telles que Propriétaire. Pour plus d'informations sur les autorisations, consultez Contrôle d'accès basé sur les rôles pour Microsoft Foundry.
    • Liste des adresses e-mail des utilisateurs ou ID de groupe de sécurité Microsoft Entra pour les membres de l’équipe qui ont besoin d'accès.

Sélectionnez votre méthode préférée à l’aide des onglets suivants :

  • Installez le Azure CLI version 2.67.0 ou ultérieure (vérifiez avec az version).

  • Connectez-vous à Azure :

    az login
    

Créer un project

Créez un project Foundry pour organiser votre travail. Le project contient des modèles, des agents et d’autres ressources que votre équipe utilise.

  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
    
  2. Créez la ressource Foundry. 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 \
       --allow-project-management
    

    L’indicateur --allow-project-management active la création de projets dans cette ressource.

  3. Créez un sous-domaine personnalisé pour la ressource. Le nom custom domain doit être globalement unique. Si my-foundry-resource est pris, essayez un nom plus original.

    az cognitiveservices account update \
        --name my-foundry-resource \
        --resource-group my-foundry-rg \
        --custom-domain my-foundry-resource
    
  4. Créez le project. Par exemple, créez my-foundry-project dans le my-foundry-resource :

    az cognitiveservices account project create \
        --name my-foundry-resource \
        --resource-group my-foundry-rg \
        --project-name my-foundry-project \
        --location eastus
    
  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
    

    La sortie affiche les propriétés du projet, y compris son ID de ressource.

Référence : compte az cognitiveservices

Déployer un modèle

Déployez un modèle que vous pouvez utiliser. Cet exemple utilise gpt-4.1-mini, mais vous pouvez choisir n’importe quel modèle disponible.

az cognitiveservices account deployment create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-4.1-mini \
    --model-name gpt-4.1-mini \
    --model-version "2025-04-14" \
    --model-format OpenAI \
    --sku-capacity 10 \
    --sku-name Standard

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-4.1-mini

Lorsque le déploiement est prêt, la sortie s’affiche "provisioningState": "Succeeded".

Référence : az cognitiveservices account deployment

Obtenez les détails de connexion de votre projet

Vous avez besoin de votre point de terminaison du projet pour établir une connexion à partir du code. Si vous gérez ce projet pour d'autres personnes, envoyez-leur ce point de terminaison accompagné du nom du déploiement.

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

Pour les administrateurs : accorder access

Si vous administrez une équipe, attribuez le rôle Azure AI User aux membres de l'équipe afin qu'ils puissent utiliser le projet et les modèles déployés. Ce rôle fournit les autorisations minimales nécessaires pour générer et tester des applications IA. Pour les autres rôles que vous devrez peut-être attribuer, consultez Contrôle d'accès basé sur le rôle pour Microsoft Foundry

  1. Obtenez l'ID de ressource du project :

    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 Azure IA à un membre de l’équipe :

    az role assignment create \
        --role "Azure AI User" \
        --assignee "user@contoso.com" \
        --scope $PROJECT_ID
    

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

    az role assignment create \
        --role "Azure AI User" \
        --assignee-object-id "<security-group-object-id>" \
        --assignee-principal-type Group \
        --scope $PROJECT_ID
    
  3. Vérifiez l’attribution de rôle :

    az role assignment list \
        --scope $PROJECT_ID \
        --role "Azure AI User" \
        --output table
    

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

Vérifier l'accès des membres de l’équipe

Demandez à un membre de l’équipe de vérifier son accès en se connectant à Microsoft Foundry, en sélectionnant le projet dans la liste des projets, et en confirmant que le modèle déployé apparaît dans Build>Models.

Si le membre de l'équipe ne peut pas accéder au projet, vérifiez que l'attribution de rôle s'est effectuée correctement. Vérifiez que vous avez utilisé l’adresse e-mail correcte ou l’ID de groupe de sécurité. Vérifiez que le compte Azure du membre de l'équipe se trouve dans le même locataire Microsoft Entra.

Nettoyer les ressources

Lorsque vous ne souhaitez plus conserver ce projet, supprimez le groupe de ressources pour supprimer toutes les ressources associées.

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

Étape suivante