Weather Bot with OpenAI Agents SDK

Weather Bot with OpenAI Agents SDK

site icon
2025.03.23 2
Python天气服务自然语言处理交流协作
agents-sdk-telegram 是一个基于 OpenAI Agents SDK 和 Model Context Protocol (MCP) 的 Telegram 机器人,提供全球城市的实时天气信息。该机器人能够通过自然语言查询获取天气数据,并使用 GPT-4o-mini 模型进行自然语言处理。
View on GitHub

Overview

基本能力

产品定位

agents-sdk-telegram 是一个天气查询机器人,通过 Telegram 平台提供实时天气信息,并利用 OpenAI Agents SDK 和 MCP 协议实现自然语言交互。

核心功能

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

适用场景

  • 用户通过 Telegram 查询全球城市的实时天气
  • 开发者学习如何集成 OpenAI Agents SDK 和 MCP 协议
  • 快速构建基于自然语言交互的天气服务机器人

工具列表

  • get_weather:用于获取指定城市的天气数据,包括温度、天气状况和风速等信息。

常见问题解答

无明确常见问题解答部分。

使用教程

使用依赖

  1. 确保已安装 Python 3.11+ 版本。
  2. 安装依赖包:
pip install -r requirements.txt

安装教程

  1. 克隆仓库:
git clone https://github.com/esakrissa/agents-sdk-telegram.git
cd agents-sdk-telegram
  1. 创建并激活虚拟环境:
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
  1. 安装依赖:
pip install -r requirements.txt
  1. 创建 .env 文件并配置 Telegram 和 OpenAI API 密钥:
TELEGRAM_BOT_TOKEN=your_bot_token_here
OPENAI_API_KEY=your_openai_api_key_here

调试方式

  1. 运行机器人:
python main.py
  1. 在 Telegram 中向机器人发送天气查询消息,例如:
what's the weather in Ubud?
  1. 检查机器人是否返回正确的天气信息。

许可证

该项目遵循 MIT 开源许可条款。