Créer un projet pour Microsoft Foundry

Utilisez cet article pour créer un projet Foundry et confirmer que votre environnement est prêt avant de commencer à créer des agents, des évaluations et des fichiers.

Cet article explique comment créer un projet Foundry dans Microsoft Foundry. Les projets vous permettent d’organiser votre travail, comme les agents, les évaluations et les fichiers, à mesure que vous générez des applications avec état et explorez de nouvelles idées.

Si votre organisation nécessite des configurations Azure personnalisées telles que des noms alternatifs, des contrôles de sécurité ou des balises de coût, vous devrez peut-être utiliser le portail Azure ou template options pour vous conformer aux exigences de Azure Policy de votre organisation.

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 projet vous-même :

  • Accès à un rôle qui vous permet de créer une ressource Foundry, telle que Propriétaire du compte Azure AI ou Propriétaire Azure AI 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 projet 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 utilisateur ou des ID de groupe de sécurité Microsoft Entra pour les membres de l’équipe qui ont besoin d’un accès.

Utilisez les onglets suivants pour sélectionner la méthode que vous souhaitez utiliser pour créer un project Foundry :

Portail Foundry

• Aucun autre prérequis n’est nécessaire lors de l’utilisation du portail.

Python

• Configurez votre environnement de développement.

• Exécutez az login ou az login --use-device-code dans votre environnement avant d'exécuter le code.

• Installer des packages : pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0. Si vous êtes dans une cellule de bloc-notes, utilisez %pip install plutôt.

• Utilisez pip show azure-mgmt-cognitiveservices pour vérifier que votre version est 13.7 ou ultérieure.

• Validation rapide : avant de créer un projet, vérifiez votre Kit de développement logiciel (SDK) et votre authentification en testant le client :

  from azure.identity import DefaultAzureCredential
  from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
  
  # Test authentication by instantiating the client
  credential = DefaultAzureCredential()
  subscription_id = "<your-subscription-id>"  # Replace with your subscription ID
  client = CognitiveServicesManagementClient(credential, subscription_id)
  print("✓ Authentication successful! Ready to create a project.")
  

• Démarrez votre script avec le code suivant pour créer la connexion et les client variables utilisées dans cet article. Cet exemple crée le projet dans la région Est des États-Unis :

  from azure.identity import DefaultAzureCredential
  from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
  
  subscription_id = 'your-subscription-id'
  resource_group_name = 'your-resource-group-name'
  foundry_resource_name = 'your-foundry-resource-name'
  foundry_project_name = 'your-foundry-project-name'
  location = 'eastus'
  
  client = CognitiveServicesManagementClient(
      credential=DefaultAzureCredential(), 
      subscription_id=subscription_id,
      api_version="2025-04-01-preview"
  )
  

• (Facultatif) Si vous avez plusieurs comptes, ajoutez l’ID de locataire de l’Microsoft Entra ID que vous souhaitez utiliser dans DefaultAzureCredential :

  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
  

Azure CLI

• Installez le Azure CLI.
• Définissez la valeur par défaut pour subscription.

# Set your default subscription
az account set --subscription "{subscription-name}"

Créer un project Foundry

Utilisez l’une des méthodes suivantes.

Portail Foundry

Ces étapes permettent de créer une ressource Azure avec des paramètres par défaut de base.

Pour créer un project Foundry, procédez comme suit :

1. Connectez-vous à Microsoft Foundry. Assurez-vous que l'interrupteur New Foundry est activé. Ces étapes font référence à Foundry (nouveau).

   

2. Le projet sur lequel vous travaillez apparaît dans le coin supérieur gauche.

3. Pour créer un projet, sélectionnez le nom du projet, puis Créer un nouveau projet.

4. Donnez un nom à votre project et sélectionnez Create project. Vous pouvez également consulter la section suivante pour connaître les options avancées.

Options avancées

1. Vous créez un project Foundry sur une ressource Foundry. Le portail crée automatiquement cette ressource lorsque vous créez le project. Sélectionnez un groupe de ressources existant à utiliser ou conservez la valeur par défaut pour créer un groupe de ressources.

   Conseil / Astuce

   Pour commencer, créez un nouveau groupe de ressources pour votre projet. Le groupe de ressources permet d’administrer conjointement le projet et l’ensemble des ressources qui lui sont associées.

2. Sélectionnez un Emplacement ou utilisez la valeur par défaut. L’emplacement est la région où les ressources project sont hébergées.

3. Cliquez sur Créer. Vous voyez la progression de la création de ressources. Le projet est créé à la fin du processus.

Python

Pour créer un project Foundry :

• Ajoutez le code suivant pour créer un projet Foundry en utilisant les variables et la connexion client de la section Prérequis.

  # Create resource
  resource = client.accounts.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      account={
          "location": location,
          "kind": "AIServices",
          "sku": {"name": "S0",},
          "identity": {"type": "SystemAssigned"},
          "properties": {
              "allowProjectManagement": True,
              "customSubDomainName": foundry_resource_name
          }
      }
  )
  
  # Wait for the resource creation to complete
  resource_result = resource.result()
  
  # Create default project
  project = client.projects.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      project_name=foundry_project_name,
      project={
          "location": location,
          "identity": {
              "type": "SystemAssigned"
          },
          "properties": {}
      }
  )
  

  Références : CognitiveServicesManagementClient.

Azure CLI

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

Créer plusieurs projets sur la même ressource

Créez plusieurs projets Foundry sur une ressource Foundry existante pour permettre la collaboration d’équipe et les ressources partagées access notamment la sécurité, les déploiements et les outils connectés. Cette configuration est idéale dans les abonnements restreints Azure où les développeurs ont besoin d’une capacité d’exploration libre-service dans la configuration d’un environnement préconfiguré.

Les projets Foundry en tant que ressources enfant d'Azure peuvent avoir leurs propres contrôles d'accès, mais partagent des paramètres communs tels que la sécurité réseau, les déploiements Azure et l'intégration des outils Azure issus de leur ressource parente.

Bien que toutes les fonctionnalités Foundry ne prennent pas encore en charge l'organisation du travail dans les projets, la première project « par défaut » de votre ressource est plus puissante. Vous pouvez l’identifier par la balise « par défaut » dans les expériences d’expérience utilisateur et la propriété de ressource « is_default » lors de l’utilisation des options de code.

Caractéristique	Project par défaut	Autres projets
Inférence du modèle	✅	✅
Terrains de jeu	✅	✅
Agents	✅	✅
Evaluations	✅	✅
Traçage	✅	✅
Datasets	✅	✅
Indexes	✅	✅
Kit de développement logiciel (SDK) et API Foundry	✅	✅
Compréhension du contenu	✅	✅
Kit de développement logiciel (SDK) openAI et API	✅	Réponses, fichiers, conversations
OpenAI Batch, réglage précis, achèvements stockés	✅	-
Réglage précis de la langue	✅	✅
Réglage précis de la reconnaissance vocale	✅	-
Connections	✅	✅

• Pour ajouter un project à une ressource Foundry :

  Portail Foundry

  1. Sélectionnez Utiliser dans le volet de navigation supérieur droit.
  2. Sélectionnez Administrateur dans le volet gauche.
  3. Sélectionnez la ressource parente à laquelle vous souhaitez ajouter un projet.
  4. Sélectionnez Ajouter un projet.

  Python

  Ajoutez ce code à votre script pour créer une nouvelle project sur votre ressource existante :

  # Create additional project
  new_project_name = 'your-new-project-name'
  
  project = client.projects.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      project_name=new_project_name,
      project={
          "location": location,
          "identity": {
              "type": "SystemAssigned"
          },
          "properties": {}
      }
  )
  

  Azure CLI

  Pour ajouter un nouveau projet à my-foundry-resource :

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

• Si vous supprimez la project par défaut de votre ressource Foundry, la prochaine project créée devient la project par défaut.

Afficher les paramètres de project

Portail Foundry

Dans la page de projet Home, vous voyez le point de terminaison du projet et la clé API pour le projet. Vous n'avez pas besoin de la clé API si vous utilisez l'authentification Microsoft Entra ID.

Python

# Get project
project = client.projects.get(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=foundry_project_name
)
print(project)

Références : CognitiveServicesManagementClient.

Azure CLI

Pour afficher les paramètres du project, utilisez la commande az cognitiveservices account project show. Par exemple:

az cognitiveservices account project show \
--name my-foundry-resource \
--resource-group my-foundry-rg \
--project-name my-foundry-project

Accorder l’accès aux membres de l’équipe

Si vous avez créé le projet pour une équipe, attribuez le rôle Azure utilisateur IA aux membres de l’équipe afin qu’ils puissent utiliser le projet et ses ressources. 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 en fonction du rôle pour Microsoft Foundry.

Important

Pour terminer les attributions de rôles, vous avez besoin d’un rôle tel que Propriétaire sur le projet. Pour plus d'informations, consultez le contrôle d'accès basé sur les rôles pour Microsoft Foundry.

Portail Foundry

1. Dans le portail Foundry, sélectionnez Opérer dans le menu de navigation en haut à droite.
2. Sélectionnez Administrateur dans le volet gauche.
3. Sélectionnez le nom de votre projet dans la table.
4. Sélectionnez Ajouter un utilisateur en haut à droite.
5. Entrez l’adresse e-mail du membre de l’équipe.
6. Cliquez sur Ajouter.

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

Conseil / Astuce

Pour ajouter plusieurs utilisateurs à la fois, utilisez un groupe de sécurité Microsoft Entra au lieu d’adresses e-mail individuelles.

Python

Utilisez le portail Azure CLI ou Foundry pour gérer les attributions de rôles. Le sdk Python ne prend pas en charge les opérations d'attribution de rôle.

Azure CLI

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 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 Azure

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

Demandez à un membre de l’équipe de vérifier son accès en vous connectant à Microsoft Foundry et en sélectionnant le projet dans la liste des projets.

Si le membre de l’équipe ne peut pas accéder au projet, vérifiez que l’attribution de rôle s’est terminé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.

Supprimer des projets.

Portail Foundry

1. Connectez-vous à Microsoft Foundry. Assurez-vous que l'interrupteur New Foundry est activé. Ces étapes font référence à Foundry (nouveau).
2. Dans le volet de navigation en haut à droite, sélectionnez Utiliser.
3. Dans le volet gauche, sélectionnez Administrateur.
4. Sélectionnez votre project.
5. En haut à droite, sélectionnez l’icône de corbeille pour supprimer le project.

Python

Ce code utilise les variables ainsi que la connexion client issues des prérequis. Pour supprimer un projet unique :

client.projects.begin_delete(
    resource_group_name, foundry_resource_name, foundry_project_name
)

Références : CognitiveServicesManagementClient.

Supprimez une ressource Foundry et tous ses projets :

# Delete projects
projects = client.projects.list(resource_group_name, foundry_resource_name)

for project in projects: 
    print("Deleting project:", project.name)
    client.projects.begin_delete(resource_group_name, foundry_resource_name,
        project_name=project.name.split('/')[-1]
    ).wait()

# Delete resource
print("Deleting resource:", foundry_resource_name)
client.accounts.begin_delete(resource_group_name, foundry_resource_name).wait()

Références : CognitiveServicesManagementClient.

Azure CLI

Exécutez la commande suivante:

az cognitiveservices account project delete \
--name my-foundry-resource \
--resource-group my-foundry-rg \
--project-name my-foundry-project

Références : az cognitiveservices account project delete.

Important

À utiliser avec précaution. Vous ne pouvez pas récupérer une project après sa suppression.

Créer votre première connexion

Contenu connexe

• démarrage rapide Microsoft Foundry
• Qu’est-ce que Foundry ?
• Créer des ressources à l’aide d’un modèle Bicep