SuperAPI AI 工具集

ae-community

数据与分析

查看项目

更新于 10-15 14:21

技能介绍

AE Community 是 AE(Agentic Engine)分析平台中专注于社区与聊天数据的技能,属于 ae-cli 命令行工具的 community 域。它提供社交与聊天数据分析,以及经过校验的社区数据上报能力。

用途 该技能适用于以下典型场景:搜索并查看帖子或视频,再下钻到详情与评论分析;按时间范围跟踪情感、关键词/标签与宏观概览指标;监控风险或被审核内容;分析直播间、场次及 AI 生成的场次报告;分析客服私信、客户售后群与游戏内聊天;通过 references/community-*.md 下的复合参考生成日报、周报或活动类报告。

主要能力 技能按路由划分为几类职责:community_content 负责帖子、评论、语料标签、搜索、直播内容与风险内容;community_analysis 负责频道列表、概览指标、情感与标签趋势;community_hot 负责每日摘要、热门话题与话题下钻;community.chat.* 通过 community Capability Gateway 提供聊天概览、参与者发现、基于名册的服务指标、意图/风险下钻与原始证据;直接上报数据面通过 community data report 校验、规范化并向明确的 Iris /sync_content 端点提交社区记录。

命令组包括:内容类(+get_livestream_list、+get_livestream_detail、+get_livestream_analysis、+get_post_detail、+get_comments_summary、+get_comment_tag_analysis、+get_corpus_tags、+get_risk_content、+search_posts、+get_livestream_overview、+get_livestream_rooms、+get_livestream_room_metrics);分析类(+get_channel_info、+get_overview_metrics、+get_sentiment_overview、+get_tag_trends);热门类(+get_daily_summary、+get_hot_topics、+get_topic_detail);以及数据上报命令 data report。

使用方式 所有命令以 ae-cli community 为前缀,子命令使用 + 前缀。全局参数包括 --format <json|table>(默认 JSON)、--jq <expr>、--host <url>(需放在子命令之后,且不适用于 community data report)。常用参数约定:--space-id 为社区空间 ID(数字),--game-id 为游戏/空间标识(数字),--channel-id / --channel-id-list 在已知频道 ID 后常为必需;列表参数以逗号分隔,日期使用 yyyy-MM-dd 格式。

许多命令需要 --channel-id 或 --channel-id-list。若只有 --space-id / --game-id,需先运行 ae-cli community +get_channel_info --space-id <id> --game-id <id> 获取频道 ID,再用于后续命令。

聊天分析能力为 L3,使用前必须先发现:先执行 ae-cli capability search "chat" --domain community,再 inspect 与 run。没有员工身份列表时不得报告客服绩效,且该列表必须是所选服务范围内的完整员工名册。

数据上报需先阅读 community-data-report.md,使用明确的摄取端点与已验证的 ID,不得从当前 AE 主机或分析结果推导。上报要求 --space-id、--channel-id、--source-id 为正 int64 标识,其中 --space-id 映射到 Iris game_id;端点通过 --endpoint 或 AE_IRIS_SYNC_ENDPOINT 指定,--host 不选择、推导或修改摄取端点。输入模式二选一:--data-type <type> --data <inline|path|@path|->,或 --payload <inline|path|@path|->。构建输入前先运行 ae-cli community data report --help 查看各 data_type 的必填字段。首次提交数据集前应运行 --dry-run,其摘要经过脱敏,不打印业务内容。成功仅应理解为 status: "queued" 且 persistence_verified: false,不代表逐条接受或持久存储;超时会导致投递状态未知,需先检查下游查询/存储侧,且不得自动重试。

复合场景技能包括:community-activity-analysis.md(活动/营销事件洞察)、community-daily-report.md(日报,T-1 对比 T-2)、community-character-analysis.md(角色/IP 深度分析)、community-hottopic-insight.md(单话题演化与行动)、community-weekly-report.md(周度运营总结)、community-analyzing-official-content.md(官方内容分类)、community-analyzing-theme-comment.md(主题评论区分析)。

适用场景与限制 该技能面向社区运营、内容分析、舆情监控、直播分析、客服与聊天分析以及社区数据上报等场景。安全约束方面:读命令在验证所需 ID 与引用后可直接执行;普通写命令需要用户明确意图但无需 CLI 确认,仅高风险写命令使用确认门;不得编造命令名、标志、JSON 载荷、project_id、资源 ID、字段名、事件名、属性名、指标定义或日期格式;不得捏造或猜测资源名称,找不到资源时应明确告知用户并停止。多数社区命令为只读,community data report 属于普通风险写命令,用户明确意图即可,无需 --yes 或额外确认。每次运行后需检查 stderr 与 _notice.host_compat,若存在需在回复开头给出简短版本警告并原样引用相关安装/更新命令。