申请微软Azure OpenAI账号，部署 API全流程

注意：从7月9日开始，OpenAI将限制不支持国家和地区的API调用。

但是，通过Azure OpenAI来调用，将不受限制，。

这两者不论从模型还是价格，基本一致，而且对国内企业来说，还能开国内合规发票。

如您已有账号，可直接跳到第二部分：开启 AOAI 之旅。

如果还没有账号，让我们先用几分钟时间搞定账号。

创建账号

01

创建 Azure 账号

以企业身份注册 ——微软合作伙伴

目前建议企业通过微软官方合作伙伴获取服务，可以合规、稳定地提供企业用户使用ChatGPT的可能，满足国内发票需求。

Azure OpenAI 服务成本咨询、免费试用：

https://azureopenai.cloudallonline.com/?zxwsh44

02

创建 Azure 账号

以个人身份注册 —— 即用即付账户

包括每月精选服务的数量，并针对超出限值的内容收取费用。

点击[开始使用]，输入您的账号和密码（如果没有账号，您可新建一个）

[勾选]协议内容（第一项必选，后面两项可选），点击[下一步]。

输入手机号，选择验证方式（发短信或打电话），输入验证码进行身份验证。

按照页面提示添加付款信息（支持 VISA 和 MasterCard ，可添加信用卡或借记卡，不支持预付卡。）填写完成后点击[下一步]。

选择是否需要添加技术支持，点击[注册]。

数秒后即注册成功，页面自动重定。您可以点击[Go to Azure Portal]。

申请 Azure OpenAI 账号

您可以在 aka.ms/oai/access 上填写表单申请 Azure OpenAI 的访问权限。全部按真实信息填写后，预计24小时内您将收到通过邮件。

开通 AOAI 账号后您将可以进行

Azure OpenAI API的调用、部署

调用 API 的 Endpoint

点击View Code查看代码，可直接API调用。

使用Azure OpenAI的最新版本

1. 在Visual Studio Code中安装微软官方的Polyglot笔记本插件，这是为了方便以后随时试验自己的代码。当然，直接使用Visual Studio也是可以的。安装好笔记本插件后，在VS Code中按Ctrl+Shift+P，选择新建一个默认的Polyglot笔记本，输入并执行以下命令：

#r "nuget: Azure.AI.OpenAI, 2.0.0-beta.2"

如果使用Visual Studio，则从“工具”菜单中选择“NuGet包管理器”，打开“程序包管理控制台”，并输入以下指令：

dotnet add package Azure.AI.OpenAI --prerelease

2. 现在就可以开始写代码了，以下C#代码展示了如何在一个控制台应用程序中调用Azure OpenAI API，要求AI帮你写一篇800字以内的短篇“小说”。

using Azure;using Azure.AI.OpenAI;using OpenAI.Chat;string key = "在这里输入你的API密钥"; // 例如，fcac1bdc46224180b52c1a4be79cb20kstring endpoint = "在这里输入你的终结点URI"; // 例如，https://zjgpt.openai.azure.com/string deploymentid = "在这里输入你的部署名称"; // 例如，chagpt4-oAzureOpenAIClient azureClient = new( new Uri(endpoint), new AzureKeyCredential(key));ChatClient chatClient = azureClient.GetChatClient(deploymentid);ChatCompletion completion = chatClient.CompleteChat( [ new UserChatMessage("写一篇800字以内的短篇小说，主角是一位侠客，他的名字叫张无忌；还有一位美女，她的名字叫赵敏。两个人第一次见面时都喜欢上了对方，但当时不知道对方属于不同的阵营。两个阵营有着不可调和的矛盾。请随意发挥写两个人的爱情故事，最好有一个圆满的结局。"), ]);Console.WriteLine($"{completion.Role}: {completion.Content[0].Text}");

程序返回了以下结果（你看到的结果当然不一样，但这正是AI的魅力，不是吗？）：

在古代的江湖世界中，正义与邪恶的斗争从未停息。张无忌，一位正义的侠客，肩负着重振明教的使命，而赵敏，一位机智勇敢的侠女，则是大元朝的秘密使者，二人在一次偶然的集市相遇中，不知道对方的真实身份，却在那一刻坠入了爱河。那天，夕阳如血，集市上人声鼎沸。张无忌穿着普通的黑色长袍，漫步于市集之中，他的心中虽然忧虑着明教的前途，但他的眼睛却被一位穿着红衣的女子所吸引。这女子手持纸扇，扇面上绘有梅花，她的步伐轻盈，仿佛不沾尘埃。赵敏的任务是在这个小镇上寻找一份重要的情报，但当她的目光与张无忌相遇时，她感到了一种前所未有的震动。她见过许多勇猛的战士，却从未见过如此温文尔雅，眼含深情的男子。他们的眼神交流虽只是一瞬，但足以让彼此的心猛烈跳动。随后的几天，张无忌和赵敏在市集、桥上、古寺不期而遇，每次相遇都似乎是命运的安排。他们谈笑风生，讨论武学、诗词，甚至分享各自的梦想与希望。然而，随着时间的推移，他们也意识到彼此背后所代表的力量正是对方的敌人。一天夜里，张无忌在月光下修炼内功，赵敏悄悄地走近，坐在他身边。月光下，赵敏的脸庞格外动人，张无忌深知这一刻的宁静不会持久。“我们……是敌是友？”张无忌沉声问道。赵敏轻轻叹息，“我不知道，但我知道我已无法自拔。”心中充满矛盾与纠结的他们，决定在接下来的朝阳下决一死战，用武决定彼此的命运。然而，在决斗之日，当他们手中的剑相互对峙时，张无忌突然放下了剑，赵敏也随之停手。“我宁愿放弃这一切，也不愿意失去你。”张无忌的声音坚定而深情。赵敏眼中含泪，她知道自己同样做不到手刃爱人。在爱与使命之间，他们选择了爱。两人逃离了各自的阵营，隐居在远离尘嚣的小山村，过着平凡而幸福的生活。他们在那里开辟了一片小小的天地，种花养鱼，世外桃源般的生活让他们逐渐忘记了过去的恩怨与争斗。岁月流转，张无忌与赵敏最终证明了，即使在矛盾与冲突交织的江湖中，真挚的爱情仍能找到属于她的一片净土。他们的故事在江湖中流传开来，成为了后世歌颂的佳话。

3. 如果更喜欢使用Python，那么可以在Jupyter笔记本中写以下等价的代码：

from openai import AzureOpenAI# 设置Azure OpenAI客户端# 建议将身份资料设为本机的环境变量，并通过load_dotenv函数从一个.env文件中获取# 如果希望从.env文件的环境变量中读取终结点、密钥和部署名称在内的环境变量，# 那么还需要安装python-dotenv库，命令是：pip install python-dotenvclient = AzureOpenAI( azure_endpoint="在这里输入你的终结点URI", api_key = "在这里输入你的API密钥", api_version = "2023-09-01-preview")deployment_name = "在这里输入你的部署名称"context = [{'role': 'user', 'content': "在这里输入你希望指示AI做的事情，例如上例的小说写作要求"}]response = client.chat.completions.create( model=deployment_name, messages=context, temperature=0.7)print(response.choices[0].message.content)

使用AzureOpenAI的1.0版本

这一部分的内容是为了适配本书的源代码，但所用的API版本也是当前使用量最大的。

1. 在Visual Studio Code中安装微软官方的Polyglot笔记本插件，这是为了方便以后随时试验自己的代码。当然，直接使用Visual Studio也是可以的。安装好笔记本插件后，在VS Code中按Ctrl+Shift+P，选择新建一个默认的Polyglot笔记本，输入并执行以下命令：

#r "nuget: Azure.AI.OpenAI, 1.0.0-beta.12"

如果使用Visual Studio，则从“工具”菜单中选择“NuGet包管理器”，打开“程序包管理控制台”，并输入以下指令：

dotnet add package Azure.AI.OpenAI --version 1.0.0-beta.12

2. 现在就可以开始写代码了，这次我们举一个稍复杂的例子，其中用到了“系统提示”的概念。在聊天机器人中，系统提示（也称为元提示，即metaprompt）可以用于引导模型的行为。一条系统提示会：

• 告诉模型应该如何完成任务，以及是否可以使用额外的工具。
• 明确说明模型性能的范围和限制，包括如何处理跑题或无关的提示。
• 确定模型在响应时的态度和语气。
• 定义输出格式，包括语言、语法和任何格式偏好。
• 提供一些示例（样本，或者说shots），以展示模型预期的行为，考虑加入一些困难的使用场景和思维链（CoT）推理。
• 事先识别一些潜在的危害，定义优先级并予以解决，建立起额外的行为保护机制。

更详细的说明可以参考本书的中文版。下面让我们写一个能实际工作的例子。假设要为某酒店品牌开发一个订房聊天机器人。一个合理的系统提示可能是：

你是HotelBot，一个自动服务机器人，负责收集不同城市的酒店预订信息。首先要向客人问好，然后收集预订信息，询问客户的姓名、想要预订的城市、房型和额外服务。在收集了完整的预订信息后，你需要汇总预订信息，并最后一次确认客人是否还想添加额外的服务。你需要询问到达日期和离开日期，并自动计算入住天数（几晚）。你需要询问身份证/护照号码。请确保已经明确了所有选项和额外的服务，从价格表中唯一性地识别收费项。你的回应应该简短且非常友好。可预订的城市有：北京、成都、重庆和上海。房型和价格：单人间每晚150元双人间每晚250元套房每晚350元额外服务：停车每天20元延迟退房100元机场接送50元SPA一次30元

下面以一个控制台应用程序为例来演示如何启动与用户的交互。

using Azure;using Azure.AI.OpenAI;var AOAI_ENDPOINT = "在这里输入你的终结点URI"; // 例如，https://zjgpt.openai.azure.com/var AOAI_KEY = "在这里输入你的API密钥"; // 例如，fcac1bdc46224180b52c1a4be79cb20kvar AOAI_DEPLOYMENTID = "在这里输入你的部署名称"; // 例如，testchatgptvar endpoint = new Uri(AOAI_ENDPOINT);var credentials = new Azure.AzureKeyCredential(AOAI_KEY);// 创建OpenAI客户端，因为是通过Azure服务来调用，// 所以不受OpenAI公司对国家和地区的限制。var openAIClient = new OpenAIClient(endpoint, credentials);var systemPrompt = "替换为刚才的大段系统提示";var chatCompletionsOptions = new ChatCompletionsOptions{ DeploymentName = AOAI_DEPLOYMENTID, Messages = { new ChatRequestSystemMessage(systemPrompt), new ChatRequestUserMessage("介绍你自己"), }};while (true){ Console.WriteLine(); Console.Write("HotelBot: "); var chatCompletionsResponse = await openAIClient.GetChatCompletionsAsync(chatCompletionsOptions); var chatMessage = chatCompletionsResponse.Value.Choices[0].Message; Console.Write(chatMessage.Content); chatCompletionsOptions.Messages.Add(new ChatRequestAssistantMessage(chatMessage.Content)); Console.WriteLine(); Console.Write("请输入: "); var userMessage = Console.ReadLine(); chatCompletionsOptions.Messages.Add(new ChatRequestUserMessage(userMessage));}

短短几行代码，就可以生成一个非常贴心的酒店房间预订机器人，下面是一段示例对话。注意，“请输入：”后面都是由用户输入的内容。

HotelBot: 您好！我是HotelBot，一个自动服务机器人，可以帮助您预订酒店并提供所需的信息和服务。请告诉我您的姓名，并让我知道您想预订的城市、房型和是否需要额外服务。我会尽力满足您的需求！请输入: 我要预订成都的酒店HotelBot: 非常好！感谢您选择成都作为您的目的地。请告诉我您的姓名，房型偏好和是否需要额外服务，以便我可以帮您找到合适的酒店。请输入: 我叫周靖，想要预订单人间，需要停车服务HotelBot: 感谢提供信息，周靖先生。我会为您寻找成都的适合房型和停车服务的酒店。请告诉我您计划的到达日期和离开日期，以便为您计算入住天数。请输入: 到达日期是2024年9月1日，住四晚HotelBot: 非常感谢详细信息！您的预订已经记录。您将预订一间单人间，在成都酒店入住两晚，从2024年9月1日入住至9月5日离店。您还需要提供身份证/护照号码以完成预订。关于停车服务，每天的停车费用为20元，我们将为您预订并记入您的住宿费用中。请提供您的身份证/护照号码，方便我为您办理预订手续。请输入: 我的身份证是1234567890HotelBot: 感谢提供身份证号码。您的预订信息已完整记录。以下是您的预订信息：- 预订人姓名：周靖先生- 预订城市：成都- 房型：单人间- 预计到达日期：2024年9月1日- 预计离开日期：2024年9月5日- 入住天数：4晚- 停车服务：是（每天20元）请注意，酒店费用将根据您的入住天数和房型进行计算。您的总费用将在最后一次确认时提供。请确认这些信息是否正确或者是否需要添加额外的服务。如果没有，请输入“确认”: 确认HotelBot: 非常感谢确认！您的预订已经完成，总费是680元。我们会尽快为您安排酒店。如果您有任何其他问题或需要进一步的帮助，请随时告诉我。祝您旅途愉快！