用途:该技能用于查询 Common Room 中的社区成员互动与信号,当用户询问社区活动、成员参与度或社区相关情况时可调用。
连接方式:基础地址为 https://api.commonroom.io/community/v1,认证使用 Authorization: Bearer $COMMONROOM_API_TOKEN,环境变量为 COMMONROOM_API_TOKEN。内置 10 分钟内存缓存,最多 120 条。
主要能力:服务端库文件为 server/lib/commonroom.ts,导出函数包括 getTokenStatus()(检查令牌有效性)、getMemberByEmail(email)(按邮箱查找成员,失败返回 null)、getMembers(params?)(以 POST 携带 query、cursor、limit 搜索成员)、getActivityForMember(memberId)(获取成员活动流)、getSegments()(列出社区分组)。API 路由为 GET /api/commonroom/members,用于搜索社区成员。
使用方式:可通过脚本调用,例如按邮箱搜索 pnpm action commonroom-members --email=user@example.com,按关键词搜索 pnpm action commonroom-members --query=search_term,列出分组 pnpm action commonroom-members --segments。
注意事项:getMemberByEmail 使用 POST /members/search,返回单个 CommunityMember 或出错时返回 null;API 可能返回 { items: ... } 包装或原始数组,代码已兼容两种情况。该技能适合用于发现社区参与信号,以丰富客户档案。其他细节暂未提供。