基于 OpenAI Agents SDK 的天气机器人

一个使用 OpenAI 的 Agents SDK 和模型上下文协议 (MCP) 提供实时天气信息的 Telegram 机器人。该机器人可以使用自然语言查询获取全球城市当前的 weather conditions，由 GPT-4o-mini 模型驱动。

功能

• 使用 Open-Meteo API 获取实时天气数据
• 使用 OpenAI Agents SDK (GPT-4o-mini) 进行自然语言处理
• 用于天气数据检索的简单 MCP 服务器实现
• Telegram 原生消息格式
• 易于使用的界面，支持简单的天气查询

技术栈

• Python 3.11+
• OpenAI Agents SDK
• 模型上下文协议 (MCP)
• python-telegram-bot
• Open-Meteo API (无需 API 密钥)

快速开始

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 文件：

TELEGRAM_BOT_TOKEN=your_bot_token_here
OPENAI_API_KEY=your_openai_api_key_here

5. 运行机器人：

python main.py

用法

只需向机器人发送一条消息，询问任何城市的天气：

乌布的天气怎么样？

机器人将回复当前的天气状况，包括：

• 温度
• 天气状况
• 风速

架构

OpenAI Agents SDK 集成

该机器人使用 OpenAI 的 Agents SDK 和 GPT-4o-mini 模型来处理自然语言查询并生成类似人类的响应。该 Agent 配置了处理与天气相关的查询和维护对话上下文的特定指令。

模型上下文协议 (MCP)

该项目实现了一个简单的 MCP 服务器 (weather_mcp.py)，它提供了 get_weather 工具。 这演示了如何：

• 创建自定义 MCP 工具
• 处理工具请求和响应
• 将外部 API (Open-Meteo) 与 MCP 集成

许可

MIT © Esa Krissa