如何使用Python在微软机器人框架HeroCard英雄卡片中创建动态按钮
Python版微软Bot Framework HeroCard 动态按钮生成实现
场景背景
在基于Python开发的微软机器人框架项目中,需要实现HeroCard卡片内的按钮动态创建能力:当前suggestion_card方法硬编码了两个固定的im_back类型CardAction按钮,实际业务需要按钮列表结合用户可访问的应用列表动态生成,不能写死固定值。
现有代码的问题点
原硬编码实现的缺陷:
- 按钮列表完全写死,标题、回传值都是测试固定值,和真实用户的应用权限无关联
- 应用取值逻辑分散,单独为每个应用定义变量存名称的写法,无法适配用户可访问应用数量动态变化的场景,原代码还存在变量引用错位的问题(定义的列表元素变量和单独取值的单值变量名不匹配)
- 权限查询逻辑和卡片生成流程完全割裂,无法响应用户权限的实时变动
实现方案
核心思路是遍历用户可访问的应用ID集合,逐个为每个应用生成对应的CardAction实例,最后将生成的动作列表传给HeroCard的buttons参数即可,不需要提前手动枚举所有按钮。
修正后的可运行代码:
def suggestion_card(self) -> Attachment: # 实时拉取当前用户有权限访问的所有应用ID accessible_app_ids = UserAccessManagement.get_current_user_app_permissions() # 循环生成每个应用对应的交互按钮 dynamic_buttons = [] for app_id in accessible_app_ids: app_name = UserAccessManagement.getAppName(app_id) dynamic_buttons.append( CardAction( type=ActionTypes.im_back, title=app_name, value=app_id ) ) card = HeroCard( text="You have access for following applications", buttons=dynamic_buttons ) return CardFactory.hero_card(card)
落地注意事项
- 这套实现不需要根据用户可访问的应用数量调整代码结构,用户有多少个可访问应用就自动生成多少个对应按钮
- 每个按钮的
value参数要绑定对应应用的真实ID,用户点击按钮后,机器人可以通过回传的ID识别用户选择的应用,触发后续对应流程 im_back类型的按钮不需要配置跳转地址,点击后回传的value会直接作为用户输入进入机器人的对话处理链路
内容的提问来源于stack exchange,提问作者Thamizh
相关产品推荐
相关产品推荐

