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

酷特海外运营客户报表

数据分析 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在海外运营平台里做经营分析时,客户报表往往依赖后台固定接口,而不是手工导出。若 Agent 直接拼 URL、混用 Query/Body 或随意改正式环境地址,很容易触发权限错误,或在对话里「补全」不存在的订单、库存字段。

本技能是 platform-reporting 聚合链路里的最小颗粒度原子能力,只负责一次 customer_report 调用,把真实响应交给后续 skill 或上层编排。

技能如何工作

  • 固定端点:执行器使用 frontmatter 中的正式环境 base_url,调用 POST /customer/getCustomerReport(完整地址为 https://www.kutetailor.com/api/customer/customer/getCustomerReport),不接受用户输入覆盖域名。
  • 参数形态:tool 参数最外层仅包含嵌套对象 params;Path → params.path,Query → params.query,JSON Body(BusinessReportRequest)→ params.body,额外 Header → params.headers。
  • 登录态:通过 params.accessToken 生成 Authorization: Bearer …;若传入值已含 Bearer 前缀则不再重复拼接。
  • 返回原则:以接口响应为唯一事实来源;认证、权限、参数或业务错误时,将原始错误码与错误信息向上传递,由上层 Agent 决定重试或换路。

适用边界

  • 仅覆盖 客户报表 这一动作;若用户需求包含多接口步骤(登录、筛选、导出等),需按聚合 skill 或计划文档组合多个原子 skill。
  • 属于查询/计算类接口,仍受当前租户与用户权限约束;本 skill 不替代权限配置或报表口径说明。

使用场景

  • 上层 Agent 编排 platform-reporting 链路时,只需拉取一次客户报表接口并把 RS 字段交给后续 skill 做汇总或解读。
  • 业务同学在对话里提出「查客户报表」需求,由 Agent 用固定 POST 与 BusinessReportRequest 体调用正式环境接口。
  • 集成测试或联调阶段,需要验证 accessToken、租户权限与报表请求体是否符合 getCustomerReport 的返回规范。
  • 多步报表流程中本步仅负责 customer_report,避免 Agent 自行改 base_url 或在回复里编造订单或库存数据。

适合人员

  • 负责 kutetailor 正式环境接口对接、需要在 Agent 工具层封装 getCustomerReport 的后端或集成工程师
  • 正在搭建海外运营报表类 Agent、要把 customer_report 作为原子 skill 编入 platform-reporting 计划的产品或架构同学
  • 海外运营或 BI 侧需要在对话中按权限查询客户报表、且要求结果严格来自接口而非手工抄数的分析人员
  • 维护多原子 skill 编排文档、需明确「客户报表」单步边界与错误码上抛规则的 Agent 平台维护者