酷特海外运营平台·查询角色
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-member-account-member-role。
技能介绍
要解决什么问题
在海外运营平台的账号与组织管理里,角色决定了成员能做什么。运营或集成侧经常需要按名称核对某个角色是否存在、或把接口返回的角色字段交给后续步骤(例如绑定成员、改权限)。本技能只做一件事:调用正式环境的 member_role 查询接口,不把「查角色 + 改角色 + 拉成员列表」混在一个工具里。
技能如何工作
- 固定端点:使用 frontmatter 中的正式环境地址
GET https://www.kutetailor.com/api/member/member/getMemberRole,执行器不得用用户输入覆盖base_url。 - 参数约定:tool 参数统一放在嵌套对象
params里;本动作为 GET,查询条件写在params.query,其中roleName用于按角色名查询。 - 登录态:需登录的接口通过
params.accessToken生成Authorization: Bearer …;若传入值已含Bearer前缀则不再重复拼接。 - 返回与错误:以接口原始响应为准,不补造角色 ID、权限集合等业务数据;若出现认证、权限、参数或业务错误,应把原始错误码与错误信息交给上层 agent 处理。
适用边界
这是 platform-member-account 聚合能力下的原子 skill,对应原始 action member_role。若用户诉求需要多步(例如先查角色再改成员),应由上层 agent 按聚合文档或计划编排多个原子 skill;本 skill 只完成本接口调用并输出关键字段。
使用场景
- 集成海外运营后台时,需按 `roleName` 核对某角色是否存在再绑定成员
- 编排多步权限变更前,先拉取目标角色的接口返回字段供后续 skill 使用
- 客服或运营核对账号组织配置,按名称查询 member 角色而非手工翻后台
- Agent 执行 platform-member-account 链路时,单独触发 member_role 原子动作
适合人员
- 负责酷特海外运营平台 API 对接、要在代码里查 member 角色的后端集成工程师
- 用多个 platform 原子 skill 编排账号权限流程的 Agent 编排 / 平台工程师
- 海外运营侧按角色名核对组织与权限配置、需可审计接口结果的业务运营
- 维护 member 域聚合 skill 文档、需对照 member_role 行为做联调的平台维护者