Weather Bot with OpenAI Agents SDK

OpenAI Agents SDK を使用した天気ボット

OpenAI の Agents SDK と Model Context Protocol（MCP）を使用して、リアルタイムの天気情報を提供する Telegram ボットです。このボットは、GPT-4o-mini モデルを利用し、自然言語での問い合わせに応じて世界各地の都市の現在の天気を取得できます。

機能

• Open-Meteo API を使用したリアルタイムの天気データ
• OpenAI Agents SDK（GPT-4o-mini）による自然言語処理
• 天気データ取得のためのシンプルな MCP サーバー実装
• Telegram に適したメッセージ形式
• 簡単な天気の問い合わせで使える、シンプルなインターフェース

技術スタック

• Python 3.11+
• OpenAI Agents SDK
• Model Context Protocol（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  # On 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

使い方

任意の都市の天気について、ボットにメッセージを送るだけです：

what's the weather in Ubud?

ボットは、以下の現在の天気情報を返信します：

• 気温
• 天候
• 風速

アーキテクチャ

OpenAI Agents SDK との統合

このボットは、OpenAI の Agents SDK と GPT-4o-mini モデルを使用して、自然言語の問い合わせを処理し、人間らしい応答を生成します。エージェントには、天気に関する問い合わせへの対応と会話の文脈の維持に特化した指示が設定されています。

Model Context Protocol（MCP）

このプロジェクトでは、get_weather ツールを提供するシンプルな MCP サーバー（weather_mcp.py）を実装しています。以下の方法を紹介します：

• カスタム MCP ツールの作成
• ツールのリクエストと応答の処理
• 外部 API（Open-Meteo）と MCP の統合

ライセンス

MIT © Esa Krissa