AI接入说明

龙虾开放平台提供 三种接入范式，满足从简单调用到复杂编排的不同需求。

范式	适用场景	特点	端点
标准 REST	自行实现业务逻辑	完全自主控制，传统 HTTP JSON API	`/open/v1/flight/search` 等
MCP 标准模式	Agent 单步调用查询工具	模型直接调工具，一问一答	`/open/v1/mcp`
Code Mode	Agent 编排多步 / 条件查询	模型写 JavaScript，在沙箱中编排业务能力	`/open/v1/mcp/code`

标准 REST

传统的 HTTP JSON API 调用方式。

适合：自己实现业务逻辑、自建搜索 / 推荐 / 差旅管理系统的开发者。

鉴权：HMAC-SHA256 签名或 Bearer Token。

MCP 标准模式

MCP（Model Context Protocol） 是 Anthropic 推出的标准协议，让 AI Agent 通过 JSON-RPC 2.0 调用工具。

龙虾开放平台在 /open/v1/mcp 端点实现了 MCP "Streamable HTTP" 传输，将机票、酒店、打车、高铁、巴士等业务能力封装为 MCP 工具。

何时选择

Agent 单步调用：每个问题只需调一次接口（如「明天深圳到北京的航班」→ 调 flight.search）。

直接集成 Claude Desktop / MCP Inspector：兼容标准 MCP 客户端。

简单查询：不需要条件判断、循环、多步编排。

关键特性

JSON / SSE 双模式：Accept: application/json → 一次性响应；Accept: text/event-stream → SSE 流式推送。

工具清单：调用 initialize 拿到 tools/list，包含每个工具的 name / description / inputSchema。

统一鉴权：复用标准 REST 的 HMAC 签名或 Bearer Token。

工具列表（最新）

工具名	用途
`flight.search`	航班列表查询
`flight.airport_search`	机场搜索
`flight.pricing`	机票验价
`flight.order_create`	创建机票订单
`flight.order_pay`	发起支付
`flight.order_detail`	订单详情
`flight.order_list`	订单列表
`flight.order_cancel_fee`	查询取消手续费
`flight.order_cancel`	取消 / 退票
`hotel.search`	酒店列表查询
`hotel.rooms`	酒店房型详情
`hotel.order_create`	创建酒店订单
`taxi.estimate`	打车估价
`train.search`	高铁查询
`bus.search`	城际巴士查询

Code Mode

Code Mode 是龙虾开放平台的编排增强模式，让 Agent 写一段 JavaScript 在沙箱中执行，调用 rideclaw.<domain>.<action>() 方法完成多步、条件、循环查询。

何时选择

多步编排：「先查明天的航班，如果超过 2000 元就查后天的」。

条件判断：根据上一步结果决定下一步逻辑。

中间数据优化：几十个航班留在沙箱里筛选，只返回最终推荐结果，节省 Agent 上下文。

复杂场景：比价、组合查询（往返航班 + 酒店）、多供应商聚合。

关键特性

沙箱隔离：无网络、无文件、无 require/import，唯一 I/O 是注入的 rideclaw.* 能力。

顶层 await：脚本自动包裹为 async IIFE，直接写 await rideclaw.flight.search(...)。

限制：单次执行最多 20 个能力调用，30 秒超时（适配真实 API 调用耗时）。

调试友好：console.log() 输出会随结果返回，Agent 可自我修正错误。

示例

如何选择

┌─────────────────────────────────────────────────────────────┐
│  需要自己实现业务逻辑 / 已有系统？                            │
│  ✅ → 标准 REST                                               │
└─────────────────────────────────────────────────────────────┘
                        ↓ 否
┌─────────────────────────────────────────────────────────────┐
│  Agent 单步调用，简单查询？                                  │
│  ✅ → MCP 标准模式（/open/v1/mcp）                            │
└─────────────────────────────────────────────────────────────┘
                        ↓ 否
┌─────────────────────────────────────────────────────────────┐
│  需要多步编排 / 条件判断 / 循环？                            │
│  ✅ → Code Mode（/open/v1/mcp/code）                          │
└─────────────────────────────────────────────────────────────┘

不确定？建议从 MCP 标准模式起步，遇到编排需求时再切换到 Code Mode（两者共用鉴权与 service，无迁移成本）。

标准 REST#

MCP 标准模式#

何时选择#

关键特性#

工具列表（最新）#

Code Mode#

何时选择#

关键特性#

示例#

如何选择#

标准 REST

MCP 标准模式

何时选择

关键特性

工具列表（最新）

Code Mode

何时选择

关键特性

示例

如何选择