Agent Skills
返回列表
酷特海外平台 · 按 ID 查账号

酷特海外平台 · 按 ID 查账号

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-member-account-member-by-id。

技能介绍

要解决什么问题

在海外运营平台里,业务侧经常只有 会员 ID(memberId),需要反查账号主体信息才能做权限校验、客服核对或与其它接口串联。若让 Agent 手写 URL、拼 Bearer 头、区分 Path/Query/Body,容易和网关约定不一致,也会在多步链路里重复造轮子。

本技能是 platform-member-account 聚合能力下的最小颗粒度接口 skill,只负责一个动作:member_by_id。

技能如何工作

正式环境固定基址为 https://www.kutetailor.com/api,调用 GET /member/{memberId}(完整路径:/member/member/{memberId} 对应文档中的 URL 模式)。

  • tool arguments 统一使用嵌套 params 对象;最外层只放 params,不要用 params.xxx 这类点号顶层 key。
  • Path 参数 memberId 写入 params.path;Query、JSON Body、额外 Header 分别写入 params.query、params.body、params.headers。
  • 登录态:用 params.accessToken 生成 Authorization: Bearer;若传入值已含 Bearer 前缀则不再重复拼接。
  • 执行器 必须 使用 frontmatter 中的固定正式环境地址,不接受 用户输入覆盖 base_url。

返回以接口响应为唯一事实来源;若出现认证、权限、参数或业务错误,应把原始错误码与错误信息交给上层 Agent 处理。

适用边界

  • 仅需 根据 ID 查账号 时使用;若用户诉求涉及注册、改资料、批量列表等多接口流程,应由上层 Agent 按聚合 skill 或计划文档编排多个原子 skill,本 skill 只完成本接口调用并把关键字段交给后续步骤。
  • 仍是查询类接口,需遵守当前登录态、租户与用户权限;不要根据返回结果补造库存、价格、订单号等未在响应中出现的字段。

使用场景

  • 客服工单里只有 memberId,需要在正式环境拉取该会员账号信息后再核对订单或权限
  • 编排多步 Agent 流程时,上游步骤已产出会员 ID,本步仅调用 member_by_id 并把 RS 字段交给后续 skill
  • 权限或租户校验前,根据用户提供的 ID 反查 platform-member-account 侧账号主体
  • 集成 kutetailor 会员接口的自动化脚本,需按网关约定用 params.path 传入 memberId 并带 Bearer 登录态

适合人员

  • 对接酷特海外运营平台的后端工程师,需要在 Agent 工具链里固定调用 GET /member/{memberId} 而非手写请求
  • 负责 platform-member-account 聚合 skill 的编排者,要把 member_by_id 作为原子步骤嵌入完整业务链路
  • 海外运营侧运营或风控同学,通过对话式 Agent 用会员 ID 查账号,且不允许改正式环境 base_url
  • 维护 kutetailor 正式环境 API 契约的集成开发,需统一 params 嵌套结构与错误码原样上抛