You need to enable JavaScript to run this app. 如何将Bot Framework Composer机器人部署至Node.js ~12版Azure Function App并配置通道注册
优惠活动
大模型
产品
解决方案
定价
更多

如何将Bot Framework Composer机器人部署至Node.js ~12版Azure Function App并配置通道注册

Composer开发机器人部署至Node.js ~12运行时Azure Function App全流程

前置准备

  • 在Bot Framework Composer中选择「发布到Azure Functions」的导出选项,生成适配无服务器运行时的项目包,避免导出为Azure App Service专属的Web应用格式包。
  • 在Azure门户创建目标Function App时,严格选择运行时栈为Node.js ~12,托管计划可根据流量规模选择消耗计划或弹性高级计划,部署区域尽量和后续创建的Azure Bot服务区域保持一致,降低跨域网络延迟。
  • 预留好后续关联使用的Azure AD应用注册信息,包含应用(客户端)ID、客户端密钥,避免后续配置权限时重复申请。
  • 各步骤操作的选项位置可对照提供的参考截图逐项核对,确认界面选择和流程要求匹配。

项目部署到Function App

  • 本地打开导出的Composer项目根目录,执行npm install --production安装生产环境依赖,安装完成后运行依赖引擎校验,确认所有依赖版本兼容Node.js 12运行时,排除存在Node.js 14+专属语法依赖的包。
  • 进入目标Function App的「部署中心」,选择适合的部署通道(zip包直传、本地Git、GitHub Actions持续部署均可),注意部署时关闭平台默认的「从包运行生成构建」选项,避免平台自动安装不兼容的依赖版本。
  • 将本地安装完依赖的完整项目目录打包为zip包上传部署,部署完成后在Function的「函数」列表中确认平台可以正常识别到消息触发入口(默认路径为/api/messages)。
  • 在Function App的「配置-应用设置」页面,补充机器人运行必需的环境变量:包括MicrosoftAppId、MicrosoftAppPassword、MicrosoftAppType,以及Composer项目关联的语言服务、状态存储、技能路由对应的配置项值。

通道注册与对接配置

  • 创建Azure Bot服务资源,关联之前准备的Azure AD应用信息,消息接收端点填写Function App的消息触发地址,格式为https://<你的Function应用名称>.azurewebsites.net/api/messages,确保路径和函数触发路由完全匹配。
  • 先使用内置的Web Chat通道做基础连通性测试,发送测试消息确认请求可以正常触达Function托管的机器人实例,排除鉴权失败、运行时报错的问题。
  • 后续需要对接其他服务渠道(Teams、企业微信、自定义Web端等)时,无需重复部署代码,直接在Azure Bot的「通道配置」板块找到对应渠道的配置入口,完成授权后即可实现全渠道消息统一路由到已部署的机器人实例。

常见问题排查

  • 若部署后调用消息接口返回500类错误,优先检查Function应用设置中的WEBSITE_NODE_DEFAULT_VERSION是否明确指定为~12,避免平台自动加载更高版本Node运行时导致代码不兼容。
  • 若出现鉴权401/403错误,核对Azure Bot资源和Function应用中配置的MicrosoftAppId、MicrosoftAppPassword值是否完全一致,排除多余空格、值错配的问题。
  • 若机器人收到消息后无法正确执行Composer配置的对话流,检查应用设置中关联的状态存储、语言模型端点、密钥等配置值是否正确传入运行环境。

内容的提问来源于stack exchange,提问作者dinirichard

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 22:15:04