大模型应用开发 / 系统课时
调用业务工具查询订单状态
调用业务工具查询订单状态
这一节把“查订单”从模型猜答案改成受控工具调用:模型只负责选择工具和组织语言,服务端负责身份校验、参数约束与业务接口访问,最终只把必要的只读结果交回模型。
学习目标
- 定义稳定、最小化的订单查询工具参数与返回结构
- 把身份校验和订单归属校验放在服务端,而不是交给模型判断
- 限制模型可见字段,避免直接访问数据库或泄露内部数据
把模型放在业务接口之外
智能客服需要实时订单状态时,RAG 不够用:知识库能回答“配送规则是什么”,却不知道某个用户的订单现在处于哪一步。正确边界不是给模型数据库连接,而是提供一个受控的只读工具。
请求链路应当是:用户提出查询 → 模型产生结构化工具参数 → 服务端从登录态取得用户身份并校验参数 → 服务端调用订单域 API → 过滤内部字段 → 模型把结果组织成自然语言。模型既不持有数据库凭据,也不能自行指定“替谁查询”。

定义最小工具契约
查询工具应只接受业务上必要且能校验的参数。例如按订单号查询时,模型只需要提交 order_id。返回结果也只保留客服回答需要的字段,如订单号、状态和物流摘要;数据库主键、风控标签、内部备注都不应进入模型上下文。
下面用一个可直接运行的 Python 示例模拟工具网关。订单数据用内存字典代替真实订单 API,重点是边界和校验顺序。
from typing import Any
ORDERS = {
"A100": {"owner": "u-7", "status": "shipped", "carrier": "DHL", "internal_risk": "low"},
"A200": {"owner": "u-8", "status": "paid", "carrier": None, "internal_risk": "review"},
}
def query_order_tool(tool_args: dict[str, Any], authenticated_user_id: str) -> dict[str, Any]:
order_id = tool_args.get("order_id")
if not isinstance(order_id, str) or not order_id.startswith("A"):
return {"ok": False, "code": "INVALID_ORDER_ID", "message": "订单号格式不正确"}
order = ORDERS.get(order_id)
if order is None:
return {"ok": False, "code": "ORDER_NOT_FOUND", "message": "未找到该订单"}
# 归属校验使用服务端可信身份,不能让模型传入 owner 绕过检查。
if order["owner"] != authenticated_user_id:
return {"ok": False, "code": "FORBIDDEN", "message": "无权查询该订单"}
# 只返回回答所需字段,internal_risk 等内部字段不会进入模型上下文。
return {
"ok": True,
"order": {
"order_id": order_id,
"status": order["status"],
"carrier": order["carrier"],
},
}
print(query_order_tool({"order_id": "A100"}, authenticated_user_id="u-7"))
print(query_order_tool({"order_id": "A200"}, authenticated_user_id="u-7"))预期输出
{'ok': True, 'order': {'order_id': 'A100', 'status': 'shipped', 'carrier': 'DHL'}}
{'ok': False, 'code': 'FORBIDDEN', 'message': '无权查询该订单'}真实环境中,把 ORDERS.get() 替换成订单服务的 HTTP 或 RPC 调用即可;身份仍应来自服务端认证上下文,并在订单服务或工具网关再次做资源归属校验。
让模型只消费业务结果
工具返回结构最好稳定区分成功与失败。成功时给模型最少业务字段,失败时返回可解释的业务错误码和用户可见原因。模型可以把 shipped 转成“订单已发货”,但不能把不存在的预计送达时间补出来。
如果下游接口超时,也不要把堆栈、SQL、内部主机名直接交给模型。服务端应映射成统一错误,例如 ORDER_SERVICE_UNAVAILABLE,再由模型回答“暂时无法查询,请稍后重试”。
验收边界
上线前至少验证三类请求:本人订单能查到,只返回允许字段;他人订单被拒绝;不存在或格式错误的订单号得到明确错误。还应检查模型产生额外参数时服务端会忽略或拒绝,而不是把这些参数直接拼进 SQL 或内部 API。
只读查询工具的关键不是“让模型能调用订单系统”,而是把模型限制在一个窄而可审计的契约里:模型提出结构化意图,服务端决定身份、权限和真实数据访问。