aisyah ai

? Aisyah Ai?

Aisyah AI adalah bot telegram yang kuat yang dibangun dengan pekerja cloudflare yang menggabungkan beberapa kemampuan AI. Ini dapat menelusuri web, mengatur pengingat, berbicara, memprediksi cuaca, menganalisis gambar, dan memahami pesan suara. Bot mempertahankan konteks dalam percakapan melalui Redis, membuatnya sempurna untuk obrolan pribadi dan interaksi kelompok.

? Tangkapan layar & demo

Fitur

• ? Kemampuan AI tingkat lanjut

  • Pemahaman bahasa alami dengan model GPT
  • Analisis gambar dan pengenalan objek
  • Konversi pidato-ke-teks dan teks-ke-bicara
  • Percakapan yang sadar konteks baik dalam obrolan pribadi dan grup

• Alat Cerdas

  • Penjelajahan Web dan Pengambilan Informasi
  • Prakiraan cuaca real-time
  • Pengingat tugas dan pemberitahuan
  • Dukungan obrolan grup dengan retensi konteks

• ☁️ Arsitektur modern

  • Dibangun di atas pekerja cloudflare untuk skalabilitas tinggi
  • Arsitektur Microservices untuk Modularitas
  • Riwayat obrolan bertenaga Redis
  • Penyebaran tanpa server yang hemat biaya

• ? Integrasi API

  • Openai GPT untuk pemrosesan bahasa
  • Google Pencarian Kustom untuk Penjelajahan Web
  • OpenWeathermap untuk data cuaca
  • API Bot Telegram untuk Pesan
  • Supabase untuk penyimpanan file
  • Layanan tambahan untuk kemampuan yang ditingkatkan

? Mengapa Openai Hanya?

Kami telah memilih untuk secara eksklusif mendukung model OpenAI (terutama GPT-3.5-Turbo dan GPT-4O-Mini) karena beberapa alasan:

1. Konsistensi model : Model OpenAI memberikan respons yang paling konsisten dan berkualitas tinggi di berbagai bahasa dan kasus penggunaan.
2. Efektivitas biaya : GPT-4O-Mini menawarkan keseimbangan yang sangat baik antara kualitas output dan harga.
3. Kemampuan multibahasa : Setelah pengujian yang luas, model OpenAI menunjukkan kinerja yang unggul dalam menangani berbagai bahasa secara alami.
4. Implementasi Kesederhanaan : Sementara layanan seperti OpenRouter menawarkan akses ke berbagai model, mendukungnya akan memperkenalkan kompleksitas tambahan dalam pemetaan nama model dan penanganan respons.

Catatan: Kami memahami minat pada model dan penyedia alternatif (seperti OpenRouter, Anthropic, dll.). Namun, untuk mempertahankan kesederhanaan kode dan memastikan perilaku bot yang konsisten, kami telah memutuskan untuk fokus pada penawaran Openai. Jika Anda perlu menggunakan model yang berbeda, Anda harus membayar proyek dan memodifikasi konfigurasi model yang sesuai.

Penggunaan

Perintah Dasar

• /start - Mulailah interaksi dengan bot
• /settings - Konfigurasikan Pengaturan Bot (Model LLM, Persona, Suara, dll.)
• /help - Dapatkan bantuan tentang perintah yang tersedia

Catatan : Ini adalah proyek pribadi yang dirancang untuk tujuan pembelajaran dan eksperimen.

Struktur proyek

Proyek ini diatur dalam beberapa layanan mikro:

• aisyah-ai-telegraph : Orchestrator Utama yang Menangani Interaksi Telegram
• aisyah-ai-agent : agen inti AI yang memproses permintaan
• aisyah-ai-explorer : Kemampuan Penelusuran Web
• aisyah-ai-reminder : Manajemen Pengingat
• aisyah-ai-sonata : layanan teks-ke-bicara
• aisyah-ai-storm : prediksi cuaca
• aisyah-ai-vision : Analisis Gambar
• aisyah-ai-whisper : layanan pidato-ke-teks

Awal yang cepat

Prasyarat

• Node.js (versi LTS direkomendasikan)
• Benang (v4.3.1 atau lebih baru)
• Akun CloudFlare (Tingkat Gratis Works)
• Token Telegram Bot
• Kunci API Openai
• Redis Instance untuk Riwayat Obrolan (Anda dapat menggunakan tingkat gratis Upstash)

Instalasi

1. Klon Repositori:

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

2. Instal dependensi:

   yarn install

3. Siapkan CloudFlare: Pertama, dapatkan token API CloudFlare Anda:

   1. Kunjungi https://dash.cloudflare.com/profile/api-tokens
   2. Temukan "Edit CloudFlare Workers", lalu "Gunakan Template"
   3. Isi aturannya
   4. Klik "Lanjutkan ke Ringkasan" dan buat token
   5. Ekspor token sebagai variabel lingkungan:

       export CLOUDFLARE_API_TOKEN=your_api_token_here

   6. Untuk konfigurasi yang persisten, tambahkan ke profil shell Anda (~/.zshrc, ~/.bashrc, dll.):

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

   Catatan: Jangan gunakan wrangler login karena bertentangan dengan metode otentikasi token API.

4. Konfigurasikan File Lingkungan:

    # 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. Konfigurasikan pengaturan khusus paket:

   Namespaces Cloudflare KV

   Buat KV Namespaces yang diperlukan dan buat catatan ID mereka:

    # 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

   Konfigurasi khusus paket

   Aisyah-Ai-Telegraph (Bot Utama)

    # 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 (inti 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 (analisis gambar)

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

   Aisyah-ai-whisper (pidato-ke-teks)

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

   Aisyah-ai-sonata (teks-ke-kekuatan)

    # 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 (cuaca)

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

   Aisyah-ai-Explorer (Browser 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 (pengingat)

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

   Perbarui file wrangler.toml

   Perbarui wrangler.toml setiap paket dengan KV Namespace ID yang sesuai dari langkah sebelumnya:

    # 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. Menyebarkan pekerja:

   yarn deploy

7. Siapkan Bot Telegram Anda:

   • Buat bot baru dengan @botfather
   • Atur URL WebHook ke titik akhir CloudFlare Worker Anda
   • Konfigurasikan pengaturan bot melalui antarmuka obrolan telegram

Perkembangan

Skrip yang tersedia

• yarn w : Jalankan perintah khusus ruang kerja
• yarn deploy : Menyebarkan semua pekerja
• yarn types : menghasilkan tipe naskah
• yarn format : Kode Format Menggunakan Biome

Menambahkan fitur baru

1. Buat paket baru di direktori packages
2. Laksanakan fitur Anda menggunakan pekerja cloudflare
3. Tambahkan konfigurasi di wrangler.toml
4. Daftarkan kemampuan baru di aisyah-ai-agent

? Pengaturan tambahan

Konfigurasi Redis

1. Siapkan instance Redis:

   • Buat database Redis gratis di Upstash
   • Dapatkan URL Koneksi Redis Anda dan Detail Otentikasi

2. Konfigurasikan Redis di lingkungan Anda:

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

Kunci API yang diperlukan

Pastikan untuk mendapatkan dan mengonfigurasi kunci API ini:

• Kunci API OpenAI untuk LLM dan Kemampuan Visi
• Kunci API Langchain untuk pemrosesan bahasa yang ditingkatkan
• Kunci API OpenWeathermap untuk Prakiraan Cuaca
• Proyek Supabase dan kunci penyimpanan untuk penanganan file

Tambahkan mereka ke file .dev.vars masing -masing di setiap paket.

❗ Pemecahan masalah

Masalah umum

1. Penyebaran pekerja gagal

   • Pastikan token API cloudflare memiliki izin yang benar
   • Periksa apakah nama pekerja di wrangler.toml unik
   • Verifikasi binding namespace kv benar

2. Bot tidak menanggapi

   • Konfirmasi URL Webhook diatur dengan benar
   • Periksa validitas token Telegram Bot
   • Verifikasi Koneksi Redis berfungsi

3. Fitur tidak berfungsi

   • Pastikan semua tombol API yang diperlukan valid dan dikonfigurasi dengan benar
   • Periksa log pekerja yang sesuai di dasbor cloudflare
   • Verifikasi variabel lingkungan diatur dengan benar

Mode debug

Aktifkan mode debug dengan pengaturan:

 # Add to .dev.vars
DEBUG_MODE=true

Ini akan memberikan log yang lebih rinci di konsol pekerja.

Mendapatkan bantuan

Jika Anda menemukan masalah:

1. Periksa halaman masalah
2. Tinjau Log Pekerja Cloudflare
3. Aktifkan mode debug untuk penebangan yang lebih rinci

Lisensi

Proyek ini dilisensikan di bawah lisensi MIT - lihat file lisensi untuk detailnya.