酷特海外 C 站用户链接配置查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-csite-website-docking-by-user。
技能介绍
要解决什么问题
在海外运营场景里,C 站(客户侧站点)往往按 userId 绑定不同的对接链接或跳转配置。Agent 若要在对话或编排里拿到「某个用户当前生效的链接配置」,不能直接猜 URL,必须走平台公开查询接口,并以接口返回为唯一事实来源。
本技能是 最小颗粒度 的原子接口 skill,只负责 docking_by_user 这一动作:用 userId 向酷特正式环境发起一次 GET,拿回链接配置相关字段,供上层聚合 skill 或计划文档继续编排(例如再配合下单、库存、权限校验等其它原子 skill)。
技能如何工作
- 固定端点:执行器使用 frontmatter 中的正式环境
base_url(https://www.kutetailor.com/api/fabric),调用GET /docking/public/c/get,不允许用用户输入覆盖 base_url。 - 参数约定:tool 参数统一放在嵌套对象
params下;本接口的 Query 为userId,写入params.query。 - 登录态:若接口需要登录态,通过
params.accessToken生成Authorization: Bearer;值里已含Bearer时不重复拼接。 - 返回处理:以 HTTP 响应体为准解析结果;认证、权限、参数或业务错误时,应把原始错误码与错误信息交给上层 agent,而不是本地补造配置或链接。
适用边界与注意点
- 用户需求若涉及多步业务(查配置后再改价、下单、查物流等),本 skill 只完成本接口调用,后续步骤需由上层按聚合 skill
platform-csite-website或其它原子 skill 继续。 - 这是查询类接口,仍受当前登录态、租户与用户权限约束;无权限时应如实上报接口错误,勿虚构「默认链接」。
- Path / Body / 额外 Header 分别走
params.path、params.body、params.headers;本 action 以 Query 为主,勿把params.xxx摊平成顶层点号 key。
使用场景
- 海外运营 Agent 在编排 C 站流程时,需先根据商户或客户的 userId 查询当前链接对接配置,再决定跳转或后续接口步骤。
- 排查某用户 C 站访问、跳转异常时,用正式环境 GET 接口按 userId 核对平台返回的链接配置是否与工单记录一致。
- 实现 platform-csite-website 聚合链路时,将本 skill 作为原子步骤,只执行 docking_by_user 并把 RS 字段交给下一原子 skill。
- 自动化脚本或对话式助手需要读取单用户 C 站对接信息时,在 params.query 传入 userId 并携带 accessToken 完成一次查询。
适合人员
- 负责酷特海外运营平台 C 站对接、要在 Agent 里按 userId 读取链接配置的集成或后端工程师
- 维护 platform-csite-website 聚合 skill、需要把 docking_by_user 与其它 fabric 原子接口串成完整链路的平台开发
- 处理商户 C 站跳转、对接 URL 争议的运营或客服,需用 userId 对照正式环境接口返回做核实
- 将 Kutetailor fabric 公开查询接入内部工具的上层 Agent 编排者,诉求是固定 base_url 与错误码原样上抛