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许可证获得许可的 - 有关详细信息，请参见许可证文件。