aisyah ai

- Aisyah Ai?

Aisyah AI เป็นบอทโทรเลขที่ทรงพลังที่สร้างขึ้นกับคนงาน CloudFlare ที่รวมความสามารถของ AI หลายอย่าง มันสามารถเรียกดูเว็บตั้งค่าการแจ้งเตือนพูดทำนายสภาพอากาศวิเคราะห์ภาพและเข้าใจข้อความเสียง บอทรักษาบริบทในการสนทนาผ่าน Redis ทำให้สมบูรณ์แบบสำหรับการแชทส่วนตัวและการโต้ตอบกลุ่ม

- ภาพหน้าจอและการสาธิต

คุณสมบัติ

• - ความสามารถ AI ขั้นสูง

  • ความเข้าใจภาษาธรรมชาติด้วยโมเดล GPT
  • การวิเคราะห์ภาพและการจดจำวัตถุ
  • การแปลงคำพูดเป็นข้อความและข้อความเป็นคำพูด
  • บทสนทนาที่ตระหนักถึงบริบททั้งในการแชทส่วนตัวและกลุ่ม

• เครื่องมืออัจฉริยะ

  • การท่องเว็บและการดึงข้อมูล
  • การพยากรณ์อากาศแบบเรียลไทม์
  • การแจ้งเตือนงานและการแจ้งเตือน
  • การสนับสนุนการแชทเป็นกลุ่มพร้อมการเก็บรักษาบริบท

• ☁สถาปัตยกรรมสมัยใหม่

  • สร้างขึ้นบนคนงาน CloudFlare เพื่อความสามารถในการปรับขนาดสูง
  • สถาปัตยกรรม Microservices สำหรับ modularity
  • ประวัติการแชทที่ขับเคลื่อนด้วย Redis
  • การปรับใช้เซิร์ฟเวอร์แบบไร้ค่าใช้จ่าย

• - การรวม API

  • openai gpt สำหรับการประมวลผลภาษา
  • Google Search สำหรับการท่องเว็บ
  • OpenWeatherMap สำหรับข้อมูลสภาพอากาศ
  • Telegram Bot API สำหรับการส่งข้อความ
  • supabase สำหรับการจัดเก็บไฟล์
  • บริการเพิ่มเติมสำหรับความสามารถที่เพิ่มขึ้น

- ทำไมต้อง Openai เท่านั้น?

เราเลือกที่จะสนับสนุนโมเดล OpenAI โดยเฉพาะ (โดยเฉพาะ GPT-3.5-turbo และ GPT-4O-MINI) ด้วยเหตุผลหลายประการ:

1. แบบจำลองความสอดคล้อง : โมเดล OpenAI ให้การตอบสนองที่สอดคล้องและมีคุณภาพสูงที่สุดในภาษาต่าง ๆ และกรณีการใช้งาน
2. ต้นทุน-ประสิทธิผล : GPT-4O-MINI ให้ความสมดุลที่ยอดเยี่ยมระหว่างคุณภาพเอาท์พุทและราคา
3. ความสามารถในการพูดได้หลายภาษา : หลังจากการทดสอบอย่างกว้างขวางโมเดล OpenAI แสดงให้เห็นถึงประสิทธิภาพที่เหนือกว่าในการจัดการหลายภาษาตามธรรมชาติ
4. ความเรียบง่ายในการใช้งาน : ในขณะที่บริการเช่น OpenRouter เสนอการเข้าถึงโมเดลต่าง ๆ การสนับสนุนพวกเขาจะแนะนำความซับซ้อนเพิ่มเติมในการแมปชื่อรุ่นและการจัดการการตอบสนอง

หมายเหตุ: เราเข้าใจถึงความสนใจในแบบจำลองทางเลือกและผู้ให้บริการ (เช่น OpenRouter, มานุษยวิทยา ฯลฯ ) อย่างไรก็ตามเพื่อรักษาความเรียบง่ายของรหัสและให้แน่ใจว่าพฤติกรรมของ BOT ที่สอดคล้องกันเราได้ตัดสินใจที่จะมุ่งเน้นไปที่ข้อเสนอของ OpenAI หากคุณต้องการใช้โมเดลที่แตกต่างกันคุณจะต้องแยกโครงการและแก้ไขการกำหนดค่าโมเดลตามนั้น

การใช้งาน

คำสั่งพื้นฐาน

• /start - เริ่มการโต้ตอบกับบอท
• /settings - กำหนดค่าการตั้งค่าบอท (รุ่น LLM, persona, เสียง ฯลฯ )
• /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 (ฟรีเทียร์)
• โทเค็น Bot Telegram
• คีย์ 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. สำหรับการกำหนดค่าแบบถาวรให้เพิ่มลงในโปรไฟล์เชลล์ของคุณ (~/.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. กำหนดค่าการตั้งค่าเฉพาะแพ็คเกจ:

   Namespaces Cloudflare KV

   สร้างเนมสเปซ KV ที่ต้องการและจดบันทึกรหัสของพวกเขา:

    # 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 (เว็บเบราว์เซอร์)

    # 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 ที่สอดคล้องกันจากขั้นตอนก่อนหน้า:

    # 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. ตั้งค่า Bot Telegram ของคุณ:

   • สร้างบอทใหม่ด้วย @botfather
   • ตั้งค่า URL WebHook เป็นจุดสิ้นสุดของคนงาน CloudFlare ของคุณ
   • กำหนดค่าการตั้งค่าบอทผ่านอินเตอร์เฟสการแชทโทรเลข

การพัฒนา

สคริปต์ที่มีอยู่

• yarn w : เรียกใช้คำสั่งเฉพาะพื้นที่ทำงาน
• yarn deploy : ปรับใช้คนงานทั้งหมด
• yarn types : สร้างประเภท typescript
• yarn format : รหัสรูปแบบโดยใช้ biome

การเพิ่มคุณสมบัติใหม่

1. สร้างแพ็คเกจใหม่ในไดเร็กทอรี packages
2. ใช้คุณสมบัติของคุณโดยใช้คนงาน CloudFlare
3. เพิ่มการกำหนดค่าใน wrangler.toml
4. ลงทะเบียนความสามารถใหม่ใน aisyah-ai-agent

- การตั้งค่าเพิ่มเติม

การกำหนดค่า Redis

1. ตั้งค่าอินสแตนซ์ Redis:

   • สร้างฐานข้อมูล Redis ฟรีที่ Upstash
   • รับ URL การเชื่อมต่อ Redis ของคุณและรายละเอียดการรับรองความถูกต้อง

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 เหล่านี้:

• คีย์ OpenAI API สำหรับ LLM และความสามารถในการมองเห็น
• คีย์ Langchain API สำหรับการประมวลผลภาษาขั้นสูง
• คีย์ OpenWeatherMap API สำหรับการพยากรณ์อากาศ
• Supabase Project and Storage Keys สำหรับการจัดการไฟล์

เพิ่มลงในไฟล์ .dev.vars ที่เกี่ยวข้องในแต่ละแพ็คเกจ

❗การแก้ไขปัญหา

ปัญหาทั่วไป

1. การปรับใช้คนงานล้มเหลว

   • ตรวจสอบให้แน่ใจว่า Token API CloudFlare มีสิทธิ์ที่ถูกต้อง
   • ตรวจสอบว่าชื่อคนงานใน wrangler.toml ไม่ซ้ำกัน
   • ตรวจสอบการผูกเนมสเปซ KV ถูกต้อง

2. บอทไม่ตอบสนอง

   • ยืนยัน URL WebHook อย่างถูกต้อง
   • ตรวจสอบความถูกต้องของโทเค็น Telegram Bot Token
   • ตรวจสอบว่าการเชื่อมต่อ Redis ใช้งานได้

3. คุณสมบัติไม่ทำงาน

   • ตรวจสอบให้แน่ใจว่าคีย์ API ที่จำเป็นทั้งหมดนั้นถูกต้องและกำหนดค่าได้อย่างเหมาะสม
   • ตรวจสอบบันทึกคนงานที่เกี่ยวข้องในแผงควบคุม CloudFlare
   • ตรวจสอบตัวแปรสภาพแวดล้อมถูกตั้งค่าอย่างถูกต้อง

โหมดดีบัก

เปิดใช้งานโหมดดีบักโดยการตั้งค่า:

 # Add to .dev.vars
DEBUG_MODE=true

สิ่งนี้จะให้บันทึกรายละเอียดเพิ่มเติมในคอนโซลคนงาน

ขอความช่วยเหลือ

หากคุณพบปัญหา:

1. ตรวจสอบหน้าปัญหา
2. ตรวจสอบบันทึกของคนงาน CloudFlare
3. เปิดใช้งานโหมดดีบักสำหรับการบันทึกรายละเอียดเพิ่มเติม

ใบอนุญาต

โครงการนี้ได้รับใบอนุญาตภายใต้ใบอนุญาต MIT - ดูไฟล์ใบอนุญาตสำหรับรายละเอียด