使用OpenAI Agents SDK的天气机器人

这是一个使用OpenAI的Agents SDK和模型上下文协议（MCP）提供实时天气信息的Telegram机器人。该机器人可以通过自然语言查询获取全球城市的当前天气状况，由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=你的bot令牌
OPENAI_API_KEY=你的openai api密钥

5. 运行机器人：

python main.py

使用方法

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

Ubud的天气如何？

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

• 温度
• 天气状况
• 风速

架构

OpenAI Agents SDK集成

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

模型上下文协议（MCP）

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

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

许可证

MIT © Esa Krissa