大模型应用开发 / 系统课时

调用业务工具查询订单状态

调用业务工具查询订单状态

这一节把“查订单”从模型猜答案改成受控工具调用:模型只负责选择工具和组织语言,服务端负责身份校验、参数约束与业务接口访问,最终只把必要的只读结果交回模型。

学习目标

  • 定义稳定、最小化的订单查询工具参数与返回结构
  • 把身份校验和订单归属校验放在服务端,而不是交给模型判断
  • 限制模型可见字段,避免直接访问数据库或泄露内部数据

把模型放在业务接口之外

智能客服需要实时订单状态时,RAG 不够用:知识库能回答“配送规则是什么”,却不知道某个用户的订单现在处于哪一步。正确边界不是给模型数据库连接,而是提供一个受控的只读工具。

请求链路应当是:用户提出查询 → 模型产生结构化工具参数 → 服务端从登录态取得用户身份并校验参数 → 服务端调用订单域 API → 过滤内部字段 → 模型把结果组织成自然语言。模型既不持有数据库凭据,也不能自行指定“替谁查询”。

订单查询工具的受控数据流

定义最小工具契约

查询工具应只接受业务上必要且能校验的参数。例如按订单号查询时,模型只需要提交 order_id。返回结果也只保留客服回答需要的字段,如订单号、状态和物流摘要;数据库主键、风控标签、内部备注都不应进入模型上下文。

下面用一个可直接运行的 Python 示例模拟工具网关。订单数据用内存字典代替真实订单 API,重点是边界和校验顺序。

python
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"))

预期输出

text
{'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。

只读查询工具的关键不是“让模型能调用订单系统”,而是把模型限制在一个窄而可审计的契约里:模型提出结构化意图,服务端决定身份、权限和真实数据访问。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

调用业务工具查询订单状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通