引言：当机器人遇到“中国区”这个特殊环境

嘿，朋友们！如果你是个喜欢折腾技术的开发者，肯定对 Azure Bot Service 不陌生——它就像是一个“机器人托管所”，让你不用操心服务器，就能把聊天机器人（比如 Teams、微信、网页里的机器人）快速部署上线。但如果你用的是中国区 Azure（也就是 Azure China，由世纪互联运营），事情就变得有点微妙了——不是所有国际版的功能都直接可用，配置方式也有差异。今天，我们就来聊聊，怎么用 Python 在中国区 Azure 上把一个 Bot 跑起来。我会用大白话 + 代码示例，带你绕过那些坑。## 1. 先搞懂：中国区 Azure 和国际版有什么不同？简单说，中国区 Azure 的 Endpoint（服务端点）域名是 *.chinacloudapi.cn，而国际版是 *.azure.com。这意味着：- 你注册 Bot 时的 Messaging Endpoint 必须指向中国区的域名。- 使用 SDK 时，配置的 BASE_URL 或 TOKEN_ENDPOINT 要改成中国区的地址。- 某些服务（比如 Azure AI 的某些能力）可能没有完全落地，所以别指望所有功能都能用。关键点：Azure Bot Service 在中国的版本叫 Azure Bot Service（中国区），它支持 Python 的 botbuilder-python SDK，但需要你手动指定中国区的认证端点。## 2. 准备工作：注册一个 Bot 并拿到配置信息首先，你需要在 Azure 门户（中国区）创建一个 Bot 资源。步骤很简单：1. 登录 portal.azure.cn，搜索“Bot Service”，点击“创建”。2. 选择“Web App Bot”或“Bot Channels Registration”（后者更轻量）。3. 填写信息，注意 Region 选“China East”或“China North”，Pricing tier 选免费版（F0）就行。4. 创建后，进入“配置”页面，记下 Microsoft App ID 和 Microsoft App Password（也就是 Client Secret）。这两个就是你的机器人“身份证”。## 3. 配置 Python 项目：用 botbuilder SDK 连接中国区我们使用 botbuilder-python 这个官方库。首先安装：bashpip install botbuilder-core botbuilder-integration-aiohttp接下来，写一个最基础的 Echo Bot（回声机器人），它会把用户说的话原样返回。这里的关键是配置 FrameworkClient 时指定中国区的认证端点。### 代码示例 1：基础 Echo Bot（带中国区配置）python# bot.pyimport asynciofrom aiohttp import webfrom botbuilder.core import ( BotFrameworkAdapter, BotFrameworkAdapterSettings, TurnContext, ActivityHandler, MessageFactory)from botbuilder.integration.aiohttp import BotFrameworkHttpServer# 中国区特有的认证端点（注意是 .cn 后缀）CHINA_AUTH_ENDPOINT = "https://login.chinacloudapi.cn/"# 中国区的 Bot 服务端点（通常也是 .cn）CHINA_BOT_ENDPOINT = "https://botapi.chinacloudapi.cn/"class MyBot(ActivityHandler): """一个简单的回声机器人""" async def on_message_activity(self, turn_context: TurnContext): # 收到消息后，原样回复 reply = MessageFactory.text(f"你说：{turn_context.activity.text}") await turn_context.send_activity(reply)async def main(): # 从环境变量读取配置（也可以直接硬编码，但生产环境建议用环境变量） app_id = "你的APP_ID" # 替换成你的 Microsoft App ID app_password = "你的APP_PASSWORD" # 替换成你的 Client Secret # 设置适配器，关键：传入中国区认证端点 settings = BotFrameworkAdapterSettings( app_id=app_id, app_password=app_password, channel_auth_tenant="common", # 中国区也可以使用 common auth_endpoint=CHINA_AUTH_ENDPOINT, # 覆盖默认的国际版认证地址 bot_endpoint=CHINA_BOT_ENDPOINT # 覆盖默认的 Bot API 地址 ) adapter = BotFrameworkAdapter(settings) # 创建 HTTP 服务器，监听 3978 端口 server = BotFrameworkHttpServer(adapter, MyBot()) app = web.Application() app.router.add_post("/api/messages", server.handle_request) runner = web.AppRunner(app) await runner.setup() site = web.TCPSite(runner, "0.0.0.0", 3978) await site.start() print("Bot 已启动，监听 3978 端口...") await asyncio.Event().wait() # 保持运行if __name__ == "__main__": asyncio.run(main())注意：这段代码里，我手动设置了 auth_endpoint 和 bot_endpoint 为中国区地址。如果不设置，SDK 默认会连到国际版，然后报认证失败。这就是中国区部署最容易踩的坑。## 4. 部署到 Azure 应用服务（App Service）本地跑通后，我们要把这个 Bot 部署到 Azure。最简单的方式是创建一个 Linux App Service，然后把代码推上去。这里我推荐用 az webapp up 命令（需要安装 Azure CLI，并登录中国区）：bashaz cloud set --name AzureChinaCloud # 切换到中国区az loginaz group create --name mybotgroup --location chinaeastaz appservice plan create --name mybotplan --resource-group mybotgroup --sku F1 --is-linuxaz webapp create --name myunique-bot-name --resource-group mybotgroup --plan mybotplan --runtime "PYTHON:3.9"az webapp config set --name myunique-bot-name --resource-group mybotgroup --startup-file "python bot.py"az webapp up --name myunique-bot-name --resource-group mybotgroup --runtime "PYTHON:3.9" --config-file "runtime.txt"### 代码示例 2：配置 App Service 的环境变量部署后，别忘在 Azure 门户里设置环境变量（Application Settings），这样代码里就不用硬编码密码了：python# 更安全地从环境变量读取配置import osapp_id = os.environ.get("MicrosoftAppId")app_password = os.environ.get("MicrosoftAppPassword")# 其他代码同上...在 Azure 门户中，进入你的 Web App → 设置 → 配置 → 添加以下设置：- MicrosoftAppId: 你的 App ID- MicrosoftAppPassword: 你的 Client Secret- WEBSITE_HTTPLOGGING_RETENTION_DAYS: 1（可选）## 5. 设置 Bot 的 Messaging Endpoint这是最后一步，也是最关键的。回到 Azure 门户的 Bot 资源，找到“配置”或“设置”，把 Messaging Endpoint 填成：https://你的webapp名.azurewebsites.cn/api/messages注意：中国区的 App Service 默认域名是 *.azurewebsites.cn（对，是 .cn 结尾），别写成 .com 或 .azurewebsites.net。## 6. 测试：用 Bot Framework Emulator 或网页聊天本地可以用 Bot Framework Emulator（下载对应中国区版本）测试。如果部署到 Azure，可以直接在 Bot 资源的“在 Web 聊天中测试”里试试。## 总结好了，总结一下在中国区 Azure 上部署 Python Bot 的三个核心要点：1. 认证端点必须改：auth_endpoint 和 bot_endpoint 要指向 *.chinacloudapi.cn，否则会报 401 或 404。2. 域名后缀不同：App Service 的 URL 是 *.azurewebsites.cn，Bot 的 Messaging Endpoint 要对应这个。3. 环境变量管理密码：用 App Settings 存密码，别硬编码。其实整体流程和国际版差别不大，就是几个 URL 和域名的问题。只要记住“中国区 = 所有服务都带 .cn”，你就能少走很多弯路。希望这篇文章能帮你在“中国区”这个特殊环境里，把机器人顺利跑起来！如果遇到坑，欢迎在评论区交流，我们一起填坑。