// ❌ 反面：模型根本不知道啥时候用、city 该填啥格式
{ "name": "weather", "description": "天气",
  "parameters": {"properties": {"city": {"type": "string"}}} }

// ✅ 正面：触发场景清楚、参数有格式示例、边界说明
{ "name": "get_weather",
  "description": "查询指定城市当前天气。当用户询问天气、气温、冷热、是否下雨、要不要带伞时调用；仅支持中国城市。",
  "parameters": {"type": "object",
    "properties": {
      "city": {"type": "string",
               "description": "城市名，不带'市'字，如 北京、上海、杭州"}},
    "required": ["city"]} }

SUPPORTED = {"北京", "上海", "杭州", "武汉"}   # 白名单：只认这些城市

def get_weather(city: str = ""):
    # 1) 校验：必填、非空、在支持范围内
    if not city or not isinstance(city, str):
        return {"ok": False, "error": "缺少参数 city（城市名）"}
    city = city.strip().replace("市", "")      # 容错：去空格、去"市"字
    if city not in SUPPORTED:
        return {"ok": False,
                "error": f"暂不支持城市「{city}」，仅支持：{','.join(SUPPORTED)}"}
    # 2) 校验通过，才真正干活
    return {"ok": True, "city": city, "temp": 3, "desc": "晴"}

import requests

def get_weather(city):
    try:
        # 假设调真实天气 API（可能超时、可能返回 500）
        r = requests.get("https://api.example.com/w", params={"city": city}, timeout=5)
        r.raise_for_status()
        return {"ok": True, "data": r.json()}
    except requests.Timeout:
        return {"ok": False, "error": "天气服务超时，请稍后重试"}   # 不抛，返回
    except Exception as e:
        # 兜底：任何意外都变成结构化错误，绝不让异常炸出去
        return {"ok": False, "error": f"查询失败：{type(e).__name__}"}

✋ 动手 10 分钟：把"裸工具"改造成"安全工具"

零依赖零成本。下面是一个"裸"的转账工具,请你按今天五条原则给它加上防护(校验参数 + 结构化错误 + 幂等去重):

# ❌ 改造前：没校验、会崩、会重复转账
# def transfer(to, amount): bank[to] += amount

_done = set()               # 记录处理过的请求 id（幂等用）
bank = {"小明": 0}

def transfer(req_id="", to="", amount=0):
    # ① 参数校验
    if not req_id or not to:
        return {"ok": False, "error": "缺少 req_id 或 to"}
    if not isinstance(amount, (int, float)) or amount <= 0:
        return {"ok": False, "error": "amount 必须是正数"}
    if to not in bank:
        return {"ok": False, "error": f"收款人「{to}」不存在"}
    # ② 幂等：同一个 req_id 只执行一次
    if req_id in _done:
        return {"ok": True, "note": "该请求已处理过（幂等，未重复转账）"}
    # ③ 真正执行
    bank[to] += amount
    _done.add(req_id)
    return {"ok": True, "to": to, "balance": bank[to]}

print(transfer("R1", "小明", 100))   # {'ok': True, 'to': '小明', 'balance': 100}
print(transfer("R1", "小明", 100))   # 重复 R1 → 不再加钱（幂等生效）
print(transfer("R2", "小红", 50))    # 收款人不存在 → 结构化错误，不崩

挑战:再给它加一句"金额 > 10000 时返回 {'ok': False, 'need_approval': True}",模拟"危险动作要审批"。