Agent Skills
返回列表
酷特海外运营用户客户报表

酷特海外运营用户客户报表

企业运营 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-reporting-all-customer-by-user。

技能介绍

要解决什么问题

在海外运营平台做报表或对账时,常见需求是:某个登录用户名下有哪些客户、对应的报表维度数据是什么。这类信息往往藏在平台内部 API 里,而不是页面上一键导出。若 Agent 要自动拉数、对账或串联后续下单/库存类接口,就需要一个只负责「按用户查全量客户报表」的原子步骤,避免把 base URL、鉴权头和 Body 结构混在一坨 prompt 里。

技能如何工作

本技能对应平台动作 all_customer_by_user,在正式环境固定调用:

POST https://www.kutetailor.com/api/customer/customer/getAllCustomerByUserId

执行器从 frontmatter 读取 base_url,不接受用户改地址。调用参数统一放在嵌套对象 params 里:Path → params.path,Query → params.query,JSON Body(OrderReportTimeParam,application/json)→ params.body,额外 Header → params.headers。登录态通过 params.accessToken 生成 Authorization: Bearer;若传入值已含 Bearer 则不再重复拼接。

返回以接口响应为唯一事实来源;认证、权限、参数或业务错误时,应把原始错误码与错误信息交给上层 Agent,而不是本地补造客户、订单或金额字段。

适用边界

  • 最小颗粒度:只完成这一次 POST;完整报表链路需由上层按聚合 skill 或计划文档编排多个原子 skill。
  • 权限:仍是查询类接口,受当前登录态、租户与用户权限约束。
  • 组合使用:若用户需求包含多步(例如先选时间范围再下钻明细),本 skill 只负责本接口,并把关键返回字段交给后续 skill。

使用场景

  • 海外运营 Agent 在对账前,需按当前登录用户拉取其名下全部客户报表字段,再交给后续 skill 做明细比对。
  • 编排 platform-reporting 聚合链路时,作为第一步调用 getAllCustomerByUserId,用返回的客户列表驱动下游查询。
  • 用户口头要「我账号下有哪些客户、报表时间维度怎么填」,只需完成本 POST,不把 base_url 交给用户随意改。
  • 集成 Kutetailor 正式环境时,用固定 Body 类型 OrderReportTimeParam 提交 JSON,避免与页面导出手工混用。

适合人员

  • 负责酷特海外运营报表、需把「按用户查客户报表」封装进 Agent 工具链的内部集成工程师
  • 编写 platform-reporting 或多 skill 计划文档的 Agent 开发者,需要原子接口 skill 做链路第一步
  • 海外区销售或运营支持,经常要核对某登录用户名下客户列表并与平台 API 返回对账的数据同事
  • 对接 kutetailor.com 登录态接口的维护者,需统一 accessToken 与 Bearer 头、并把原始错误码回传上层