Agent Skills
返回列表
酷特海外运营平台·查询角色

酷特海外运营平台·查询角色

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 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 行为做联调的平台维护者