Agents Sdk Telegram

🚀 天氣機器人與 OpenAI 代理 SDK

本項目是一個 Telegram 機器人，藉助 OpenAI 的代理 SDK 和模型上下文協議（MCP），為用戶提供即時天氣信息。它支持通過自然語言查詢全球任意城市的當前天氣狀況，由 GPT - 4o - mini 模型驅動。

✨ 主要特性

• 即時天氣數據獲取：利用 Open - Meteo API 實現。
• 自然語言處理：藉助 OpenAI 代理 SDK（GPT - 4o - mini），可處理自然語言查詢。
• MCP 服務器實現：有簡單的 MCP 服務器，用於獲取天氣數據。
• 原生 Telegram 消息格式輸出：以 Telegram 原生消息格式呈現查詢結果。
• 易用界面：支持簡單的天氣查詢，操作便捷。

📦 安裝指南

1. 克隆倉庫：

git clone https://github.com/esakrissa/agents-sdk-telegram.git
cd agents-sdk-telegram

2. 創建並激活虛擬環境：

python -m venv venv
source venv/bin/activate  # Windows 用戶請使用：venv\Scripts\activate

3. 安裝依賴項：

pip install -r requirements.txt

4. 創建 .env 文件：在項目根目錄下創建 .env 文件，並添加以下內容：

TELEGRAM_BOT_TOKEN=你的機器人令牌
OPENAI_API_KEY=你的 OpenAI API 密鑰

5. 運行機器人：

python main.py

💻 使用示例

基礎用法

只需向機器人發送一條消息，詢問任意城市的天氣情況即可，例如：

烏布的天氣怎麼樣？

機器人將回復當前天氣狀況，包括：

• 溫度
• 天氣狀況描述
• 風速

🔧 技術細節

OpenAI 代理 SDK 集成

該機器人使用 OpenAI 的代理 SDK 和 GPT - 4o - mini 模型來處理自然語言查詢並生成人類可讀的回覆。代理根據指令處理天氣相關查詢，並維護對話上下文。

模型上下文協議（MCP）

項目實現了一個簡單的 MCP 服務器 (weather_mcp.py)，提供 get_weather 工具。這展示瞭如何：

• 創建自定義 MCP 工具
• 處理工具請求和響應
• 將外部 API （Open - Meteo）與 MCP 集成

📄 許可證

本項目採用 MIT 協議，© Esa Krissa 。