酷特海外运营 CRM · 按昵称查客户

要解决什么问题

在海外运营场景里，客服、运营或内部 Agent 经常只知道客户在平台上的昵称，却需要拉取 CRM 里的客户档案（身份、关联信息等）。若每次手写 HTTP 调用，还要处理固定域名、登录态 Authorization: Bearer 以及统一的 params 结构，容易在编排链路里重复踩坑。

本技能是最小颗粒度接口能力，只完成一件事：按昵称调用正式环境客户查询接口。

技能如何工作

• 固定端点：执行器使用 frontmatter 中的正式环境地址 GET .../customer/getCustByNickName，不接受用户输入覆盖 base_url。
• 入参约定：tool 参数最外层仅包含嵌套对象 params；昵称放在 params.query.nickname；需登录时在 params.accessToken 传入 token（已含 Bearer 前缀则不再拼接）。
• 返回原则：以接口原始响应为准，不补造库存、订单号、优惠或物流等字段；认证、权限、参数或业务错误时，将错误码与信息交给上层 Agent 处理。

完整「查客户 → 改资料 → 跟单」等多步流程，应由上层按聚合 skill platform-customer-crm 或计划文档编排多个原子 skill；本技能只负责按昵称查客户这一步。

适用边界与注意点

• 仅覆盖 customer_by_nickname 动作；若用户意图包含多接口步骤，本技能只完成本接口并把关键字段交给后续 skill。
• 仍为查询类接口，受当前登录态、租户与用户权限约束；无权限时按接口错误原样上报。
• Path / Query / Body / 额外 Header 分别写入 params.path、params.query、params.body、params.headers，勿使用 params.xxx 形式的顶层点号 key。