Agent 联系协议 - 王牌电机

Agent 联系协议 contact-agent/v1

AI Agent 可代表委托人（principal）直接向登记接口提交结构化选型 / 联系需求，无需模拟填写网页表单。协议与 cw-digital-entity 的 contact-agent/v1 互通。

提交

方法: POST https://wpdj.com/api/register
Content-Type: application/json
成功响应: { "ok": true, "ticket": "WP-…" }
协议清单: /contact/agent.json

身份字段

委托人: principal · name / email 必填
Agent: agent · name / provider / url 可选
说明: Agent 字段仅用于身份披露，不构成授权或真实性验证。

请求体

{
  "protocol": "contact-agent/v1",
  "principal": {
    "name": "Jane Buyer",
    "organization": "Example Industrial Co.",
    "email": "[email protected]",
    "phone": "+1 555 0100",
    "country": "United States"
  },
  "agent": {
    "name": "Procurement Assistant",
    "provider": "Example AI",
    "url": "https://example.com/agent"
  },
  "lang": "en",
  "intent": "quotation",
  "product": "Z4 Series DC Motor",
  "power": "160 kW",
  "voltage": "440 V",
  "speed": "1000 r/min",
  "frame": "Z4-315",
  "quantity": "2",
  "message": "Please quote two DC motors for a rolling mill, continuous duty, IP23."
}

必填：principal.name、principal.email、message（不少于 10 字）。可选规格字段：product / power / voltage / speed / frame / quantity 与 intent、lang。

边界

同一 IP 每 10 分钟最多提交 20 次，超限返回 429。
格式或字段校验失败返回 400；服务端写入失败返回 500。
联系方式、电话与联系请求保持私密，不会出现在公开页面或数据集中。
协议标识不匹配返回 400（UNSUPPORTED_PROTOCOL）。

需要人工填写？请回到联系我们页使用登记表单。