通过 ttpos-agent API 查询 TTPOS 餐饮系统营业数据,生成报表。使用前必须访问 GET /api/v1/query/guide 获取数据查询指南。Use when: 今日营业额、订单统计、支付方式、菜品排行、会员分析、班次汇总、时段分析等。NOT for: 与 TTPOS 数据无关的问题。
通过 ttpos-agent HTTP API 查询 TTPOS 餐饮系统数据,生成营业报表、订单统计、支付分析等。
在构造任何 SQL 或调用 API 之前,必须先访问接口获取数据查询指南:
GET {LIGHT_BRIDGE_URL}/api/v1/query/guide
请求头需带 Authorization: Bearer $LIGHT_BRIDGE_API_KEY。返回的 Markdown 包含:多租户架构、订单/商品/桌台/会员/班次/统计表结构、时间与金额约定、常用查询模式、常见陷阱。不获取此指南会导致表名错误、字段误用、统计重复。
| 配置项 | 必填 | 说明 |
|---|---|---|
| LIGHT_BRIDGE_API_KEY | ✅ | 在 ttpos-agent Web 面板 创建,在技能面板保存 |
GET {LIGHT_BRIDGE_URL}/api/v1/query/guide,理解数据模型与查询规范GET {LIGHT_BRIDGE_URL}/api/v1/query/companies,确认可用的 company_uuidPOST {LIGHT_BRIDGE_URL}/api/v1/query/execute,Body: {"company_uuid": xxx, "sql": "SELECT ..."}curl -s -H "Authorization: Bearer $LIGHT_BRIDGE_API_KEY" \
"$LIGHT_BRIDGE_URL/api/v1/query/guide"
curl -s -H "Authorization: Bearer $LIGHT_BRIDGE_API_KEY" \
"$LIGHT_BRIDGE_URL/api/v1/query/companies"
curl -s -X POST "$LIGHT_BRIDGE_URL/api/v1/query/execute" \
-H "Authorization: Bearer $LIGHT_BRIDGE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"company_uuid": 8267304538112000, "sql": "SELECT ..."}'
curl -s -H "Authorization: Bearer $LIGHT_BRIDGE_API_KEY" \
"$LIGHT_BRIDGE_URL/api/v1/query/schema?company_uuid=8267304538112000"
platform、order_state、eater_payment、accepted_time 等数据库字段名;改用「平台」「订单状态」「订单金额」「接单时间」等中文表述order_state(0/10/20/30/40/50/60)、platform_order_state(DELIVERED/CANCELLED 等) 必须译为中文(如:已完成、已取消、已送达、骑手已到店);platform 的 grab/lineman 等译为 Grab、LINE MANWHERE delete_time = 0若 API 返回 401 或缺少 LIGHT_BRIDGE_API_KEY:
只回复:「请在技能面板的 API key 输入框中保存你的 ttpos-agent API Key。API Key 在 ttpos-agent Web 面板(登录后)创建。」
配置完成后 使用 "/clear" 新建会话 再立即继续用户原来的请求。