You need to enable JavaScript to run this app. Bot Framework模拟器添加带邮箱测试成员 验证TeamsInfo.getMember
优惠活动
大模型
产品
解决方案
定价
更多

Bot Framework模拟器添加带邮箱测试成员 验证TeamsInfo.getMember

Bot Framework Emulator 本地配置带邮箱测试成员的实操方案

首先要明确:Bot Framework Emulator 原生只维护符合通用Bot框架规范的最小化成员字段,根本没有提供Teams专属扩展属性(邮箱、aadObjectId、租户ID等)的可视化配置入口。别在Emulator的设置面板里找相关配置了,那个面板里仅支持修改成员的id和name,没有邮箱类属性的输入项。你现在看到的默认返回成员结构缺少邮箱、aadObjectId为undefined的情况,是Emulator的固有设计,不是你没找对配置项。

最常用的本地测试方案:环境分支自动mock接口返回

这个方案不会污染生产环境代码,90%的本地开发测试场景都适用:

  • 逻辑核心:在机器人的消息处理入口增加通道判断,当检测到当前是Emulator测试通道时,直接重写TeamsInfo的方法实现,注入带邮箱属性的模拟成员数据,完全匹配你要验证的TeamsInfo.getMember(turnContext, 'example@my.com')的入参出参逻辑
  • 参考代码片段:
const { TeamsInfo } = require('botbuilder');

// 在onTurn业务逻辑最开头插入判断
async handleTurn(turnContext) {
  // 仅在Emulator通道下执行mock,Teams正式环境下不会触发这段逻辑
  if (turnContext.activity.channelId === 'emulator') {
    // 构造和真实Teams接口返回结构完全一致的测试成员数据
    const mockMemberList = [
      {
        id: '0b971500-986d-11eb-b677-9f834e5213c4',
        name: 'Bot',
        email: 'bot@my.com',
        aadObjectId: '自定义测试用AAD对象ID'
      },
      {
        id: '62151113-02ad-409a-91a8-c651db2c1af5',
        name: 'Test User',
        email: 'example@my.com',
        aadObjectId: '自定义测试用AAD对象ID'
      }
    ];

    // 重写getMember方法,支持邮箱/ID两种查询入参
    TeamsInfo.getMember = async (ctx, queryIdentifier) => {
      return mockMemberList.find(member => 
        member.id === queryIdentifier || member.email === queryIdentifier
      );
    };

    // 同步重写getMembers方法,保证列表查询逻辑和生产环境一致
    TeamsInfo.getMembers = async (ctx) => {
      return mockMemberList;
    };
  }

  // 后续原有业务逻辑完全不需要改动,正常调用目标接口即可完成功能验证
}

无代码改造方案:自定义测试活动注入扩展字段

如果不想改代码加判断逻辑,可以利用Emulator支持编辑活动原始JSON的能力手动注入数据:

  • 操作路径:在Emulator的消息输入区上方切换到“Show raw JSON”模式,在自动生成的默认活动结构中,手动在channelData节点下追加带邮箱的成员对象,发送活动后SDK解析时会自动读取该扩展属性
  • 注意:该方式每次启动Emulator都需要重新编辑JSON,适合临时验证单次逻辑,不适合长期开发调试

高保真测试方案:切换到真实Teams通道验证

如果需要验证的业务逻辑比较复杂,不想反复维护mock数据,可以通过内网穿透工具把本地机器人服务映射到公网,直接在个人Teams账号中安装本地开发版本的机器人应用。此时调用TeamsInfo接口返回的是真实Azure AD用户数据,天然包含邮箱属性,不需要任何手动配置,测试结果和生产环境完全一致。


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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.26 08:36:04