Skip to content

Commit ccf23f3

Browse files
committed
updates
1 parent 9d42830 commit ccf23f3

File tree

1 file changed

+11
-8
lines changed

1 file changed

+11
-8
lines changed

docs/ai/quickstarts/quickstart-openai-summarize-text.md

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ zone_pivot_groups: dotnet-ai-library
1414

1515
:::zone target="docs" pivot="microsoft-extensions-ai"
1616

17-
Get started with AI by creating a simple .NET 8.0 console chat app to summarize text. You'll learn how to use the `Microsoft.Extensions.AI` library to connect to an AI model from a local application. This library provides essential abstractions for integrating AI services into .NET applications and libraries.
17+
In this quickstart, get started with AI by creating a .NET console chat app to connect to and prompt an OpenAI or Azure OpenAI model. The app uses abstractions from the [`Microsoft.Extensions.AI`](https://www.nuget.org/packages/Microsoft.Extensions.AI) library that allow you to easily update the underlying AI model without requiring changes to your app logic.
1818

1919
## Prerequisites
2020

@@ -58,8 +58,8 @@ The sample project includes completed apps you can run to connect to your AI mod
5858
1. From a terminal or command prompt, navigate to the `src\quickstarts\microsoft-extensions-ai\azure-openai\01-HikeBenefitsSummary` directory.
5959

6060
> [!NOTE]
61-
> The Azure OpenAI scenario assumes the use of `azd` to provision an Azure OpenAI resource and configure essential permissions. If you prefer not to use `azd`, you can [provision an Azure OpenAI resource](/azure/ai-services/openai/how-to/create-resource) using another tool such as the Azure portal or Azure CLI.
62-
61+
> The Azure OpenAI scenario assumes the use of `azd` to provision an Azure OpenAI resource and configure essential permissions. Your can also [provision an Azure OpenAI resource](/azure/ai-services/openai/how-to/create-resource) using another tool such as the Azure portal or Azure CLI.
62+
6363
1. Run the `azd up` command to provision the Azure OpenAI resource and configure the necessary permissions. The command may take a few minutes to finish.
6464

6565
```bash
@@ -87,7 +87,7 @@ The **Program.cs** file contains all of the app code. The first several lines of
8787
# [Azure OpenAI](#tab/azure-openai)
8888

8989
> [!NOTE]
90-
> `DefaultAzureCredential` searches for credentials from your local tooling. If you are not using the `azd` template to provision the Azure OpenAI resource, you'll need to assign the `Azure AI Developer` role to the account you used to sign-in to Visual Studio or the Azure CLI.
90+
> `DefaultAzureCredential` searches for credentials from your local environment and tooling. If you are not using the `azd` template to provision the Azure OpenAI resource, assign the `Azure AI Developer` role manually to the account you used to sign-in to Visual Studio or the Azure CLI.
9191

9292
:::code language="csharp" source="./snippets/prompt-completion/extensions-ai/azure-openai/program.cs" range="6-8":::
9393

@@ -105,17 +105,17 @@ The following code obtains an `IChatClient` service configured to connect to the
105105

106106
---
107107

108-
The `CompleteAsync` function sends the `prompt` to the model to generate a response. The `Microsoft.Extensions.AI` library enables this code to be agnostic towards a specific AI service because it uses an `IChatClient` abstraction rather than a specific SDK implementation.
108+
The `CompleteAsync` function sends the `prompt` to the model to generate a response. The `Microsoft.Extensions.AI` library enables this code to be agnostic towards a specific AI service because it uses an `IChatClient` abstraction rather than a platform-specific SDK implementation.
109109

110110
:::code language="csharp" source="./snippets/prompt-completion/extensions-ai/openai/program.cs" range="14-22":::
111111

112-
Customize the text content of the file or the length of the summary to see the differences in the responses.
112+
Customize the text content of the `benefits.md` file or the length of the summary to see the differences in the responses.
113113

114114
:::zone-end
115115

116116
:::zone target="docs" pivot="semantic-kernel"
117117

118-
Get started with AI by creating a simple .NET 8.0 console chat application to summarize text. The application runs locally and uses the OpenAI `gpt-3.5-turbo` model. Follow these steps to get access to OpenAI and learn how to use Semantic Kernel.
118+
In this quickstart, get started with AI by creating a .NET console chat app to connect to and prompt an OpenAI or Azure OpenAI model. The app runs locally and uses the [Semantic Kernel](/semantic-kernel/overview/) SDK.
119119

120120
## Prerequisites
121121

@@ -156,6 +156,9 @@ Get started with AI by creating a simple .NET 8.0 console chat application to su
156156

157157
1. From a terminal or command prompt, navigate to the `src\quickstarts\semantic-kernel\azure-openai\01-HikeBenefitsSummary` directory.
158158

159+
> [!NOTE]
160+
> The Azure OpenAI scenario assumes the use of `azd` to provision an Azure OpenAI resource and configure essential permissions. Your can also [provision an Azure OpenAI resource](/azure/ai-services/openai/how-to/create-resource) using another tool such as the Azure portal or Azure CLI.
161+
159162
1. Run the `azd up` command to provision the Azure OpenAI resource using the [Azure Developer CLI](/developer/azure-developer-cli/overview). `azd` provisions the Azure OpenAI resources and configures permissions for you.
160163

161164
1. Use the `dotnet run` command to run the app:
@@ -193,7 +196,7 @@ The `InvokePromptAsync` function sends the `prompt` to the model to generate a r
193196
194197
:::code language="csharp" source="./snippets/prompt-completion/semantic-kernel/openai/program.cs" range="22-24":::
195198
196-
Customize the text content of the file or the length of the summary to see the differences in the responses.
199+
Customize the text content of the `benefits.md` file or the length of the summary to see the differences in the responses.
197200
198201
## Clean up resources
199202

0 commit comments

Comments
 (0)