Merge pull request #66 from aahill/ai-studio-update

AOAI studio updates

Author: denrea

articles/ai-services/openai/assistants-quickstart.md

@@ -6,9 +6,9 @@ manager: nitinme
 ms.service: azure-ai-openai
 ms.custom: devx-track-python, devx-track-dotnet, devx-track-extended-java, devx-track-js
 ms.topic: quickstart
-author: mrbullwinkle
-ms.author: mbullwin
-ms.date: 07/18/2024
+author: aahill
+ms.author: aahi
+ms.date: 09/18/2024
 zone_pivot_groups: openai-quickstart-assistants
 recommendations: false
 ---
@@ -18,15 +18,9 @@ recommendations: false
 
 Azure OpenAI Assistants (Preview) allows you to create AI assistants tailored to your needs through custom instructions and augmented by advanced tools like code interpreter, and custom functions.
 
-::: zone pivot="programming-language-studio"
-
-[!INCLUDE [Azure OpenAI Studio quickstart](includes/assistants-studio.md)]
-
-::: zone-end
-
 ::: zone pivot="programming-language-ai-studio"
 
-[!INCLUDE [AI Studio (Preview)](includes/assistants-ai-studio.md)]
+[!INCLUDE [AI Studio](includes/assistants-ai-studio.md)]
 
 ::: zone-end
 

articles/ai-services/openai/includes/assistants-ai-studio.md

@@ -22,6 +22,9 @@ author: mrbullwinkle
 
 ## Go to the Azure AI Studio (Preview)
 
+> [!NOTE]
+> While you can use [Azure OpenAI Studio](https://oai.azure.com/), we recommend using the steps here to use [Azure AI Studio](https://ai.azure.com). AI Studio lets you use Assistants v2 which provides several upgrades such as the [file search](../how-to/file-search.md) tool which is faster and supports more files.
+
 1. Sign in to [Azure AI Studio](https://ai.azure.com).
 1. Go to your project or [create a new project](../../../ai-studio//how-to/create-projects.md) in Azure AI Studio.
 1. From your project overview, select **Assistants**, located under **Project playground**.

articles/ai-services/openai/includes/connect-your-data-studio.md

@@ -21,6 +21,10 @@ Navigate to [Azure OpenAI Studio](https://oai.azure.com/) and sign-in with crede
 
     :::image type="content" source="../media/use-your-data/bring-your-data-card.png" alt-text="A screenshot of the Azure OpenAI Studio landing page." lightbox="../media/use-your-data/bring-your-data-card.png":::
 
+1. In the **Chat playground**, Select **Add your data** and then **Add a data source**
+
+    :::image type="content" source="../media/use-your-data/chat-playground.png" alt-text="A screenshot of the chat playground in  OpenAI Studio." lightbox="../media/use-your-data/chat-playground.png":::
+
 1. In the pane that appears, select **Upload files (preview)** under **Select data source**. Azure OpenAI needs both a storage resource and a search resource to access and index your data. 
 
     > [!TIP]

articles/ai-services/openai/media/quickstarts/assistant-session.png

@@ -16,33 +16,71 @@ zone_pivot_groups: openai-use-your-data
 
 # Quickstart: Chat with Azure OpenAI models using your own data
 
-::: zone pivot="programming-language-spring"
+In this quickstart, you can use your own data with Azure OpenAI models. Using Azure OpenAI's models on your data can provide you with a powerful conversational AI platform that enables faster and more accurate communication.
 
-[Source code](https://github.com/spring-projects-experimental/spring-ai)| [Source code](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/openai/openai) | [Sample](https://github.com/rd-1-2022/ai-azure-retrieval-augmented-generation)
+::: zone pivot="programming-language-studio"
 
-::: zone-end
 
-::: zone pivot="programming-language-javascript"
+## Prerequisites
 
-[Reference documentation](https://platform.openai.com/docs/api-reference/chat) | [Source code](https://github.com/openai/openai-node) | [Package (npm)](https://www.npmjs.com/package/openai) | [Samples](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/openai/openai/samples)
+The following resources: 
+- [Azure OpenAI](https://portal.azure.com/#create/Microsoft.CognitiveServicesOpenAI)
+- [Azure Blob Storage](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM)
+- [Azure AI Search](https://portal.azure.com/#create/Microsoft.Search)
+- An [Azure OpenAI resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesOpenAI) deployed in a [supported region and with a supported model](./concepts/use-your-data.md#regional-availability-and-model-support).
+    - Be sure that you're assigned at least the [Cognitive Services Contributor](./how-to/role-based-access-control.md#cognitive-services-contributor) role for the Azure OpenAI resource.
+- Download the example data from [GitHub](https://github.com/Azure-Samples/cognitive-services-sample-data-files/blob/master/openai/contoso_benefits_document_example.pdf) if you don't have your own data.
+
+> [!div class="nextstepaction"]
+> [I ran into an issue with the prerequisites.](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=OVERVIEW&Pillar=AOAI&Product=ownData&Page=quickstart&Section=Prerequisites)
+
+
+[!INCLUDE [Connect your data to OpenAI](includes/connect-your-data-studio.md)]
+
+[!INCLUDE [Studio quickstart](includes/use-your-data-studio.md)]
 
 ::: zone-end
 
-::: zone pivot="programming-language-python"
+::: zone pivot="programming-language-csharp"
 
-[Reference](https://platform.openai.com/docs/api-reference?lang=python) | [Source code](https://github.com/openai/openai-python) | [Package (pypi)](https://pypi.org/project/openai/) | [Samples](https://github.com/openai/openai-cookbook/)
+## Prerequisites
 
-These links reference the OpenAI API for Python. There's no Azure-specific OpenAI Python SDK. [Learn how to switch between the OpenAI services and Azure OpenAI services](/azure/ai-services/openai/how-to/switching-endpoints).
+The following resources: 
+- [Azure OpenAI](https://portal.azure.com/#create/Microsoft.CognitiveServicesOpenAI)
+- [Azure Blob Storage](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM)
+- [Azure AI Search](https://portal.azure.com/#create/Microsoft.Search)
+- An [Azure OpenAI resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesOpenAI) deployed in a [supported region and with a supported model](./concepts/use-your-data.md#regional-availability-and-model-support).
+    - Be sure that you're assigned at least the [Cognitive Services Contributor](./how-to/role-based-access-control.md#cognitive-services-contributor) role for the Azure OpenAI resource.
+- Download the example data from [GitHub](https://github.com/Azure-Samples/cognitive-services-sample-data-files/blob/master/openai/contoso_benefits_document_example.pdf) if you don't have your own data.
+- The [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0)
+
+[!INCLUDE [Connect your data to OpenAI](includes/connect-your-data-studio.md)]
+
+[!INCLUDE [Csharp quickstart](includes/use-your-data-dotnet.md)]
 
 ::: zone-end
 
-::: zone pivot="programming-language-go"
+::: zone pivot="programming-language-spring"
 
-[Reference](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go) | [Source code](https://github.com/Azure/azure-sdk-for-go) | [Package (Go)](https://pkg.go.dev/github.com/azure/azure-dev) | [Samples](https://github.com/azure-samples/azure-sdk-for-go-samples)
+[Source code](https://github.com/spring-projects-experimental/spring-ai)| [Source code](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/openai/openai) | [Sample](https://github.com/rd-1-2022/ai-azure-retrieval-augmented-generation)
+
+## Prerequisites
+
+The following resources: 
+- [Azure OpenAI](https://portal.azure.com/#create/Microsoft.CognitiveServicesOpenAI)
+- [Azure Blob Storage](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM)
+- [Azure AI Search](https://portal.azure.com/#create/Microsoft.Search)
+- An [Azure OpenAI resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesOpenAI) deployed in a [supported region and with a supported model](./concepts/use-your-data.md#regional-availability-and-model-support).
+    - Be sure that you're assigned at least the [Cognitive Services Contributor](./how-to/role-based-access-control.md#cognitive-services-contributor) role for the Azure OpenAI resource.
+- Download the example data from [GitHub](https://github.com/Azure-Samples/cognitive-services-sample-data-files/blob/master/openai/contoso_benefits_document_example.pdf) if you don't have your own data.
+    
+[!INCLUDE [Connect your data to OpenAI](includes/connect-your-data-studio.md)]
+
+[!INCLUDE [Spring quickstart](includes/use-your-data-spring.md)]
 
 ::: zone-end
 
-In this quickstart, you can use your own data with Azure OpenAI models. Using Azure OpenAI's models on your data can provide you with a powerful conversational AI platform that enables faster and more accurate communication.
+::: zone pivot="programming-language-javascript"
 
 ## Prerequisites
 
@@ -59,6 +97,7 @@ In this quickstart, you can use your own data with Azure OpenAI models. Using Az
 
 - Download the example data from [GitHub](https://github.com/Azure-Samples/cognitive-services-sample-data-files/blob/master/openai/contoso_benefits_document_example.pdf) if you don't have your own data.
 
+
 #### [JavaScript](#tab/javascript)
 
 - An Azure subscription - <a href="https://azure.microsoft.com/free/cognitive-services" target="_blank">Create one for free</a>.
@@ -71,64 +110,92 @@ In this quickstart, you can use your own data with Azure OpenAI models. Using Az
 
 ---
 
-::: zone pivot="programming-language-javascript"
+[Reference documentation](https://platform.openai.com/docs/api-reference/chat) | [Source code](https://github.com/openai/openai-node) | [Package (npm)](https://www.npmjs.com/package/openai) | [Samples](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/openai/openai/samples)
 
 
+[!INCLUDE [Connect your data to OpenAI](includes/connect-your-data-studio.md)]
 
-- [Long Term Support (LTS) versions of Node.js](https://github.com/nodejs/release#release-schedule)
+[!INCLUDE [JavaScript quickstart](includes/use-your-data-javascript.md)]
 
 ::: zone-end
 
-> [!div class="nextstepaction"]
-> [I ran into an issue with the prerequisites.](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=OVERVIEW&Pillar=AOAI&Product=ownData&Page=quickstart&Section=Prerequisites)
-
+::: zone pivot="programming-language-python"
 
-[!INCLUDE [Connect your data to OpenAI](includes/connect-your-data-studio.md)]
+## Prerequisites
 
-::: zone pivot="programming-language-studio"
+The following resources: 
+- [Azure OpenAI](https://portal.azure.com/#create/Microsoft.CognitiveServicesOpenAI)
+- [Azure Blob Storage](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM)
+- [Azure AI Search](https://portal.azure.com/#create/Microsoft.Search)
+- An [Azure OpenAI resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesOpenAI) deployed in a [supported region and with a supported model](./concepts/use-your-data.md#regional-availability-and-model-support).
+    - Be sure that you're assigned at least the [Cognitive Services Contributor](./how-to/role-based-access-control.md#cognitive-services-contributor) role for the Azure OpenAI resource.
+- Download the example data from [GitHub](https://github.com/Azure-Samples/cognitive-services-sample-data-files/blob/master/openai/contoso_benefits_document_example.pdf) if you don't have your own data.
 
-[!INCLUDE [Studio quickstart](includes/use-your-data-studio.md)]
+[Reference](https://platform.openai.com/docs/api-reference?lang=python) | [Source code](https://github.com/openai/openai-python) | [Package (pypi)](https://pypi.org/project/openai/) | [Samples](https://github.com/openai/openai-cookbook/)
 
-::: zone-end
+These links reference the OpenAI API for Python. There's no Azure-specific OpenAI Python SDK. [Learn how to switch between the OpenAI services and Azure OpenAI services](/azure/ai-services/openai/how-to/switching-endpoints).
 
-::: zone pivot="programming-language-csharp"
+[!INCLUDE [Connect your data to OpenAI](includes/connect-your-data-studio.md)]
 
-[!INCLUDE [Csharp quickstart](includes/use-your-data-dotnet.md)]
+[!INCLUDE [Python quickstart](includes/use-your-data-python.md)]
 
 ::: zone-end
 
-::: zone pivot="programming-language-spring"
+::: zone pivot="programming-language-powershell"
 
-[!INCLUDE [Spring quickstart](includes/use-your-data-spring.md)]
 
-::: zone-end
+## Prerequisites
 
-::: zone pivot="programming-language-javascript"
+The following resources: 
+- [Azure OpenAI](https://portal.azure.com/#create/Microsoft.CognitiveServicesOpenAI)
+- [Azure Blob Storage](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM)
+- [Azure AI Search](https://portal.azure.com/#create/Microsoft.Search)
+- An [Azure OpenAI resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesOpenAI) deployed in a [supported region and with a supported model](./concepts/use-your-data.md#regional-availability-and-model-support).
+    - Be sure that you're assigned at least the [Cognitive Services Contributor](./how-to/role-based-access-control.md#cognitive-services-contributor) role for the Azure OpenAI resource.
+- Download the example data from [GitHub](https://github.com/Azure-Samples/cognitive-services-sample-data-files/blob/master/openai/contoso_benefits_document_example.pdf) if you don't have your own data.
 
-[!INCLUDE [JavaScript quickstart](includes/use-your-data-javascript.md)]
+[!INCLUDE [Connect your data to OpenAI](includes/connect-your-data-studio.md)]
 
-::: zone-end
+[!INCLUDE [PowerShell quickstart](includes/use-your-data-powershell.md)]
 
-::: zone pivot="programming-language-python"
+::: zone-end
 
-[!INCLUDE [Python quickstart](includes/use-your-data-python.md)]
+::: zone pivot="programming-language-go"
 
-::: zone-end
 
-::: zone pivot="programming-language-powershell"
+## Prerequisites
 
-[!INCLUDE [PowerShell quickstart](includes/use-your-data-powershell.md)]
+The following resources: 
+- [Azure OpenAI](https://portal.azure.com/#create/Microsoft.CognitiveServicesOpenAI)
+- [Azure Blob Storage](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM)
+- [Azure AI Search](https://portal.azure.com/#create/Microsoft.Search)
+- An [Azure OpenAI resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesOpenAI) deployed in a [supported region and with a supported model](./concepts/use-your-data.md#regional-availability-and-model-support).
+    - Be sure that you're assigned at least the [Cognitive Services Contributor](./how-to/role-based-access-control.md#cognitive-services-contributor) role for the Azure OpenAI resource.
+- Download the example data from [GitHub](https://github.com/Azure-Samples/cognitive-services-sample-data-files/blob/master/openai/contoso_benefits_document_example.pdf) if you don't have your own data.
 
-::: zone-end
+[Reference](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go) | [Source code](https://github.com/Azure/azure-sdk-for-go) | [Package (Go)](https://pkg.go.dev/github.com/azure/azure-dev) | [Samples](https://github.com/azure-samples/azure-sdk-for-go-samples)
 
-::: zone pivot="programming-language-go"
+[!INCLUDE [Connect your data to OpenAI](includes/connect-your-data-studio.md)]
 
 [!INCLUDE [Go quickstart](includes/use-your-data-go.md)]
 
 ::: zone-end
 
 ::: zone pivot="rest-api"
 
+
+## Prerequisites
+
+The following resources: 
+- [Azure OpenAI](https://portal.azure.com/#create/Microsoft.CognitiveServicesOpenAI)
+- [Azure Blob Storage](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM)
+- [Azure AI Search](https://portal.azure.com/#create/Microsoft.Search)
+- An [Azure OpenAI resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesOpenAI) deployed in a [supported region and with a supported model](./concepts/use-your-data.md#regional-availability-and-model-support).
+    - Be sure that you're assigned at least the [Cognitive Services Contributor](./how-to/role-based-access-control.md#cognitive-services-contributor) role for the Azure OpenAI resource.
+- Download the example data from [GitHub](https://github.com/Azure-Samples/cognitive-services-sample-data-files/blob/master/openai/contoso_benefits_document_example.pdf) if you don't have your own data.
+
+[!INCLUDE [Connect your data to OpenAI](includes/connect-your-data-studio.md)]
+
 [!INCLUDE [REST API quickstart](includes/use-your-data-rest.md)]
 
 ::: zone-end