aisyah ai

？ aisyah ai？

Aisyah AI是一個功能強大的電報機器人，它由CloudFlare工人構建，結合了多個AI功能。它可以瀏覽網絡，設置提醒，說話，預測天氣，分析圖像並理解語音消息。該機器人通過REDIS維護對話中的上下文，使其非常適合私人聊天和小組互動。

？屏幕截圖和演示

特徵

• ？高級AI功能

  • GPT模型的自然語言理解
  • 圖像分析和對象識別
  • 語音到文本和文本轉換轉換
  • 私人和小組聊天中的上下文感知對話

• 智能工具

  • 網絡瀏覽和信息檢索
  • 實時天氣預報
  • 任務提醒和通知
  • 與上下文保留的小組聊天支持

• ☁️現代建築

  • 建立在Cloudflare工人的高可擴展性上
  • 模塊化的微服務體系結構
  • 重新動力的聊天歷史
  • 具有成本效益的無服務器部署

• ？ API集成

  • 用於語言處理的OpenAI GPT
  • Google自定義搜索網絡瀏覽
  • 天氣數據的OpenWeathMap
  • 電報機器人API用於消息傳遞
  • 用於文件存儲的supabase
  • 增強功能的其他服務

？為什麼只開放？

我們選擇僅支持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 ：網絡瀏覽功能
• 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免費層）

安裝

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. 對於持久配置，將其添加到您的shell配置文件（〜/.zshrc，〜/.bashrc等）：

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

   注意：不要使用wrangler login因為它與API代幣身份驗證方法發生衝突。

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（核心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文件

   更新每個軟件包的wrangler.toml ，並從上一步中使用相應的KV名稱空間ID：

    # 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工作者端點
   • 通過電報聊天接口配置機器人設置

發展

可用腳本

• 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密鑰用於增強語言處理
• 天氣預報的OpenWeathMap API鍵
• supabase項目和文件處理的存儲鍵

將它們添加到每個軟件包中的各個.dev.vars文件中。

❗故障排除

常見問題

1. 工人部署失敗

   • 確保CloudFlare API令牌具有正確的權限
   • 檢查wrangler.toml中的工人名稱是否唯一
   • 驗證KV名稱空間綁定正確

2. 機器人不響應

   • 確認正確設置Webhook URL
   • 檢查電報機器人令牌有效性
   • 驗證redis連接正在工作

3. 功能不起作用

   • 確保所有必需的API密鑰有效並正確配置
   • 在Cloudflare儀表板中檢查相應的工作日誌
   • 驗證環境變量正確設置

調試模式

通過設置啟用調試模式：

 # Add to .dev.vars
DEBUG_MODE=true

這將在工作人員控制台中提供更詳細的日誌。

得到幫助

如果您遇到問題：

1. 檢查問題頁面
2. 評論Cloudflare工人日誌
3. 啟用調試模式以進行更詳細的記錄

執照

該項目是根據MIT許可證獲得許可的 - 有關詳細信息，請參見許可證文件。