KuteSmart 海外运营账号公司信息查询
将以下提示词粘贴到你的 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` 查询。
- 处理账号组织权限场景的平台开发者:需要把接口原始返回或错误码稳定传给上层决策。