aisyah ai

？アイシャアイ？

Aisyah AIは、複数のAI機能を組み合わせたCloudFlareワーカーで構築された強力な電報ボットです。 Webを閲覧したり、リマインダーを設定したり、話したり、天気を予測したり、画像を分析したり、音声メッセージを理解したりできます。ボットは、Redisを通じて会話のコンテキストを維持し、プライベートチャットとグループの相互作用の両方に最適です。

？スクリーンショットとデモ

特徴

• ？高度なAI機能

  • GPTモデルを使用した自然言語の理解
  • 画像分析とオブジェクト認識
  • 音声からテキストとテキストへの変換
  • プライベートチャットとグループチャットの両方でのコンテキスト認識の会話

• スマートツール

  • Webブラウジングと情報検索
  • リアルタイムの天気予報
  • タスクリマインダーと通知
  • コンテキスト保持とのグループチャットサポート

• ☁️現代建築

  • 高いスケーラビリティのためにCloudFlareワーカーの上に構築されています
  • モジュール性のためのマイクロサービスアーキテクチャ
  • Redis搭載のチャット履歴
  • 費用対効果の高いサーバーレス展開

• ？ API統合

  • 言語処理のためのopenai gpt
  • WebブラウジングのGoogleカスタム検索
  • 気象データのOpenWeathermap
  • メッセージング用の電報ボットAPI
  • ファイルストレージ用のSupabase
  • 強化された機能のための追加サービス

？なぜOpenaiのみですか？

いくつかの理由で、OpenAIモデル（特にGPT-3.5-TurboおよびGPT-4O-MINI）のみをサポートすることを選択しました。

1. モデルの一貫性：OpenAIモデルは、異なる言語とユースケースで最も一貫した高品質の応答を提供します。
2. 費用対効果：GPT-4O-MINIは、出力品質と価格設定の間の優れたバランスを提供します。
3. 多言語機能：大規模なテストの後、Openaiモデルは、自然に複数の言語を処理する上で優れたパフォーマンスを実証しました。
4. 実装のシンプルさ：OpenRouterのようなサービスはさまざまなモデルへのアクセスを提供しますが、それらをサポートするとモデル名のマッピングと応答処理に追加の複雑さが導入されます。

注：代替モデルやプロバイダー（OpenRouter、Anthropicなど）への関心を理解しています。ただし、コードのシンプルさを維持し、一貫したボット動作を確保するために、Openaiの提供に焦点を当てることにしました。異なるモデルを使用する必要がある場合は、それに応じてプロジェクトをフォークしてモデル構成を変更する必要があります。

使用法

基本コマンド

• /startボットとの相互作用を開始します
• /settings - ボット設定（LLMモデル、ペルソナ、音声など）の構成
• /help - 利用可能なコマンドについてヘルプを取得します

注：これは、学習と実験のために設計された個人的なプロジェクトです。

プロジェクト構造

このプロジェクトは、いくつかのマイクロサービスに編成されています。

• aisyah-ai-telegraph ：電報の相互作用を処理するメインオーケストレーター
• aisyah-ai-agent ：リクエストを処理するコアAIエージェント
• aisyah-ai-explorer ：Webブラウジング機能
• aisyah-ai-reminder ：リマインダー管理
• aisyah-ai-sonata ：テキストからスピーチサービス
• aisyah-ai-storm ：天候の予測
• aisyah-ai-vision ：画像分析
• aisyah-ai-whisper ：スピーチツーテキストサービス

クイックスタート

前提条件

• node.js（LTSバージョンが推奨）
• 糸（v4.3.1以降）
• CloudFlareアカウント（無料層の動作）
• 電報ボットトークン
• Openai APIキー
• チャット履歴のRedisインスタンス（Upstash Free Tierを使用できます）

インストール

1. リポジトリをクローンします：

   git clone https://github.com/husniadil/aisyah-ai.git
   cd aisyah-ai

2. 依存関係をインストールします：

   yarn install

3. CloudFlareのセットアップ：最初に、CloudFlare APIトークンを取得します。

   1. https://dash.cloudflare.com/profile/api-tokensにアクセスしてください
   2. 「CloudFlareワーカーの編集」を見つけてから、「テンプレートを使用」
   3. ルールに記入します
   4. [概要]をクリックして、トークンを作成します
   5. トークンを環境変数としてエクスポートします。

       export CLOUDFLARE_API_TOKEN=your_api_token_here

   6. 永続的な構成の場合は、シェルプロファイル（〜/.zshrc、〜/.bashrcなど）に追加します。

       echo ' export CLOUDFLARE_API_TOKEN=your_api_token_here ' >> ~ /.zshrc

   注：APIトークン認証方法と競合するため、 wrangler login使用しないでください。

4. 環境ファイルの構成：

    # Copy Cloudflare configuration files
   cp packages/aisyah-ai-agent/wrangler.toml.example packages/aisyah-ai-agent/wrangler.toml
   cp packages/aisyah-ai-explorer/wrangler.toml.example packages/aisyah-ai-explorer/wrangler.toml
   cp packages/aisyah-ai-reminder/wrangler.toml.example packages/aisyah-ai-reminder/wrangler.toml
   cp packages/aisyah-ai-sonata/wrangler.toml.example packages/aisyah-ai-sonata/wrangler.toml
   cp packages/aisyah-ai-storm/wrangler.toml.example packages/aisyah-ai-storm/wrangler.toml
   cp packages/aisyah-ai-telegraph/wrangler.toml.example packages/aisyah-ai-telegraph/wrangler.toml
   cp packages/aisyah-ai-vision/wrangler.toml.example packages/aisyah-ai-vision/wrangler.toml
   cp packages/aisyah-ai-whisper/wrangler.toml.example packages/aisyah-ai-whisper/wrangler.toml
   
   # Copy environment variables
   cp packages/aisyah-ai-agent/.dev.vars.example packages/aisyah-ai-agent/.dev.vars
   cp packages/aisyah-ai-explorer/.dev.vars.example packages/aisyah-ai-explorer/.dev.vars
   cp packages/aisyah-ai-reminder/.dev.vars.example packages/aisyah-ai-reminder/.dev.vars
   cp packages/aisyah-ai-sonata/.dev.vars.example packages/aisyah-ai-sonata/.dev.vars
   cp packages/aisyah-ai-storm/.dev.vars.example packages/aisyah-ai-storm/.dev.vars
   cp packages/aisyah-ai-telegraph/.dev.vars.example packages/aisyah-ai-telegraph/.dev.vars
   cp packages/aisyah-ai-vision/.dev.vars.example packages/aisyah-ai-vision/.dev.vars
   cp packages/aisyah-ai-whisper/.dev.vars.example packages/aisyah-ai-whisper/.dev.vars

5. パッケージ固有の設定を構成します：

   CloudFlare KVネームスペース

   必要なKVネームスペースを作成し、IDをメモします。

    # For settings storage
   yarn w aisyah-ai-agent wrangler kv:namespace create SETTINGS
   
   # For chat history
   yarn w aisyah-ai-telegraph wrangler kv:namespace create CHAT_HISTORY
   
   # For reminders
   yarn w aisyah-ai-reminder wrangler kv:namespace create REMINDERS

   パッケージ固有の構成

   aisyah-ai-telegraph（メインボット）

    # In packages/aisyah-ai-telegraph/.dev.vars
   CLOUDFLARE_SUBDOMAIN=your_subdomain
   TELEGRAM_BOT_TOKEN=your_telegram_bot_token
   UPSTASH_REDIS_REST_URL=your_redis_rest_url
   UPSTASH_REDIS_REST_TOKEN=your_redis_rest_token

   aisyah-ai-agent（core ai）

    # In packages/aisyah-ai-agent/.dev.vars
   OPENAI_API_KEY=your_openai_api_key
   LANGCHAIN_API_KEY=your_langchain_api_key
   CLOUDFLARE_SUBDOMAIN=your_subdomain
   AGENT_PERSONA_AISYAH_DEFAULT=your_system_prompt_for_persona_default
   AGENT_PERSONA_AISYAH_JAWIR=your_system_prompt_for_persona_jawir
   AGENT_PERSONA_PERSONAL_ASSISTANT=your_system_prompt_for_persona_personal_assistant

   Aisyah-ai-vision（画像分析）

    # In packages/aisyah-ai-vision/.dev.vars
   OPENAI_API_KEY=your_openai_api_key

   aisyah-ai-whisper（スピーチツーテキスト）

    # In packages/aisyah-ai-whisper/.dev.vars
   OPENAI_API_KEY=your_openai_api_key

   aisyah-ai-sonata（テキストツースピーチ）

    # In packages/aisyah-ai-sonata/.dev.vars
   OPENAI_API_KEY=your_openai_api_key
   # Get from https://supabase.io
   SUPABASE_URL=your_supabase_project_url
   SUPABASE_KEY=your_supabase_storage_key
   # Get from https://elevenlabs.io
   ELEVENLABS_API_KEY=your_elevenlabs_api_key

   aisyah-ai-storm（天気）

    # In packages/aisyah-ai-storm/.dev.vars
   OPEN_WEATHER_MAP_API_KEY=your_openweathermap_api_key

   aisyah-ai-explorer（Webブラウザ）

    # In packages/aisyah-ai-explorer/.dev.vars
   # Get from https://programmablesearchengine.google.com/
   GOOGLE_SEARCH_API_KEY=your_google_api_key
   GOOGLE_SEARCH_ENGINE_ID=your_search_engine_id

   aisyah-ai-reminder（リマインダー）

    # In packages/aisyah-ai-reminder/.dev.vars
    REMINDERS_APP_ID=your_reminders_app_id
    REMINDERS_API_KEY=your_reminders_api_key

   wrangler.tomlファイルを更新します

   前のステップから対応するKV名空間IDを使用して、各パッケージのwrangler.toml更新します。

    # In packages/aisyah-ai-telegraph/wrangler.toml
   kv_namespaces = [
     { binding = " CHAT_HISTORY " , id = " your_chat_history_namespace_id " }
   ]
   
   # In packages/aisyah-ai-agent/wrangler.toml
   kv_namespaces = [
     { binding = " SETTINGS " , id = " your_settings_namespace_id " }
   ]
   
   # In packages/aisyah-ai-reminder/wrangler.toml
   kv_namespaces = [
     { binding = " REMINDERS " , id = " your_reminders_namespace_id " }
   ]

6. 労働者を展開する：

   yarn deploy

7. 電報ボットをセットアップします：

   • @botfatherで新しいボットを作成します
   • WebHook URLをCloudFlareワーカーのエンドポイントに設定します
   • Telegramチャットインターフェイスを介してボット設定を構成します

発達

利用可能なスクリプト

• yarn w ：ワークスペース固有のコマンドを実行します
• yarn deploy ：すべての労働者を展開します
• yarn types ：タイプスクリプトタイプを生成します
• yarn format ：Biomeを使用したフォーマットコード

新機能の追加

1. packagesディレクトリに新しいパッケージを作成します
2. CloudFlareワーカーを使用して機能を実装します
3. wrangler.tomlに構成を追加します
4. aisyah-ai-agentに新しい機能を登録します

？追加のセットアップ

Redis構成

1. Redisインスタンスを設定します：

   • Upstashで無料のRedisデータベースを作成します
   • Redis接続のURLと認証の詳細を取得します

2. 環境でRedisを構成します：

    # Add to packages/aisyah-ai-telegraph/.dev.vars
   UPSTASH_REDIS_REST_URL=your_redis_rest_url
   UPSTASH_REDIS_REST_TOKEN=your_redis_rest_token

必要なAPIキー

これらのAPIキーを取得して構成してください。

• LLMおよびビジョン機能のOpenAI APIキー
• Langchain APIキーを強化した言語処理のためのキー
• 天気予報のOpenWeatherMap APIキー
• ファイル処理用のSupabaseプロジェクトとストレージキー

各パッケージのそれぞれの.dev.varsファイルにそれらを追加します。

croubleトラブルシューティング

一般的な問題

1. ワーカーの展開は失敗します

   • CloudFlare APIトークンには正しいアクセス許可があることを確認してください
   • wrangler.tomlの労働者名が一意であるかどうかを確認してください
   • KVネームスペースのバインディングが正しいことを確認します

2. ボットは応答しません

   • WebHook URLが正しく設定されていることを確認してください
   • Telegram Botトークンの妥当性を確認してください
   • Redis接続が機能していることを確認します

3. 機能していない機能

   • 必要なすべてのAPIキーが有効であり、適切に構成されていることを確認してください
   • CloudFlareダッシュボードで対応するワーカーログを確認します
   • 環境変数が正しく設定されていることを確認します

デバッグモード

設定してデバッグモードを有効にします。

 # Add to .dev.vars
DEBUG_MODE=true

これにより、ワーカーコンソールでより詳細なログが提供されます。

助けを得る

問題が発生した場合：

1. [問題]ページを確認してください
2. CloudFlareワーカーログを確認します
3. より詳細なロギングのためにデバッグモードを有効にします

ライセンス

このプロジェクトは、MITライセンスに基づいてライセンスされています。詳細については、ライセンスファイルを参照してください。