Agent Skills
返回列表
KuteSmart 海外运营账号公司信息查询

KuteSmart 海外运营账号公司信息查询

企业运营 更新于 2026.08.29

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

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

技能介绍

解决的具体问题

在海外运营平台的复杂业务链路中,Agent 经常需要获取特定账号关联的公司信息,以执行后续的权限校验、租户隔离或业务处理。如果直接在编排层硬编码 HTTP 细节,会耦合接口契约并降低可维护性。本技能将 member_company 动作封装为最小颗粒度的原子接口,隔离了单一 HTTP 调用的复杂性。

技能如何工作

核心能力:固定调用 KuteSmart 正式环境的 GET /member/getMemberCompany 接口,专门用于查询账号公司信息。
关键步骤:

  • 参数封装:接收上层 Agent 传入的 params 对象。调用参数统一使用嵌套结构,最外层仅保留 params,避免使用 params.xxx 点号顶层 key。
  • 权限注入:读取 params.accessToken,自动生成 Authorization: Bearer 请求头。若传入值已包含 Bearer,执行器不会重复拼接。
  • 请求执行:将 Query 参数 userId 写入 params.query,发起 GET 请求。
  • 响应回传:将 RS 格式的原始接口响应作为唯一事实来源,直接交给后续业务步骤。

适用边界与注意点

  • 单步原子操作:本技能仅负责单一接口动作。若业务场景需要多个接口步骤,需由上层聚合技能或计划文档进行编排。
  • 环境与安全约束:执行器必须使用 frontmatter 中固定的正式环境地址,不接受用户输入覆盖 base_url。调用必须遵守当前登录态、租户和用户权限。
  • 错误处理:若接口返回认证、权限、参数或业务错误,技能会将原始错误码和错误信息原样传给上层 Agent,不进行猜测或掩盖。
  • 数据边界:仅透传接口实际返回的数据,不补造库存、订单号或物流状态等业务实体。

使用场景

  • 在 KuteSmart 海外运营业务链路中,agent 需要为当前登录账号拉取关联公司信息,供后续租户或权限判断使用。
  • 构建海外运营聚合 skill 时,需要把 `member_company` 单独拆成原子接口,只负责查询账号公司信息并返回原始响应。
  • 处理账号组织请求时,需要从 `params.query` 读取 `userId`,调用固定正式环境接口获取公司信息。
  • 多步骤业务编排中,若账号公司信息查询失败,需要把原始错误码和错误信息传给上层 agent 继续诊断。

适合人员

  • 维护 KuteSmart 海外运营 agent 的工程师:想把账号公司信息查询收敛成可复用原子接口。
  • 编排海外运营业务链路的开发者:需要在聚合 skill 中插入只查公司信息的单步调用。
  • 对接 KuteSmart 平台 API 的集成工程师:需要按固定正式环境地址和登录态参数完成 `member_company` 查询。
  • 处理账号组织权限场景的平台开发者:需要把接口原始返回或错误码稳定传给上层决策。