Spaces:
Sleeping
Sleeping
README.md
Browse files
README.md
DELETED
|
@@ -1,144 +0,0 @@
|
|
| 1 |
-
|
| 2 |
-
|
| 3 |
-
---
|
| 4 |
-
|
| 5 |
-
2
|
| 6 |
-
|
| 7 |
-
- title: LINE Earthquake Bot
|
| 8 |
-
|
| 9 |
-
3
|
| 10 |
-
|
| 11 |
-
- sdk: docker
|
| 12 |
-
|
| 13 |
-
4
|
| 14 |
-
|
| 15 |
-
- app_port: 7860
|
| 16 |
-
|
| 17 |
-
5
|
| 18 |
-
|
| 19 |
-
- ---
|
| 20 |
-
|
| 21 |
-
|
| 22 |
-
|
| 23 |
-
|
| 24 |
-
# LINE 多功能地震資訊與 AI 助理機器人
|
| 25 |
-
|
| 26 |
-
這是一個部署在 Hugging Face Spaces 上的多功能 LINE Bot。它整合了來自台灣中央氣象署 (CWA) 和美國地質調查局 (USGS) 的地震資訊，並搭載了 Google 最新的 `gemini-1.5-flash` 模型，使其具備強大的 AI 對話與工具呼叫能力。
|
| 27 |
-
|
| 28 |
-
使用者不僅可以透過簡易指令查詢即時的地震報告與預警，還能用自然語言（例如：「幫我找找昨天規模5以上的地震」）與 AI 互動，AI 會自動呼叫外部工具來查詢資料庫，並提供分析後的智慧回答。
|
| 29 |
-
|
| 30 |
-
## ✨ 主要功能 (Key Features)
|
| 31 |
-
|
| 32 |
-
* **即時地震報告**: 提供來自 CWA 的最新顯著有感地震報告（含圖）及最近7天的地震列表。
|
| 33 |
-
* **全球地震監控**: 整合 USGS 數據，提供全球近24小時及台灣區域的顯著地震資訊。
|
| 34 |
-
* **地震預警速報**: 串接 CWA 地震預警 API，提供最新的地震速報。
|
| 35 |
-
* **智慧 AI 助理**: 搭載 Google Gemini 1.5 Flash 模型，提供流暢的中文對話能力。
|
| 36 |
-
* **AI 工具呼叫 (Tool Calling)**:
|
| 37 |
-
* AI 能夠理解複雜的自然語言問題。
|
| 38 |
-
* 自動呼叫外部的地震資料查詢工具 (MCP-2 Gradio App)。
|
| 39 |
-
* 分析工具回傳的 JSON 資料，並生成人類易於理解的總結性回答。
|
| 40 |
-
* **多樣化指令**: 支援 `#` 數字快捷指令，方便使用者快速取用特定功能。
|
| 41 |
-
|
| 42 |
-
## 🚀 功能展示 (Demo)
|
| 43 |
-
|
| 44 |
-
**基本指令查詢:**
|
| 45 |
-
*<-- 建議在此處插入使用 #1, #5, #6 等指令的對話截圖 -->*
|
| 46 |
-
|
| 47 |
-
**AI 自然語言查詢 (工具呼叫):**
|
| 48 |
-
*<-- 建議在此處插入 AI 成功分析「2024年最大地震」的對話截圖 -->*
|
| 49 |
-
|
| 50 |
-
## 🏗️ 專案架構 (Architecture)
|
| 51 |
-
|
| 52 |
-
本專案採用模組化的 Python Flask 應用程式架構，並透過 Docker 容器化後部署於 Hugging Face Spaces。
|
| 53 |
-
|
| 54 |
-
1. **使用者** -> **LINE Platform**
|
| 55 |
-
2. **LINE Platform** -> **Webhook** -> **Hugging Face Space (Gunicorn + Flask)**
|
| 56 |
-
3. `app.py` 接收請求，交由 `command_handler.py` 進行路由。
|
| 57 |
-
4. `command_handler.py` 根據指令類型，分派任務至：
|
| 58 |
-
* `cwa_service.py`: 呼叫台灣中央氣象署 API。
|
| 59 |
-
* `usgs_service.py`: 呼叫美國地質調查局 API。
|
| 60 |
-
* `ai_service.py`: 處理所有 AI 相關邏輯。
|
| 61 |
-
5. **AI 工具呼叫流程**:
|
| 62 |
-
* `ai_service.py` 將使用者問題及工具定義傳送至 **Google Gemini API**。
|
| 63 |
-
* Gemini API 回應，要求呼叫 `call_earthquake_search_tool` 工具。
|
| 64 |
-
* `ai_service.py` 執行該工具，透過 `gradio_client` 呼叫外部的 **MCP-2 Gradio App**。
|
| 65 |
-
* 工具執行結果回傳給 `ai_service.py`。
|
| 66 |
-
* `ai_service.py` 將工具結果再次傳送給 **Gemini API**。
|
| 67 |
-
* Gemini API 根據資料生成最終的自然語言回答。
|
| 68 |
-
|
| 69 |
-
## 🛠️ 技術棧 (Technology Stack)
|
| 70 |
-
|
| 71 |
-
* **後端**: Python, Flask, Gunicorn
|
| 72 |
-
* **AI 模型**: Google Gemini 1.5 Flash
|
| 73 |
-
* **API & 服務**:
|
| 74 |
-
* LINE Messaging API
|
| 75 |
-
* CWA Open Data API
|
| 76 |
-
* USGS Earthquake API
|
| 77 |
-
* Gradio (用於 MCP 工具)
|
| 78 |
-
* **部署**: Docker, Hugging Face Spaces
|
| 79 |
-
|
| 80 |
-
## 部署指南 (Deployment Guide)
|
| 81 |
-
|
| 82 |
-
本專案已針對 Hugging Face Spaces 部署進行優化，並使用 Secret Variables 安全地管理所有憑證。
|
| 83 |
-
|
| 84 |
-
### 1. 建立 Hugging Face Space
|
| 85 |
-
- 前往 [Hugging Face - New Space](https://huggingface.co/new-space)。
|
| 86 |
-
- **Space SDK**: 選擇 **Docker** > **Blank** 模板。
|
| 87 |
-
- **Hardware**: 選擇 **CPU basic** (免費方案) 即可。
|
| 88 |
-
|
| 89 |
-
### 2. 上傳程式碼
|
| 90 |
-
- 使用 `git clone` 您的 Space 儲存庫，並將所有專案檔案 (`.py`, `requirements.txt`, `Dockerfile`) 推送上去。
|
| 91 |
-
|
| 92 |
-
### 3. 設定 Secrets
|
| 93 |
-
- 進入您的 Space，點擊 **Settings** > **Secrets**。
|
| 94 |
-
- 新增以下 4 個 Secret，名稱必須完全匹配：
|
| 95 |
-
- `CHANNEL_ACCESS_TOKEN`: 您的 LINE Channel Access Token。
|
| 96 |
-
- `CHANNEL_SECRET`: 您的 LINE Channel Secret。
|
| 97 |
-
- `CWA_API_KEY`: 您在氣象署平台申請的 API 金鑰。
|
| 98 |
-
- `GEMINI_API_KEY`: 您從 Google AI Studio 取得的 API 金鑰。
|
| 99 |
-
|
| 100 |
-
### 4. `Dockerfile`
|
| 101 |
-
- 確保您的專案根目錄下有 `Dockerfile` 檔案，內容如下：
|
| 102 |
-
```dockerfile
|
| 103 |
-
FROM python:3.10-slim
|
| 104 |
-
WORKDIR /code
|
| 105 |
-
COPY requirements.txt .
|
| 106 |
-
RUN pip install --no-cache-dir -r requirements.txt
|
| 107 |
-
COPY . .
|
| 108 |
-
EXPOSE 7860
|
| 109 |
-
CMD ["gunicorn", "--bind", "0.0.0.0:7860", "--workers", "1", "app:app"]
|
| 110 |
-
```
|
| 111 |
-
|
| 112 |
-
### 5. 設定 LINE Webhook
|
| 113 |
-
- 複製您的 Space 公開 URL (例如: `https://Your-Username-Your-SpaceName.hf.space`)。
|
| 114 |
-
- 在後面加上 `/callback`，組成完整的 Webhook URL。
|
| 115 |
-
- 前往 [LINE Developers Console](https://developers.line.biz/console/)，將此 URL 填入您的 Messaging API Channel 的 "Webhook URL" 欄位並啟用。
|
| 116 |
-
|
| 117 |
-
## 🤖 指令列表 (Command List)
|
| 118 |
-
|
| 119 |
-
您可以直接輸入指令或對應的 `#` 數字快捷鍵。
|
| 120 |
-
|
| 121 |
-
```
|
| 122 |
-
📖 指令列表 (輸入 #數字 即可)
|
| 123 |
-
|
| 124 |
-
【地震資訊】
|
| 125 |
-
• #1 - 最新一筆顯著地震 (含圖)
|
| 126 |
-
• #2 - 全球近24��時顯著地震（USGS)
|
| 127 |
-
• #3 - 今年台灣顯著地震列表（USGS)
|
| 128 |
-
• #4 - CWA 地震目錄查詢 (外部連結)
|
| 129 |
-
• #5 - CWA 最新地震預警
|
| 130 |
-
• #6 - CWA 最近7天顯著有感地震
|
| 131 |
-
|
| 132 |
-
【AI 與工具】
|
| 133 |
-
• #7 <問題> - 與 AI 助理對話
|
| 134 |
-
(例如: #7 昨天花蓮有地震嗎？)
|
| 135 |
-
(例如: #7 2024年4月3日規模6以上的地震有哪些？)
|
| 136 |
-
|
| 137 |
-
【基本指令】
|
| 138 |
-
• #8 - 關於此機器人
|
| 139 |
-
• #9 - 顯示此說明
|
| 140 |
-
```
|
| 141 |
-
|
| 142 |
-
## 📄 授權 (License)
|
| 143 |
-
|
| 144 |
-
This project is licensed under the MIT License.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|