曹操出行MCP开发手册

地址搜索

工具名称

maps_text_poi

工具描述

当用户表达想要前往某个具体地点时，使用本工具来获得地点的经纬度。

根据用户传入的关键词和城市，获取地点经纬度，用于后续生成打车订单使用。

注意：如果用户未明确表达出发点，请务必先询问出发点后再进行搜索，不要做任何的假设！

如果根据用户描述的需求，返回了多个地点（例如有多个肯德基门店），且多个地点之间间隔较远，全部返回给用户确认，必须精准唯一的起终点。如果返回结果仍旧存在多个地点，不断的追问用户具体地点，直到起终点均仅仅保留一个时为止。不要推测起终点，不要尝试可能的起终点。

入参定义（inputScheme）

字段名称	类型	必填	说明
keywords	string	是	搜索关键词
cityName	string	否	城市名称

生成打车链接

工具名称

trip_generate_ride_link

工具描述

根据用户选择的起点、终点和品类，生成微信小程序的打车链接，可复制到浏览器里打开微信小程序使用。

入参定义（inputSchema）

字段名称	类型	必填	说明
fromLat	string	是	出发地纬度
fromLng	string	是	出发地经度
fromName	string	否	出发地名称
toLat	string	是	目的地纬度
toLng	string	是	目的地经度
toName	string	否	目的地名称

网约车预估

工具名称

trip_estimate_v2

工具描述

当用户前往某个地点时，根据起点查看可选择的打车品类以及预估价格。请先使用maps_text_poi获取起终点的经纬度，再使用本工具查询品类。修改目的地预估时，入参必须传updateScene字段,不用传startLocation。

在返回预估信息的时候，不要增加其他信息（不要增加特点，不要推荐），仅保留车型及价格即可，让用户选择。

入参定义（inputSchema）

字段路径	类型	必填	说明
startLocation	object	否	起点位置信息
endLocation	object	否	终点位置信息
middleLocation	array	否	途径点位置列表
orderType	integer	否	订单类型：1：实时单，2：预约单，
useTime	integer	否	用车时间（时间戳），实时单为当前时间，预约单为指定时间
callOrderServiceType	string	否	预估叫单品类，多车型时用英文逗号分隔，不要带空格，不传默认预估推荐品类
whoTel	String	否	为他人叫车，乘车人的手机号
remark	String	否	用户乘车备注
preferences	array	否	用户乘车偏好。可选值：highSpeed-开快一点；steadyDrive-开稳一点；coolTemp-偏冷一点；normalTemp-标准温度；warmTemp-偏暖一点；customMusic-个性歌单；popMusic-流行音乐；rockMusic-摇滚音乐；lightMusic-轻音乐；preRefreshAir-提前换气；noSmallTalk-司机不要主动攀谈；hazardLights-双闪；noCall-无需电联；fastestRoute-路线偏好-时间短；smartRoute-路线偏好-智能推荐；cheapestRoute-路线偏好-价格低
routeTags	array	否	路线标签：cheaperRoute-价格低的路线；fasterRoute-快速的路线；otherRoute-其他路线
updateScene	array	否	更新场景：modifyDestination-修改目的地、途径点；selectRoute-选路线；modifyStartLocation-修改起点；addServiceType-追加品类（车型）；modifyUseTime-修改预约时间；addPreferenceRemark-追加偏好和备注。modifyDestination、selectRoute、modifyStartLocation、addServiceType、modifyUseTime相互独立，可与addPreferenceRemark进行组合
orderNo	string	否	订单号，更新场景下用
tripScene	array	否	出行场景，系统会根据场景，进行品类和服务推荐。

网约车查询

工具名称

trip_query_order_v2

工具描述

查询进行中的打车订单信息，例如车牌号、司机联系方式、司机接驾距离、预估到达时间等等。没有orderNoList时，自动查询用户全部行程中订单。

入参定义（inputSchema）

字段名称	类型	必填	说明
orderNoList	array	否	订单号列表，不传则查全部行程中订单。

网约车叫单

工具名称

trip_create_order_v2

工具描述

根据用户选择的起点、终点和品类，直接创建打车订单并寻找司机接驾，不用打开app或小程序，自动进行打车订单流程。

用户必须主动回复选择的车型后，才能使用本工具进行叫车。

入参定义（inputSchema）

字段名称	类型	必填	说明
estimateId	string	是	预估流程ID，从预估结果中获取
callOrderServiceType	string	否	叫单品类标识，从预估结果中获取，传入多个车型时，用英文逗号分割，不要带空格。

网约车更新订单

工具名称

trip_update_order

工具描述

在创建订单之后，如果希望对订单里的信息进行修改（例如修改上下车点、修改路线等），可使用此工具更新订单，更新之前需要进行预估，拿到最新的价格与用户确认。

入参定义（inputSchema）

字段路径	类型	必填	说明
estimateId	String	是	更新订单的预估流程ID，从预估结果中获取
orderNo	string	是	要修改的订单号

网约车取消

工具名称

trip_cancel_order_v2

工具描述

取消打车订单，使用此工具时必须先查看caocaoMCP的skill中的说明。

入参定义（inputSchema）

字段名称	类型	必填	说明
orderNo	string	是	订单号
userConfirm	boolean	否	true 表示用户确认取消，false 表示需要取消确认

拉账单

工具名称

trip_pull_bill

工具描述

查询订单的费用明细账单，包括各项费用和优惠详情

入参定义（inputSchema）

字段名称	类型	必填	说明
orderNo	string	是	订单号
couponNo	string	否	优惠券编号，不使用优惠传递-1

给司机留言

工具名称

trip_send_driver_message

工具描述

给司机留言，给司机发消息

入参定义（inputSchema）

字段名称	类型	必填	说明
orderNo	string	是	订单号
message	string	是	消息内容

联系客服

工具名称

trip_contact_customer_service

工具描述

联系客服

入参定义（inputSchema）

字段名称	类型	必填	说明
action	string	是	操作类型，getPhone 获取客服电话，createTicket 创建客服工单

删除订单

工具名称

trip_delete_order

工具描述

评价司机删除订单

入参定义（inputSchema）

字段名称	类型	必填	说明
orderNo	string	是	订单号

开发票

工具名称

trip_create_invoice

工具描述

开发票

入参定义（inputSchema）

字段名称	类型	必填	说明
orderNos	array	是	订单列表
invoiceType	string	是	发票类型：personal 个人，company 公司
invoiceTitle	string	否	发票抬头（公司发票时需要）
taxNumber	string	否	税号（公司发票时需要）
email	string	是	接收发票的邮箱
remark	string	否	备注信息
connactName	string	否	联系人姓名，个人开票的抬头
connactPhone	string	否	联系人电话

联系司机

工具名称

trip_call_driver

工具描述

联系司机

入参定义（inputSchema）

字段名称	类型	必填	说明
orderNo	string	是	订单号

评价司机

工具名称

trip_rate_driver

工具描述

评价司机

入参定义（inputSchema）

字段名称	类型	必填	说明
orderNo	string	是	订单号
rating	integer	是	满意度 1-满意 2-不满意
reason	string	否	备注或留言

查询历史订单

工具名称

trip_query_history_orders

工具描述

查询历史订单

入参定义（inputSchema）

字段名称	类型	必填	说明
startDate	number	否	查询的开始日期（用车时间，可选）。不传则默认查询最近 30 天(毫秒级时间戳)
endDate	number	否	查询的结束日期（用车时间，可选）。不传则默认到当前时间(毫秒级时间戳)
startLocation	string	否	起点地点
endLocation	string	否	终点地点
minPrice	number	否	最低价格(单位:分)
maxPrice	number	否	最高价格(单位:分)
limit	integer	否	返回数量限制，默认200