Meai conversion (#43405)

* Update quickstart to use the Microsoft Extensions AI library

Co-authored-by: Genevieve Warren <[email protected]>

---------

Co-authored-by: Genevieve Warren <[email protected]>

Author: alexwolfmsft

docs/ai/quickstarts/get-started-openai.md

@@ -48,7 +48,7 @@ Get started with OpenAI and [Semantic Kernel](../semantic-kernel-dotnet-overview
 
 1. To provision an Azure OpenAI service and model using the Azure CLI, complete the steps in the [Create and deploy an Azure OpenAI Service resource](/azure/ai-services/openai/how-to/create-resource?pivots=cli) article.
 
-1. From a terminal or command prompt, navigate to the `src\quickstarts\azure-openai\02-HikerAI` directory.
+1. From a terminal or command prompt, navigate to the `src\quickstarts\azure-openai\semantic-kernel\02-HikerAI` directory.
 
 1. Run the following commands to configure your OpenAI API key as a secret for the sample app:
 
@@ -60,7 +60,7 @@ Get started with OpenAI and [Semantic Kernel](../semantic-kernel-dotnet-overview
 
 1. To provision an Azure OpenAI service and model using the Azure portal, complete the steps in the [Create and deploy an Azure OpenAI Service resource](/azure/ai-services/openai/how-to/create-resource?pivots=web-portal) article.
 
-1. From a terminal or command prompt, navigate to the `src\quickstarts\azure-openai\02-HikerAI` directory.
+1. From a terminal or command prompt, navigate to the `src\quickstarts\azure-openai\semantic-kernel\02-HikerAI` directory.
 
 1. Run the following commands to configure your OpenAI API key as a secret for the sample app:
 
@@ -77,7 +77,7 @@ Get started with OpenAI and [Semantic Kernel](../semantic-kernel-dotnet-overview
 <!-- markdownlint-disable MD029 MD044 -->
 :::zone target="docs" pivot="openai"
 
-1. From a terminal or command prompt, navigate to the `openai\02-HikerAI` directory.
+1. From a terminal or command prompt, navigate to the `src\quickstarts\azure-openai\semantic-kernel\02-HikerAI` directory.
 
 1. Run the following commands to configure your OpenAI API key as a secret for the sample app:
 
@@ -96,7 +96,7 @@ Get started with OpenAI and [Semantic Kernel](../semantic-kernel-dotnet-overview
 
 :::zone target="docs" pivot="azure-openai"
 
-1. From a terminal or command prompt, navigate to the `azure-openai\02-HikerAI` directory.
+1. From a terminal or command prompt, navigate to the `semantic-kernel\02-HikerAI` directory.
 
 2. Use the `dotnet run` command to run the app:
 
@@ -147,14 +147,13 @@ The entire application is contained within the **Program.cs** file. The first se
 var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
 string endpoint = config["AZURE_OPENAI_ENDPOINT"];
 string deployment = config["AZURE_OPENAI_GPT_NAME"];
-string key = config["AZURE_OPENAI_KEY"];
 ```
 
 The `AzureOpenAIChatCompletionService` service facilitates the requests and responses.
 
 ```csharp
 // Create the Azure OpenAI Chat Completion Service
-AzureOpenAIChatCompletionService service = new(deployment, endpoint, key);
+AzureOpenAIChatCompletionService service = new(deployment, endpoint, new DefaultAzureCredential());
 ```
 
 :::zone-end

docs/ai/quickstarts/includes/clone-sample-repo.md

@@ -5,7 +5,9 @@ ms.date: 07/03/2024
 ms.topic: include
 ---
 
-Clone the GitHub repository that contains the sample apps for all of the quickstarts:
+## Clone the sample repository
+
+ You can create your own app and follow along the steps in the sections ahead, or you can clone the GitHub repository that contains the completed sample apps for all of the quickstarts. The sample repo is also structured as an Azure Developer CLI template that can provision an Azure OpenAI resource for you.
 
 ```bash
 git clone https://github.com/dotnet/ai-samples.git

docs/ai/quickstarts/includes/create-ai-service.md

@@ -0,0 +1,35 @@
+## Create the AI service
+
+# [Azure Developer CLI](#tab/azd)
+
+[!INCLUDE [deploy-azd](deploy-azd.md)]
+
+# [Azure CLI](#tab/azure-cli)
+
+1. To provision an Azure OpenAI service and model using the Azure CLI, complete the steps in the [Create and deploy an Azure OpenAI Service resource](/azure/ai-services/openai/how-to/create-resource?pivots=cli) article.
+
+1. From a terminal or command prompt, navigate to the root of your project directory.
+
+1. Run the following commands to configure your OpenAI API key as a secret for the sample app:
+
+    ```bash
+    dotnet user-secrets init
+    dotnet user-secrets set AZURE_OPENAI_ENDPOINT <your-azure-openai-endpoint>
+    dotnet user-secrets set AZURE_OPENAI_GPT_NAME <your-azure-openai-model-name>
+    ```
+
+# [Azure Portal](#tab/azure-portal)
+
+1. To provision an Azure OpenAI service and model using the Azure portal, complete the steps in the [Create and deploy an Azure OpenAI Service resource](/azure/ai-services/openai/how-to/create-resource?pivots=web-portal) article.
+
+1. From a terminal or command prompt, navigate to the root of your project directory.
+
+1. Run the following commands to configure your OpenAI API key as a secret for the sample app:
+
+    ```bash
+    dotnet user-secrets init
+    dotnet user-secrets set AZURE_OPENAI_ENDPOINT <your-openai-key>
+    dotnet user-secrets set AZURE_OPENAI_GPT_NAME <your-azure-openai-model-name>
+    ```
+
+---

docs/ai/quickstarts/includes/deploy-azd.md

@@ -7,14 +7,11 @@ ms.topic: include
 
 The sample GitHub repository is structured as an Azure Developer CLI (`azd`) template, which `azd` can use to provision the Azure OpenAI service and model for you.
 
-1. From a terminal or command prompt, navigate to the _src\quickstarts\azure-openai_ directory of the sample repo.
+1. From a terminal or command prompt, navigate to the `src\quickstarts\azure-openai` directory of the sample repo.
 1. Run the `azd up` command to provision the Azure OpenAI resources. It might take several minutes to create the Azure OpenAI service and deploy the model.
 
    ```azdeveloper
    azd up
    ```
 
-   `azd` also configures the required user secrets for the sample app, such as the OpenAI access key.
-
-   > [!NOTE]
-   > If you encounter an error during the `azd up` deployment, visit the [troubleshooting](#troubleshoot) section.
+   `azd` also configures the required user secrets for the sample app, such as the Azure OpenAI endpoint and model name.

docs/ai/quickstarts/includes/prerequisites-azure-openai.md

@@ -9,6 +9,5 @@ ms.topic: include
 
 - .NET 8 SDK - [Install the .NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0).
 - An Azure subscription - [Create one for free](https://azure.microsoft.com/free).
-- Azure Developer CLI - [Install or update the Azure Developer CLI](/azure/developer/azure-developer-cli/install-azd).
 - Access to [Azure OpenAI service](/azure/ai-services/openai/overview#how-do-i-get-access-to-azure-openai).
-- On Windows, PowerShell `v7+` is required. To validate your version, run `pwsh` in a terminal. It should return the current version. If it returns an error, execute the following command: `dotnet tool update --global PowerShell`.
+- Azure Developer CLI (Optional) - [Install or update the Azure Developer CLI](/azure/developer/azure-developer-cli/install-azd).

docs/ai/quickstarts/quickstart-ai-chat-with-data.md

@@ -46,7 +46,7 @@ Get started with AI development using a .NET 8 console app to connect to an Open
 
 1. To provision an Azure OpenAI service and model using the Azure CLI, complete the steps in the [Create and deploy an Azure OpenAI Service resource](/azure/ai-services/openai/how-to/create-resource?pivots=cli) article.
 
-1. From a terminal or command prompt, navigate to the  `src\quickstarts\azure-openai\03-ChattingAboutMyHikes` directory.
+1. From a terminal or command prompt, navigate to the  `src\quickstarts\azure-openai\semantic-kernel\03-ChattingAboutMyHikes` directory.
 
 1. Run the following commands to configure your OpenAI API key as a secret for the sample app:
 
@@ -58,7 +58,7 @@ Get started with AI development using a .NET 8 console app to connect to an Open
 
 1. To provision an Azure OpenAI service and model using the Azure portal, complete the steps in the [Create and deploy an Azure OpenAI Service resource](/azure/ai-services/openai/how-to/create-resource?pivots=web-portal) article.
 
-1. From a terminal or command prompt, navigate to the  `src\quickstarts\azure-openai\03-ChattingAboutMyHikes` directory.
+1. From a terminal or command prompt, navigate to the  `src\quickstarts\azure-openai\semantic-kernel\03-ChattingAboutMyHikes` directory.
 
 1. Run the following commands to configure your OpenAI API key as a secret for the sample app:
 
@@ -75,7 +75,7 @@ Get started with AI development using a .NET 8 console app to connect to an Open
 <!-- markdownlint-disable MD029 MD044 -->
 :::zone target="docs" pivot="openai"
 
-1. From a terminal or command prompt, navigate to the `openai\03-ChattingAboutMyHikes` directory.
+1. From a terminal or command prompt, navigate to the `src\quickstarts\openai\semantic-kernel\03-ChattingAboutMyHikes` directory.
 
 1. Run the following commands to configure your OpenAI API key as a secret for the sample app:
 
@@ -94,7 +94,7 @@ Get started with AI development using a .NET 8 console app to connect to an Open
 
 :::zone target="docs" pivot="azure-openai"
 
-1. From a terminal or command prompt, navigate to the `azure-openai\02-HikerAI` directory.
+1. From a terminal or command prompt, navigate to the `semantic-kernel\02-HikerAI` directory.
 
 2. Use the `dotnet run` command to run the app:
 
@@ -145,14 +145,13 @@ The entire application is contained within the **Program.cs** file. The first se
 var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
 string endpoint = config["AZURE_OPENAI_ENDPOINT"];
 string deployment = config["AZURE_OPENAI_GPT_NAME"];
-string key = config["AZURE_OPENAI_KEY"];
 ```
 
 The `AzureOpenAIChatCompletionService` service facilitates the requests and responses.
 
 ```csharp
 // == Create the Azure OpenAI Chat Completion Service  ==========
-AzureOpenAIChatCompletionService service = new(deployment, endpoint, key);
+AzureOpenAIChatCompletionService service = new(deployment, endpoint, new DefaultAzureCredential());
 ```
 
 Once the `OpenAIChatCompletionService` client is created, the app reads the content of the file `hikes.md` and uses it to provide more context to the model by adding a system prompt. This influences model behavior and the generated completions during the conversation.

docs/ai/quickstarts/quickstart-azure-openai-tool.md

@@ -48,7 +48,7 @@ Get started with AI by creating a simple .NET 8 console chat application. The ap
 
 1. To provision an Azure OpenAI service and model using the Azure CLI, complete the steps in the [Create and deploy an Azure OpenAI Service resource](/azure/ai-services/openai/how-to/create-resource?pivots=cli) article.
 
-1. From a terminal or command prompt, navigate to the `src\quickstarts\azure-openai\04-HikerAIPro` directory.
+1. From a terminal or command prompt, navigate to the `src\quickstarts\azure-openai\semantic-kernel\04-HikerAIPro` directory.
 
 1. Run the following commands to configure your OpenAI API key as a secret for the sample app:
 
@@ -60,7 +60,7 @@ Get started with AI by creating a simple .NET 8 console chat application. The ap
 
 1. To provision an Azure OpenAI service and model using the Azure portal, complete the steps in the [Create and deploy an Azure OpenAI Service resource](/azure/ai-services/openai/how-to/create-resource?pivots=web-portal) article.
 
-1. From a terminal or command prompt, navigate to the `src\quickstarts\azure-openai\04-HikerAIPro` directory.
+1. From a terminal or command prompt, navigate to the `src\quickstarts\azure-openai\semantic-kernel\04-HikerAIPro` directory.
 
 1. Run the following commands to configure your OpenAI API key as a secret for the sample app:
 
@@ -77,7 +77,7 @@ Get started with AI by creating a simple .NET 8 console chat application. The ap
 <!-- markdownlint-disable MD029 MD044 -->
 :::zone target="docs" pivot="openai"
 
-1. From a terminal or command prompt, navigate to the `azure-openai\04-HikerAIPro` directory.
+1. From a terminal or command prompt, navigate to the `src\quickstarts\openai\semantic-kernel\04-HikerAIPro` directory.
 
 1. Run the following commands to configure your OpenAI API key as a secret for the sample app:
 
@@ -96,7 +96,7 @@ Get started with AI by creating a simple .NET 8 console chat application. The ap
 
 :::zone target="docs" pivot="azure-openai"
 
-1. From a terminal or command prompt, navigate to the `azure-openai\04-HikerAIPro` directory.
+1. From a terminal or command prompt, navigate to the `semantic-kernel\04-HikerAIPro` directory.
 
 2. Use the `dotnet run` command to run the app:
 
@@ -149,7 +149,6 @@ The entire application is contained within the **Program.cs** file. The first se
 var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
 string endpoint = config["AZURE_OPENAI_ENDPOINT"];
 string deployment = config["AZURE_OPENAI_GPT_NAME"];
-string key = config["AZURE_OPENAI_KEY"];
 ```
 
 The `Kernel` class facilitates the requests and responses with the help of `AzureOpenAIChatCompletion` service.
@@ -159,7 +158,7 @@ The `Kernel` class facilitates the requests and responses with the help of `Azur
 IKernelBuilder b = Kernel.CreateBuilder();
 
 Kernel kernel = b
-    .AddAzureOpenAIChatCompletion(deployment, endpoint, key)
+    .AddAzureOpenAIChatCompletion(deployment, endpoint, new DefaultAzureCredential())
     .Build();
 ```
 

docs/ai/quickstarts/quickstart-openai-generate-images.md

@@ -44,7 +44,7 @@ Get started with AI by creating a simple .NET 8 console chat application. The ap
 
 1. To provision an Azure OpenAI service and model using the Azure CLI, complete the steps in the [Create and deploy an Azure OpenAI Service resource](/azure/ai-services/openai/how-to/create-resource?pivots=cli) article.
 
-1. From a terminal or command prompt, navigate to the `src\quickstarts\azure-openai\05-HikeImages` directory.
+1. From a terminal or command prompt, navigate to the `src\quickstarts\azure-openai\semantic-kernel\05-HikeImages` directory.
 
 1. Run the following commands to configure your OpenAI API key as a secret for the sample app:
 
@@ -56,7 +56,7 @@ Get started with AI by creating a simple .NET 8 console chat application. The ap
 
 1. To provision an Azure OpenAI service and model using the Azure portal, complete the steps in the [Create and deploy an Azure OpenAI Service resource](/azure/ai-services/openai/how-to/create-resource?pivots=web-portal) article.
 
-1. From a terminal or command prompt, navigate to the `src\quickstarts\azure-openai\05-HikeImages` directory.
+1. From a terminal or command prompt, navigate to the `src\quickstarts\azure-openai\semantic-kernel\05-HikeImages` directory.
 
 1. Run the following commands to configure your OpenAI API key as a secret for the sample app:
 
@@ -91,7 +91,7 @@ Get started with AI by creating a simple .NET 8 console chat application. The ap
 
 :::zone target="docs" pivot="azure-openai"
 
-1. From a terminal or command prompt, navigate to the `azure-openai\05-HikeImages` directory.
+1. From a terminal or command prompt, navigate to the `azure-openai\semantic-kernel\05-HikeImages` directory.
 
 2. Use the `dotnet run` command to run the app:
 
@@ -136,13 +136,12 @@ The _Program.cs_ file contains all of the app code. The first several lines of c
 var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
 string endpoint = config["AZURE_OPENAI_ENDPOINT"];
 string deployment = config["AZURE_OPENAI_GPT_NAME"];
-string key = config["AZURE_OPENAI_KEY"];
 ```
 
 The `AzureOpenAITextToImageService` service facilitates the requests and responses.
 
 ```csharp
-AzureOpenAITextToImageService textToImageService = new(deployment, endpoint, key, null);
+AzureOpenAITextToImageService textToImageService = new(deployment, endpoint, new DefaultAzureCredential(), null);
 ```
 
 :::zone-end