工具使用（Tool Use）：让 AI 从会聊天变成能办事

查一下订单状态
获取实时天气
读取数据库
调用库存接口
生成工单
查询物流
触发审批流程

如果答案依赖实时数据、私有数据、精确计算或真实动作，就考虑工具。
如果只是解释、归纳、改写，通常不需要工具。

我昨天买的耳机怎么还没发货？

{
  "name": "get_order_status",
  "description": "根据订单号查询订单状态、物流状态和预计发货时间。",
  "parameters": {
    "type": "object",
    "properties": {
      "order_id": {
        "type": "string",
        "description": "用户订单号"
      }
    },
    "required": ["order_id"]
  }
}

我可以帮你查订单状态，请发一下订单号。

{
  "tool": "get_order_status",
  "arguments": {
    "order_id": "A123456"
  }
}

{
  "order_id": "A123456",
  "status": "paid",
  "shipping_status": "not_shipped",
  "estimated_ship_date": "2026-06-25"
}

我查到你的订单 A123456 已付款，目前还未发货，预计 6 月 25 日发出。

TOOLS = {
    "get_order_status": get_order_status,
    "cancel_order": cancel_order,
}
 
REQUIRED_ARGS = {
    "get_order_status": ["order_id"],
    "cancel_order": ["order_id", "reason"],
}
 
 
def execute_tool_call(tool_call, user):
    tool_name = tool_call.get("tool")
    arguments = tool_call.get("arguments", {})
    request_id = tool_call.get("request_id")
 
    if tool_name not in TOOLS:
        return {
            "status": "error",
            "code": "unknown_tool",
            "message": "工具不存在",
        }
 
    missing = [
        name for name in REQUIRED_ARGS[tool_name]
        if not arguments.get(name)
    ]
 
    if missing:
        return {
            "status": "need_more_info",
            "missing": missing,
            "message": "需要补充必要参数",
        }
 
    if tool_name == "cancel_order" and not user.has_confirmed:
        return {
            "status": "need_confirmation",
            "message": "取消订单前需要用户确认",
        }
 
    if request_id and is_duplicate_request(request_id):
        return {
            "status": "ignored",
            "code": "duplicate_request",
            "message": "重复请求已忽略",
        }
 
    try:
        result = call_with_timeout(TOOLS[tool_name], arguments, seconds=10)
    except TimeoutError:
        result = {
            "status": "error",
            "code": "tool_timeout",
            "message": "工具执行超时，请稍后重试",
        }
 
    log_tool_call({
        "user_id": user.id,
        "tool": tool_name,
        "request_id": request_id,
        "arguments": arguments,
        "status": result.get("status", "success"),
    })
 
    return result

模型可以建议调用工具；
程序必须决定能不能调用；
危险动作必须让人确认。

查询订单状态 + 查询物流状态 + 查询售后规则
  ↓
汇总后回复用户

工具使用不是让 AI 直接操作世界，而是让 AI 提出结构化调用请求，再由程序安全执行。