五工具快速接入

本页面向大模型应用、智能体平台和开发者，只描述当前最稳的五个只读工具。不要把后台、发布、联系、导出或旧聚合工具暴露给模型。

当前五工具

getLiyuCapabilities  能力自检，只读
smartRideSearch      自然语言查车，只读
searchRides          结构化查车，只读
getRideDetail        单条公开详情，只读
searchGroups         官方拼车群入口，只读

工具选择

用户问“能做什么 / 先自检” -> getLiyuCapabilities
用户自然语言问某天某路线有没有车 -> smartRideSearch
用户已经给出 departure/destination/type/date -> searchRides
用户给出 info_id 查详情 -> getRideDetail
用户找拼车群、官方群、群入口 -> searchGroups
用户要求发布、联系、订座、导出联系方式 -> 不调用工具，做边界回复

请求示例

自然语言查车：

POST /lypinche/smart
Content-Type: application/json

{"query":"明天济南到北京有没有顺风车","page_size":3}

结构化查车：

POST /lypinche/search
Content-Type: application/json

{"departure":"济南","destination":"北京","page":1,"page_size":3}

公开详情：

GET /lypinche/pcdetail?info_id=259334

官方拼车群入口：

GET /lypinche?action=groups&version=v1&keyword=曹县青岛拼车群&limit=3&include_detail=0

能力自检：

GET /lypinche/capabilities

默认上限

DEFAULT_PAGE_SIZE 3
MAX_SAFE_PAGE_SIZE 5
GROUP_INCLUDE_DETAIL 0
GROUP_DELIVERY entry_page_url

模型回答应该短而准。列表结果优先展示 1 到 3 条；用户明确要求更多时最多取 5 条，不做批量导出。

结果解释

优先使用结构化字段：

code,message,data,meta,request_id
items,total,has_more
validity_type,validity_label,validity_note
next_action,reply,rendered_answer
entry_page_url,no_raw_qr_asset

回答时必须说明有效性边界：长期/定期有效、一次性未来出发、无当前结果、需要用户自行核实时间/路线/费用。

红线

NO_PUBLISH 1
NO_CONTACT_USER 1
NO_BOOKING 1
NO_PAYMENT 1
NO_BULK_EXPORT 1
NO_FULL_PRIVATE_CONTACT 1
NO_RAW_QR_ASSET 1
NO_INTERNAL_PATH 1
NO_PUBLIC_ADOPTION_CLAIM_WITHOUT_EVIDENCE 1

推荐回复形态

有结果：

为你查到 N 条公开拼车信息。优先展示路线、时间、类型、座位、有效性说明和安全提醒。联系方式按接口返回的脱敏字段处理，不补全隐藏信息。

无结果：

当前没有查到明确可用结果。可以改查相邻时间/地点，或查看里鱼拼车官方中转页提供的相关拼车群入口。

群入口：

提供 entry_page_url，让用户打开官方中转页查看群入口和群规范。不要输出原始二维码文件路径。

越权请求：

当前 API 只提供只读查询，不能代发布、代联系、代订座或导出联系方式。