Créer un project pour Microsoft Foundry

Cet article explique comment créer un project 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 de 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 les Azure portal ou pour respecter les exigences 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.

• 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.

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

  Portail Foundry

  • 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.

  Kit de développement logiciel (SDK) Python

  • Configurer votre environnement de développement

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

  • Quick validation : avant de créer un project, vérifiez que votre Kit de développement logiciel (SDK) et votre authentification fonctionnent 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.")
    

  • Procédez comme suit pour démarrer votre script Python :

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

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

    3. 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"
       )
       

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

       DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
       

  Azure CLI

  • Installez le Azure CLI.

  • Définissez les valeurs par défaut pour subscription.

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

Créer un project Foundry

Portail Foundry

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

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.

Kit de développement logiciel (SDK) Python

Pour créer un project Foundry :

• Ajoutez le code suivant afin de créer un projet Foundry en utilisant les variables et la connexion client mentionnées dans la section Conditions préalables.

  # 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é.

En tant que ressources enfants Azure, les projets Foundry peuvent disposer de leurs propres contrôles d’accès tout en partageant avec la ressource parente des paramètres communs tels que la sécurité réseau, les déploiements et l’intégration des outils Azure.

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

  Le portail Foundry (nouveau) affiche uniquement le default project pour chaque ressource Foundry. Vous ne pouvez pas créer plusieurs projets ou afficher l’un des projets non définis dans le portail Foundry (nouveau).

  Kit de développement logiciel (SDK) Python

  Bien que ce code puisse ajouter des projets supplémentaires à une ressource, vous ne pourrez pas les afficher dans le portail Foundry (nouveau). Seul le projet par défaut d’une ressource est disponible dans le nouveau portail Foundry.
  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

  Bien que ce code puisse ajouter des projets supplémentaires à une ressource, vous ne pourrez pas les afficher dans le portail Foundry (nouveau). Seul le projet par défaut d’une ressource est disponible dans le nouveau portail Foundry. Pour ajouter un nouveau projet à my-foundry-resource :

   az cognitiveservices account project create \
   --name my-foundry-resource \
   --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.

Kit de développement logiciel (SDK) 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 connection show. Par exemple:

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

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.

Kit de développement logiciel (SDK) Python

Ce code utilise les variables et client connection à partir des prérequis. Tout d’abord, créez la connexion cliente :

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

Contenu connexe

• Démarrage rapide de Microsoft Foundry
• Qu’est-ce que Foundry ?