Target 目标公司发现

Target 根据自然语言描述查找符合条件的目标公司。当前每次创建包含 25 家企业的 Target；系统会自动理解条件并开始查找，无需人工确认中间条件。

创建 Target

POST/api/v2/websets

Idempotency-Key 可选。调用方会在网络超时后自动重试时，建议发送并在重试中复用同一个值。

cURL
curl -X POST "https://revor.ai/api/v2/websets" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "北美地区的挖掘机制造商、经销商和租赁服务商",
    "title": "北美挖掘机企业",
    "count": 25,
    "target_kind": "company",
    "locale": "zh"
  }'

字段	类型	必填	限制
`query`	string	是	1-2000 字符，自然语言描述目标企业。
`title`	string	否	最多 200 字符。
`count`	integer	否	当前只能是 `25`，默认 `25`。
`target_kind`	string	否	当前只能是 `company`。
`locale`	string	否	`zh` 或 `en`，默认 `en`。

响应为 HTTP 202：

JSON
{
  "ok": true,
  "request_id": "req_xxx",
  "webset": {
    "id": "webset-uuid",
    "status": "generating_criteria",
    "count": 25,
    "target_kind": "company"
  },
  "preparation_job": {
    "id": "job-uuid",
    "status": "queued"
  }
}

保存响应中的 webset.id，后续用它查询这个 Target。preparation_job 只表示 Target 是否成功启动，不表示目标公司发现已经完成。

查询 Target 列表

GET/api/v2/websets

Query	默认值	限制	说明
`limit`	`20`	1-100	单页数量。
`cursor`	无	opaque string	使用上一页 `next_cursor`，不要解析或修改。
`target_kind`	无	`company` / `person`	可选过滤；创建接口当前只创建 company。

cURL
curl "https://revor.ai/api/v2/websets?limit=20" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME"

列表项包含 id、name、query、target_kind、status、progress 和时间字段。返回 has_more=true 时，将 next_cursor 作为下一次请求的 cursor。

查询 Target 进度

GET/api/v2/websets/{webset_id}

cURL
curl "https://revor.ai/api/v2/websets/WEBSET_ID" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME"

常见状态：

状态	说明
`generating_criteria`	正在理解目标公司条件。
`ready` / `queued`	已准备完成，等待开始查找。
`searching`	正在查找候选企业。
`verifying`	正在核验企业是否符合条件。
`completed`	已完成，可分页读取最终结果。
`failed`	执行失败，读取 `failure.code`。
`cancelled`	已取消。

progress 提供目标数量、已核验数量、符合条件数量和更新时间等进度信息。进行中的计数可能继续变化。

分页读取目标公司

GET/api/v2/websets/{webset_id}/items

Agent 平台推荐每次先读取 10 条精简结果：

cURL
curl "https://revor.ai/api/v2/websets/WEBSET_ID/items?match=qualified&detail=compact&limit=10" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME"

Query	默认值	说明
`limit`	`10`	单页数量，最大值由 `detail` 决定。
`cursor`	无	使用上一页返回的 cursor。
`match`	`qualified`	`qualified`、`full`、`partial`、`rejected`、`verified`。
`detail`	`compact`	`compact`、`standard` 或 `full`。

返回详细程度

模式	单页上限	返回内容
`compact`	50	公司名称、网站、行业、匹配状态和分数；适合连续翻页。
`standard`	25	增加企业公开信息和各项条件的判断结果。
`full`	10	增加逐项判断理由和参考链接；只建议对少量结果使用。

JSON
{
  "ok": true,
  "request_id": "req_xxx",
  "items": [
    {
      "id": "item-uuid",
      "target_kind": "company",
      "entity": {
        "name": "Example Equipment",
        "website": "https://example.com",
        "industry": "Construction Equipment"
      },
      "match": {
        "status": "full",
        "score": 91
      },
      "provisional": false
    }
  ],
  "detail": "compact",
  "next_cursor": null,
  "has_more": false,
  "webset_status": "completed"
}

查找过程中可以读取已核验的企业，此时会返回 provisional=true。需要稳定的最终名单时，应等待 Target 状态变为 completed，并持续翻页直到 has_more=false。