You need to enable JavaScript to run this app. 如何使用Python在微软机器人框架HeroCard英雄卡片中创建动态按钮
优惠活动
大模型
产品
解决方案
定价
更多

如何使用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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.24 07:15:07