如何為 AI 代理建立天氣工具?
AI 代理無法走到戶外,也不知道你身在何處。天氣工具用一次呼叫同時解答這兩個 問題。互聯網上每部裝置都有一個號碼,稱為 網際網路協定(IP)位址,而這個 號碼登記在某個地區,所以一個查詢服務可以把它轉成大約的位置 — 只到城市, 不會到街道。工具接著向免費天氣服務查詢該城市目前的氣溫。兩個服務都毋須 註冊或金鑰。
工具
這是 tool02_weather.py 目前的內容:
# https://open-meteo.com/
import requests
def get_weather_from_ip():
"""
Get the current temperature in Celsius for the user's location
using the IP address and return it as a string.
"""
location = requests.get("https://ipinfo.io/json", timeout=10).json()
latitude, longitude = location["loc"].split(",")
params = {
"latitude": latitude,
"longitude": longitude,
"current": "temperature_2m",
"temperature_unit": "celsius",
"timezone": "auto",
}
weather_data = requests.get(
"https://api.open-meteo.com/v1/forecast",
params=params,
timeout=10,
).json()
return f"Current: {weather_data['current']['temperature_2m']}°C"
result = get_weather_from_ip()
print(result)
每一部分的作用
requests是這裡唯一的外部程式庫,並不屬於 Python 本身。它 列在專案的pyproject.toml內,所以uv sync會替 你安裝。- 第一次呼叫去 ipinfo.io。它以一個小
JSON物件回覆: 純文字,把資料存成一個一個有標籤的值,例如{"city": "Hong Kong"},程式可以逐個欄位讀取。loc把緯度和經度存成一個字串,"22.3193,114.1694",所以程式以逗號 把它分開。 - 這個位置來自對外 IP 位址,所以只準確到城市,不會到街道。對天氣問題來說 已經足夠。這個呼叫也會把你的對外 IP 位址送到 ipinfo.io,那是唯一離開你 電腦的個人資料。
- 第二次呼叫去 Open-Meteo。
params讓問題變得 精確:只要當前狀況、離地兩米的氣溫、以攝氏表示,時區則取自座標。 timeout=10出現兩次。沒有它,網絡一慢,代理就會一直等不到 答案。有了它,每次呼叫十秒後就放棄,並拋出錯誤,而不是掛住。- 函數回傳的是一句句子,不是 JSON 物件:
Current: 24.6°C。 模型得到的是可以直接引用的文字。 - 最後兩行呼叫函數並印出結果,讓你在還未牽涉任何代理之前,就可以在終端機 檢查這個工具。
在自己的電腦上執行
下載 zip 檔案並
解壓到一個資料夾。zip 內有 tool02_weather.py、
pyproject.toml 和 README.md。在 Visual Studio Code
開啟這個資料夾,然後在終端機執行以下兩條指令:
uv sync
uv run tool02_weather.py
uv sync 只需要第一次執行。它會建立一個本地環境,只裝這個專案
需要的一個套件,不會裝到電腦其他地方。
你應該會看到一行,例如 Current: 24.6°C。跟你手機上的天氣應用
比較一下。
如果這一行始終沒有出現,原因幾乎總是以下三種之一:沒有連接互聯網、IP 位址 被 ipinfo.io 限制了請求頻率,或者 Open-Meteo 短暫未能提供服務。兩個服務對 輕量使用都是免費的,這也是它們適合課堂的原因;但免費也意味著沒有正常運行 時間的保證。
為甚麼這是好的起步工具
- 只讀:它讀取公開資料,不會改動任何東西。
- 容易核對:任何天氣應用都可以給你第二個意見。
- 即時有用:「要帶傘嗎?」變成代理可以用事實回答的問題。
延伸閱讀
- Open-Meteo — 介面文件 — 可以要求的當前、每小時與每日變數完整清單。
- ipinfo.io — 開發者文件 — 位置回應中的各個欄位,以及沒有金鑰時的請求頻率限制。
- requests — 文件 — HTTP 呼叫的逾時、參數與錯誤處理。