Botframework全局语言配置问题：内置命令与响应无法切换语言

我之前在做Bot Framework多语言适配的时候，刚好碰到过和你一模一样的问题！其实框架本身是内置多语言支持的，但默认这些内置组件的文本都是英文，得通过配置资源文件来切换，不用你从头写所有翻译代码。下面分场景给你讲具体怎么弄：

一、核心思路：用资源文件（.resx）覆盖默认文本 #

Bot Framework 依赖.NET的资源文件系统来管理多语言内容。你只需要为每种目标语言创建对应的.resx文件，框架会根据用户的语言偏好自动加载对应的文本，不用重写组件的核心逻辑。

二、Formflow 多语言配置（支持多语言指令+响应） #

对于Formflow里的help这类内置命令，还有它的默认响应，你不需要改代码逻辑，只需要创建资源文件覆盖默认值：

• 先建一个默认的资源文件FormFlowResources.resx，然后为目标语言创建比如FormFlowResources.zh-CN.resx（中文简体）、FormFlowResources.es-ES.resx（西班牙语）这类带语言后缀的文件。
• 在对应语言的资源文件里，添加和Formflow内置键对应的翻译：
  • 键：Help，中文值填帮助（这样用户输入“帮助”就能触发help指令）
  • 键：Cancel，中文值填取消
  • 还有其他比如InvalidPrompt（无效输入提示）这类键，都可以在这里翻译
• 最后在初始化Formflow的时候，指定使用这个资源文件：

var form = new FormBuilder<YourFormModel>()
    .AddRemainingFields()
    .Localize(typeof(FormFlowResources)) // 关联资源文件
    .Build();

三、QnA Bot 无效提示的多语言切换 #

QnA Maker的默认无匹配提示（比如你提到的“...Is not a valid query”），同样可以用资源文件覆盖：

• 如果用的是Bot Framework SDK v4的QnA组件，对应的资源键一般是DefaultAnswer或者NoMatchResponse（具体看SDK版本，你可以查一下组件的默认资源键）
• 创建比如QnAResources.zh-CN.resx，添加键值对：DefaultAnswer → 抱歉，我暂时无法回答这个问题，请换个方式提问试试。
• 在初始化QnA服务的时候，把这个资源文件关联上，或者通过IStringLocalizer来根据用户当前语言加载对应的提示文本。

四、全局语言偏好的管理 #

要让整个Bot自动适配用户语言，还得做全局语言设置：

• 在对话开始时，从用户消息的Locale属性获取语言（比如zh-CN、en-US）
• 把这个语言偏好存在用户状态里，方便后续对话复用
• 后续所有需要多语言的组件，都根据这个状态加载对应的资源文件

举个简单的代码例子，在Bot的OnTurnAsync方法里：

var userStateAccessor = _userState.CreateProperty<UserPreferences>(nameof(UserPreferences));
var userPreferences = await userStateAccessor.GetAsync(turnContext, () => new UserPreferences());
// 优先取用户消息里的Locale，默认用英文
userPreferences.Language = turnContext.Activity.Locale ?? "en-US";
await userStateAccessor.SetAsync(turnContext, userPreferences);
await _userState.SaveChangesAsync(turnContext);

总结 #

总的来说，你不需要自己写所有命令的翻译代码，框架已经提供了资源文件的机制来覆盖内置文本。只需要为每种语言创建对应的.resx文件，关联到组件上，再配合全局语言偏好的管理，就能搞定这些内置命令和响应的多语言切换了。

内容的提问来源于stack exchange，提问作者JohnSDev