Rediger

Del via


Quickstart: Create a project and use the chat playground in Azure AI Studio

Important

Some of the features described in this article might only be available in 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.

In this Azure AI Studio quickstart, you create a project, deploy a chat model, and use it in the chat playground in Azure AI Studio.

The steps in this quickstart include:

  1. Create an Azure AI Studio project.
  2. Deploy an Azure OpenAI model.
  3. Chat in the playground without your data.

Prerequisites

  • An Azure subscription - Create one for free.

  • Access granted to Azure OpenAI in the desired Azure subscription.

    Currently, access to this service is granted only by application. You can apply for access to Azure OpenAI by completing the form at https://aka.ms/oai/access. Open an issue on this repo to contact us if you have an issue.

  • You need an Azure AI Studio hub or permissions to create one. Your user role must be Azure AI Developer, Contributor, or Owner on the hub. For more information, see hubs and Azure AI roles.

    • If your role is Contributor or Owner, you can create a hub in this tutorial.
    • If your role is Azure AI Developer, the hub must already be created.
  • Your subscription needs to be below your quota limit to deploy a new model in this tutorial. Otherwise you already need to have a deployed chat model.

Create a project in Azure AI Studio

Your project is used to organize your work and save state.

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

  1. Go to the Home page of Azure AI Studio.

  2. Select + New project.

  3. Enter a name for the project.

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

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

    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.

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

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

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

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

  9. Select an existing Azure AI services resource (including Azure OpenAI) 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 AI services 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 a 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 playground, tools, and other assets in the left navigation panel.

Deploy a chat model

Follow these steps to deploy an Azure OpenAI chat model for your copilot.

  1. Sign in to Azure AI Studio and go to the Home page.

  2. Go to your hub by selecting it from the list of hubs via Home > All hubs. If you don't have a hub, create one. For more information, see how to create a hub.

  3. From the left pane, select Deployments > + Create deployment.

    Screenshot of the deployments page with a button to create a new deployment.

  4. On the Select a model page, select the model you want to deploy from the list of models. For example, select gpt-35-turbo-16k. Then select Confirm.

    Screenshot of the model selection page.

  5. On the Deploy model page, enter a name for your deployment, and then select Deploy. After the deployment is created, you see the deployment details page. Details include the date you created the deployment and the created date and version of the model you deployed.

  6. On the deployment details page from the previous step, select Open in playground.

    Screenshot of the GPT chat deployment details.

For more information about deploying models, see how to deploy models.

Chat in the playground without your data

In the Azure AI Studio playground you can observe how your model responds with and without your data. In this quickstart, you test your model without your data.

To chat with your deployed GPT model in the chat playground, follow these steps:

  1. Go to your project in Azure AI Studio.

  2. Select Playgrounds > Chat from the left pane.

  3. Select your deployed chat model from the Deployment dropdown.

    Screenshot of the chat playground with the chat mode and model selected.

  4. In the System message text box, provide this prompt to guide the assistant: "You are an AI assistant that helps people find information." You can tailor the prompt for your scenario. For more information, see the prompt catalog.

  5. Optionally, add a safety system message by selecting the Add section button, then Safety system messages. Choose from the prebuilt messages, and then edit them to your needs. Screenshot of the Safety system message menu item.

  6. Select Apply changes to save your changes, and when prompted to see if you want to update the system message, select Continue.

  7. In the chat session pane, enter the following question: "How much do the TrailWalker hiking shoes cost", and then select the right arrow icon to send.

    Screenshot of the first chat question without grounding data.

  8. The assistant either replies that it doesn't know the answer or provides a generic response. For example, the assistant might say, "The price of TrailWalker hiking shoes can vary depending on the brand, model, and where you purchase them." The model doesn't have access to current product information about the TrailWalker hiking shoes.

    Screenshot of the assistant's reply without grounding data.

Next, you can add your data to the model to help it answer questions about your products. Try the Deploy an enterprise chat web app and Build and deploy a question and answer copilot with prompt flow in Azure AI Studio tutorials to learn more.