酷特海外运营 CRM · 按邮箱查客户

要解决什么问题

在海外运营平台 CRM 里，按邮箱定位客户是常见前置步骤：跟进线索、核对账号、串联订单或权限校验，往往都要先拿到客户主数据。若让 Agent 直接拼 URL、猜参数结构，容易混用测试地址、漏传登录态，或在接口报错时自行「补全」客户信息。

本技能是 platform-customer-crm 聚合能力下的原子接口 skill，只负责 customer_by_email 这一动作：在正式环境固定基址上发起查询，并把真实响应交给后续 skill 或编排逻辑。

技能如何工作

• 接口：GET /customer/getCustomerByEmail，Query 参数为 email。
• 调用约定：tool 参数统一放在嵌套对象 params 中；Path 用 params.path，Query 用 params.query，Body 用 params.body，额外 Header 用 params.headers。
• 鉴权：需登录态时通过 params.accessToken 生成 Authorization: Bearer …；若传入值已含 Bearer 前缀则不再重复拼接。
• 环境约束：base_url 以 skill frontmatter 中的正式环境为准，不得用用户输入覆盖。

执行器按上表选择 HTTP 方法与路径，GET 的查询参数挂在 URL query 上；返回内容以接口响应为唯一事实来源。

适用边界与注意点

• 用户需求若涉及多步（例如先查客户再改资料、拉订单），本 skill 只完成按邮箱查客户，其余步骤需由上层 Agent 按聚合 skill 或计划文档编排其他原子 skill。
• 认证失败、权限不足、参数错误或业务拒绝时，应把原始错误码与错误信息向上传递，不要本地编造库存、价格、订单号或物流状态。
• 虽为查询类接口，仍受当前租户、用户权限与登录态约束。