Edit

Create an Azure AI project in Azure AI Studio

  • Article

Note

Azure AI Studio is currently in public preview. This preview is provided without a service-level agreement, and we don't recommend it for production workloads. Certain features might not be supported or might have constrained capabilities. For more information, see Supplemental Terms of Use for Microsoft Azure Previews.

This article describes how to create an Azure AI project in Azure AI Studio. A project is used to organize your work and save state while building customized AI apps.

Projects are hosted by an Azure AI hub resource that provides enterprise-grade security and a collaborative environment. For more information about the Azure AI projects and resources model, see Azure AI hub resources.

Create a project

To create an Azure AI project in Azure AI Studio, follow these steps:

  1. Select the Build tab at the top of the page.

  2. Select + New AI project.

    Screenshot of the Build tab of the Azure AI Studio with the option to create a new project visible.

  3. Enter a name for the project.

  4. Select an Azure AI hub resource from the dropdown to host your project. If you don't have access to an Azure AI hub resource yet, select Create a new resource.

    Screenshot of the project details page within the create project dialog.

    Note

    To create an Azure AI hub resource, you must have Owner or Contributor permissions on the selected resource group. It's recommended to share an Azure AI hub resource with your team. This lets you share configurations like data connections with all projects, and centrally manage security settings and spend.

  5. If you're creating a new Azure AI hub resource, enter a name.

  6. Select your Azure subscription from the 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.

  7. 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 an Azure AI hub resource, a container registry, and a storage account.

  8. Enter the Location for the Azure AI hub resource and then select Next. The location is the region where the Azure AI hub resource is hosted. The location of the Azure AI hub resource 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.

  9. Select an existing Azure OpenAI resource from the dropdown or create a new one.

    Screenshot of the create resource page within the create project dialog.

  10. On the Review and finish page, you see the Azure OpenAI Service resource name and other settings to review.

    Screenshot of the review and finish page within the create project dialog.

  11. Review the project details and then select Create an AI project. You see progress of resource creation and the project is created when the process is complete.

    Screenshot of the resource creation progress within the create project dialog.

Once a project is created, you can access the Tools, Components, and AI project settings assets in the left navigation panel. For a project that uses an Azure AI hub with support for Azure OpenAI, you see the Playground navigation option under Tools.

Project details

In the project details page (select Build > AI project settings), you can find information about the project, such as the project name, description, and the Azure AI hub resource that hosts the project. You can also find the project ID, which is used to identify the project in the Azure AI Studio API.

  • Name: The name of the project corresponds to the selected project in the left panel.
  • AI hub: The Azure AI hub resource that hosts the project.
  • Location: The location of the Azure AI hub resource that hosts the project. For supported locations, see Azure AI Studio regions.
  • Subscription: The subscription that hosts the Azure AI hub resource that hosts the project.
  • Resource group: The resource group that hosts the Azure AI hub resource that hosts the project.
  • Permissions: The users that have access to the project. For more information, see Role-based access control in Azure AI Studio.

Select View in the Azure portal to navigate to the project resources in the Azure portal.

Next steps