Create a project in Azure AI Studio
This article describes how to create an Azure AI Studio project. A project is used to organize your work and save state while building customized AI apps.
Projects are hosted by an Azure AI Studio hub that provides enterprise-grade security and a collaborative environment. For more information about the projects and resources model, see Azure AI Studio hubs.
Create a project
Use the following tabs to select the method you plan to use to create a project:
To create a project in Azure AI Studio, follow these steps:
Go to the Home page of Azure AI Studio.
Select + New project.
Enter a name for the project.
Select a hub from the dropdown to host your project. For information about the relationship between hubs and projects, see the hubs and projects overview documentation. If you don't yet have a hub, select Create a new hub.
Note
To create a hub, you must have Owner or Contributor permissions on the selected resource group. It's recommended to share a hub with your team. This lets you share configurations like data connections with all projects, and centrally manage security settings and spend. For more options to create a hub, see how to create and manage an Azure AI Studio hub. A project name must be unique between projects that share the same hub.
If you're creating a new hub, enter a name.
Select your Azure subscription from the Subscription dropdown. Choose a specific Azure subscription for your project for billing, access, or administrative reasons. For example, this grants users and service principals with subscription-level access to your project.
Leave the Resource group as the default to create a new resource group. Alternatively, you can select an existing resource group from the dropdown.
Tip
Especially for getting started it's recommended to create a new resource group for your project. This allows you to easily manage the project and all of its resources together. When you create a project, several resources are created in the resource group, including a hub, a container registry, and a storage account.
Enter the Location for the hub and then select Next. The location is the region where the hub is hosted. The location of the hub is also the location of the project. Azure AI services availability differs per region. For example, certain models might not be available in certain regions.
Select an existing Azure AI services resource (including Azure OpenAI) from the dropdown or create a new one.
On the Review and finish page, you see the Azure AI services resource name and other settings to review.
Review the project details and then select Create a project. You see progress of resource creation and the project is created when the process is complete.
Once a project is created, you can access the playground, tools, and other assets in the left navigation panel.
Project settings
On the project Settings page you can find information about the project, such as the project name, description, and the hub that hosts the project. You can also find the project ID, which is used to identify the project via SDK or API.
- Name: The name of the project corresponds to the selected project in the left panel.
- Hub: The hub that hosts the project.
- Location: The location of the hub that hosts the project. For supported locations, see Azure AI Studio regions.
- Subscription: The subscription that hosts the hub that hosts the project.
- Resource group: The resource group that hosts the hub that hosts the project.
Select Manage in the Azure portal to navigate to the project resources in the Azure portal.
Project resource access
Common configurations on the hub are shared with your project, including connections, compute instances, and network access, so you can start developing right away.
In addition, a number of resources are only accessible by users in your project workspace:
Components including datasets, flows, indexes, deployed model API endpoints (open and serverless).
Connections created by you under 'project settings'.
Azure Storage blob containers, and a fileshare for data upload within your project. Access storage using the following connections:
Data connection Storage location Purpose workspaceblobstore {project-GUID}-blobstore Default container for data upload workspaceartifactstore {project-GUID}-blobstore Stores components and metadata for your project such as model weights workspacefilestore {project-GUID}-code Hosts files created on your compute and using prompt flow
Note
Storage connections are not created directly with the project when your storage account has public network access set to disabled. These are created instead when a first user accesses AI Studio over a private network connection. Troubleshoot storage connections