酷特海外运营客户报表
将以下提示词粘贴到你的 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 平台维护者