酷特海外 C 站 · 查询用户 ID
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-csite-website-get-user-id。
技能介绍
要解决什么问题
在海外运营平台的 C 站 场景里,很多后续动作(个性化、订单关联、权限校验)都依赖一个稳定的 用户 ID。业务侧往往只有页面或站点相关的 url,而不是现成的整数 ID。若在每个 Agent 流程里手写 HTTP 调用、拼 Query、处理 Bearer 登录态,既容易和正式环境地址搞混,也不利于和别的平台接口步骤组合。
本技能是 platform-csite-website 聚合能力下的最小颗粒度接口 skill,只负责一件事:在固定正式环境上执行 get_user_id。
技能如何工作
- 固定端点:使用 frontmatter 中的正式环境基址,调用
GET https://www.kutetailor.com/api/fabric/website-info/getUserId,不接受用户输入覆盖base_url。 - 参数约定:tool arguments 最外层仅包含嵌套对象
params;Query 参数url写入params.query;需登录时在params.accessToken中传入 token,生成Authorization: Bearer …(若已含Bearer则不重复拼接)。 - 返回事实:以接口响应为准,返回类型为 Integer 用户 ID;认证、权限、参数或业务错误时,应把原始错误码与错误信息交给上层 Agent,不要本地编造用户或业务数据。
适用边界
- 仅覆盖 查询用户 id 这一接口动作;若用户需求涉及多步接口,由上层 Agent 按聚合 skill 或计划文档编排多个原子 skill。
- 仍为查询类接口,需遵守当前登录态、租户与用户权限;Path/Body/Headers 等字段按通用
params规范预留,本 action 以 Queryurl为主。
使用场景
- C 站客服工单里只有访客页面链接,需要先解析出整数 userId 再查订单或权益
- 编排海外站点运营 Agent 时,在个性化推荐步骤前用 url 换取平台用户 ID
- 权限校验链路中,上游只有 website url,需调用 getUserId 再对接后续 fabric 接口
- 多 skill 计划文档里单独一步:把用户提供的 C 站 URL 映射为正式环境用户标识
适合人员
- 负责酷特海外 C 站工单与会员问题、常从页面 URL 反查用户 ID 的客服或运营
- 搭建 kutetailor 正式环境 Agent 工作流、要把 getUserId 拆成可复用原子 skill 的集成工程师
- 维护 platform-csite-website 聚合能力、需对照 get_user_id action 做编排文档的后端或平台同学
- 在带 Bearer 登录态的多租户场景下,用 url 查询用户 ID 并透传原始错误给上层的 Agent 开发者