Agents Sdk Telegram

🚀 天気ロボットと OpenAI エージェント SDK

Telegram ボットで、OpenAI のエージェント SDK とモデルコンテキストプロトコル（MCP）を使用して、リアルタイムの天気情報を提供します。このボットは、自然言語でのクエリを通じて、世界中の任意の都市の現在の天気状況を取得でき、GPT - 4o - mini モデルによって駆動されます。

✨ 主な機能

• Open - Meteo API を使用して、リアルタイムの天気データを取得します。
• OpenAI エージェント SDK（GPT - 4o - mini）を利用した自然言語処理。
• 天気データを取得するためのシンプルな MCP サーバーの実装。
• ネイティブの 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 ファイルを作成します：

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