趋势榜单(TrendingList)是字节跳动 agentkit-samples 中的一项技能,用于了解行业热点、话题挑战榜单、热搜事件与公域流行趋势。适合用户询问行业趋势、热门话题挑战或热榜事件时使用,也可被日报生成、内容策划等编排技能调用,或由定时任务自动执行。
主要能力分两个维度:话题趋势榜(hot_topic_insights)提供主话题、关联挑战及占比、是否官方/商业、相关视频标题与数量、总播放量、点赞、评论、分享、关注、收藏、完播、话题描述等字段;热榜事件(hot_event)提供事件名称、摘要、相关视频、链接、热度值、排名、语音文本与分析内容等字段。
使用方式:手动输入 /trending 触发完整查询。执行前先做凭证检测与离线自检,需要火山引擎 AccessKey(AK)与 SecretKey(SK),可通过 --ak/--sk 参数或环境变量 VOLCENGINE_ACCESS_KEY/VOLCENGINE_SECRET_KEY 提供。所有脚本调用须使用虚拟环境 Python。首次或自检失败时需创建虚拟环境并安装 volcengine-python-sdk>=4.0.43(4.0.1~4.0.42 历史版本重试机制存在缺陷)。流程为:先调用 list-industries 获取行业枚举,用户选定行业后按固定类型查询列表,支持分页与排序,默认日期为前一天(T-1),用户可指定日期。话题趋势榜默认按总播放量降序,热榜事件默认按排名降序。列表结果后可展开单条详情。
限制:行业名称必须来自接口返回的枚举;凭证仅通过用户输入或环境变量获取,禁止硬编码;执行过程中不得向用户输出中间技术步骤与内部字段信息;接口调用失败、无数据或不支持的类型均有对应短提示。具体收费、价格与平台支持范围资料未明确提供。