azure openai keys and endpoints的进一步展开说明

将Azure OpenAI集成到您的利用程序中

使用Azure OpenAI服务，开发人员可以创建优秀的聊天机器人、语言模型和其他能够理解自然人类语言的利用程序。Azure OpenAI提供了预训练的人工智能模型，和一套用于定制和优化这些模型以满足利用程序特定要求的API和工具。在本练习中，您将学习怎样在Azure OpenAI中部署模型，并在自己的利用程序中使用它来对文本进行摘要。

开始之前

您需要一个已批准访问Azure OpenAI服务的Azure定阅。

要注册不要钱的Azure定阅，请访问 https://azure.microsoft.com/free。

要要求访问Azure OpenAI服务，请访问 https://aka.ms/oaiapply。

创建Azure OpenAI资源

在使用Azure OpenAI模型之前，您一定要在Azure定阅中创建一个Azure OpenAI资源。

1. 登录Azure门户。
2. 使用以下设置创建Azure OpenAI资源：
   • 定阅：已批准访问Azure OpenAI服务的Azure定阅。
   • 资源组：创建一个命名为您自己选择的新资源组。
   • 区域：选择任何可用区域。
   • 名称：一个您自己选择的唯一位称。
   • 定价层：标准S0。
3. 等待部署完成。然后转到Azure门户中已部署的Azure OpenAI资源。导航到“Keys and Endpoint”页面，将这些保存到一个文本文件中以便以后使用。

部署模型

要使用Azure OpenAI API，您首先一定要通过Azure OpenAI Studio部署一个模型以供使用。部署完成后，我们将在利用程序中援用该模型。

1. 在Azure OpenAI资源的“概览”页面，使用“Explore”按钮在新的浏览器选项卡中打开Azure OpenAI Studio。在Azure OpenAI Studio中，使用以下设置创建一个新的部署：
   • 模型：gpt⑶5-turbo
   • 模型版本：使用默许版本
   • 部署名称：text-turbo

   注意：每一个Azure OpenAI模型都针对区别的能力和性能平衡进行了优化。在这个练习中，我们将使用GPT⑶模型系列中的3.5 Turbo模型系列，这个模型对语言理解非常有能力。这个练习只使用一个模型，但是您部署的其他模型的部署和使用方式也是相同的。

在Cloud Shell中设置利用程序

为了演示如何与Azure OpenAI模型集成，我们将在Azure的Cloud Shell中运行一个短的命令行利用程序。打开一个新的浏览器选项卡来使用Cloud Shell。

1. 在Azure门户中，选择页面顶部搜索框右边的[>_]（Cloud Shell）按钮。一个Cloud Shell窗格将在门户的底部打开。在您打开Cloud Shell的第一次，您可能需要选择要使用的shell类型（Bash或PowerShell）。选择Bash。如果您没有看到这个选项，请跳过这一步。如果提示您为Cloud Shell创建存储，请确保指定了您的定阅并选择Create storage。然后等待一分钟左右，直到存储被创建。确保Cloud Shell窗格左上角唆使的shell类型已切换为Bash。如果是PowerShell，请使用下拉菜单切换到Bash。终端启动后，输入以下命令下载示例利用程序并将其保存到名为azure-openai的文件夹中。
   “`shell
   rm -r azure-openai -f git clone https://github.com/MicrosoftLearning/mslearn-openai azure-openai
   “`
   文件将被下载到名为azure-openai的文件夹中。
2. 使用以下命令导航到此练习的实验文件所在的文件夹：
   • bash
     “`shell
     cd azure-openai/Labfiles/02-nlp-azure-openai
     “`

设置您的利用程序

在这个练习中，您将完成一些关键部份的利用程序，以便使用Azure OpenAI资源。

1. 在代码编辑器中，展开C#或Python文件夹，根据您的语言偏好打开配置文件：
   • C#: appsettings.json
   • Python: .env
2. 更新配置值，包括您创建的Azure OpenAI资源的端点和密钥，和您部署的模型名称text-turbo。保存文件。
3. 切换到您首选的语言文件夹，并安装必要的包：
   • C#: “`shell cd CSharp dotnet add package Azure.AI.OpenAI –prerelease “`
   • Python: “`shell cd Python pip install python-dotenv pip install openai “`
4. 进入您首选的语言文件夹，选择代码文件，并添加必要的库：
   • C#：“`csharp // Add Azure OpenAI package using Azure.AI.OpenAI; “`
   • Python：“`python # Add OpenAI import import openai “`
5. 打开您首选的语言的利用程序代码，并添加构建要求的必要代码，其中指定了模型的各种参数，例如提示和温度：
   • C#：
     “`csharp
     // Initialize the Azure OpenAI client
     OpenAIClient client = new OpenAIClient(new Uri(oaiEndpoint), new AzureKeyCredential(oaiKey));

     // Build completion options object
     ChatCompletionsOptions chatCompletionsOptions = new ChatCompletionsOptions()
     {
     Messages = {
     new ChatMessage(ChatRole.System, “You are a helpful assistant. Summarize the following text in 60 words or less.”),
     new ChatMessage(ChatRole.User, text),
     },
     MaxTokens = 120,
     Temperature = 0.7f,
     };

     // Send request to Azure OpenAI model
     ChatCompletions response = client.GetChatCompletions(deploymentOrModelName: oaiModelName, chatCompletionsOptions);
     string completion = response.Choices[0].Message.Content;

     Console.WriteLine(“Summary: ” + completion + ”

     “);
     “`

   • Python：
     “`python
     # Set OpenAI configuration settings
     openai.api_type = “azure”
     openai.api_base = azure_oai_endpoint
     openai.api_version = “2023-03⑴5-preview”
     openai.api_key = azure_oai_key

     # Send request to Azure OpenAI model
     print(“Sending request for summary to Azure OpenAI endpoint…

     “)
     response = openai.ChatCompletion.create(
     engine=azure_oai_model,
     temperature=0.7,
     max_tokens=120,
     messages=[
     {“role”: “system”, “content”: “You are a helpful assistant. Summarize the following text in 60 words or less.”},
     {“role”: “user”, “content”: text}
     ]
     )

     print(“Summary: ” + response.choices[0].message.content + ”

     “)
     “`

运行利用程序

现在您的利用程序已配置完成，运行它以将要求发送到您的模型并视察响应。

1. 在Cloud Shell的bash终端中，导航到您首选的语言文件夹。
2. 运行利用程序：
   • C#: “`shell dotnet run “`
   • Python: “`shell python test-openai-model.py “`
3. 视察示例文本文件的摘要。
4. 打开您首选的语言的代码文件，并将温度值更改成1。保存文件。
5. 再次运行利用程序，并视察输出。
6. 增加温度值通常会致使摘要区别，即便提供了相同的文本，这是由于增加的随机性。您可以屡次运行它以查看输出怎么更改。尝试使用相同输入的区别温度值。

清算

当您完成Azure OpenAI资源后，请记住在Azure门户中删除部署或全部资源。

azure openai keys and endpoints的常见问答Q&A