| name | agentrs-weather |
| description | 天气查询工具 —— 通过京东 agentrs 代理网关调用高德天气，返回城市实况(气温/天气/湿度/风力) 或未来预报。支持直接传高德 adcode，也支持传城市名/地址自动解析 adcode。当用户问某地天气、 气温、今天/明天下不下雨、出门带不带伞、未来几天天气这类问题时使用。 触发词：天气、气温、下雨、温度、湿度、风力、今天天气、明天天气、未来天气、weather、带伞。
|
agentrs-weather —— 高德天气（实况 / 预报）
通过 https://agentrs.jd.com/api/saas/proxy-k/v1/weather_inquiry 查高德天气。
鉴权与调用约定（先读）
- 环境变量取密钥，不硬编码：
export JD_AGENTRS_TOKEN='你的token'
- 网关只认 JSON body（query string 不生效）；HTTP 恒 200，业务看 body：
1001=未授权 / 9999 缺少必要输入参数=参数错 / 9999 用户积分不足=余额不足（重试常能通）。
关键：入参是 adcode
高德天气的 city 参数是高德 adcode（如北京=110100），不是经纬度，也不是和风天气的 LocationID。
本 skill 的脚本内置「城市名→adcode」自动解析（借地理编码），所以两种方式都行：
- 已知 adcode：
--city 110100
- 只知城市名：
--address 北京 / --address 上海市黄浦区（自动解析）
| 入参 | 说明 |
|---|
city | 高德 adcode（与 address 二选一） |
address | 城市名/地址，脚本自动解析成 adcode |
extensions | base=实况(默认) / all=预报 |
返回 lives[]（实况）含 weather/temperature/humidity/winddirection/windpower/reporttime；
extensions=all 时返回 forecasts[] 未来数日预报。
用法
export JD_AGENTRS_TOKEN='...'
python3 scripts/weather.py --city 110100
python3 scripts/weather.py --city 110100 --extensions all
python3 scripts/weather.py --address 上海市黄浦区
打印规整 JSON；遇 1001/9999 在 stderr 给可读提示。
直接 curl（需先有 adcode）
curl -s https://agentrs.jd.com/api/saas/proxy-k/v1/weather_inquiry \
-X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer $JD_AGENTRS_TOKEN" \
-d '{"city":"110100","extensions":"base"}'
adcode/经纬度/POI/路径 等地图地理能力见姊妹 skill agentrs-map；
联网搜索见 agentrs-search。三者共用同一个 JD_AGENTRS_TOKEN。
