📖 Dokumentasi Lengkap

Assistent Pribadi Telegram AI-Agent v3.0

📖 Apa Itu Sistem Asisten Pribadi AI Telegram Bot?

Sistem Asisten Pribadi AI-Agent adalah sebuah bot Telegram canggih yang menggunakan teknologi AI (Artificial Intelligence) untuk membantu kamu mengelola berbagai aspek kehidupan sehari-hari. Bayangkan seperti punya asisten pribadi yang selalu siap 24/7 di Telegram kamu!

Bot ini bukan cuma bisa chat biasa. Dia bisa:

💡 Tips: Bot ini menggunakan teknologi DeepSeek AI dan OpenAI untuk memberikan respon yang akurat dan kontekstual. Semua data kamu aman dan tersimpan dengan baik!

🎯 Fitur-Fitur Utama

1. Mode Chat (/chat)

Mode chat adalah mode paling cepat dan ringan. Cocok untuk pertanyaan sehari-hari yang butuh jawaban cepat. AI akan merespon dengan cepat tanpa analisis mendalam.

2. Mode Thinking (/thinking)

Mode thinking adalah mode analisis mendalam. AI akan "berpikir" lebih lama untuk memberikan jawaban yang lebih akurat dan detail. Cocok untuk pertanyaan kompleks yang butuh analisis.

3. Mode Debat (/debat)

Mode debat menggunakan sistem 4-stage dengan 3 AI berbeda yang "berdebat" untuk mendapatkan jawaban terbaik. Ini adalah fitur paling canggih!

4-Stage System:

  1. ARCHITECT - Menganalisis pertanyaan dan menentukan data yang dibutuhkan
  2. GATHERER - Mengumpulkan data dari Google Search, Memory, atau keduanya
  3. WRITER & CRITIC - Menulis draft jawaban dan mengkritiknya
  4. JUDGE - Menyintesis jawaban final dengan reasoning yang jelas
⚠️ Catatan: Mode debat membutuhkan waktu lebih lama karena proses yang kompleks, tapi hasilnya sangat worth it!

4. Voice Router

Voice Router adalah fitur yang memungkinkan kamu berbicara langsung ke bot. Bot akan:

Intent yang didukung: memory_save, memory_recall, keuangan, todo, note, summary, drive, docs, calendar, email, sheet, search, image, chat

5. Memory System (RAG)

Memory System menggunakan teknologi RAG (Retrieval-Augmented Generation) dengan Pinecone Vector Database. Bot bisa mengingat dan mengambil informasi penting untuk kamu.

Cara Kerja:

  1. Save Memory - Simpan informasi penting dengan /ingat
  2. Generate Embedding - AI mengubah teks menjadi vector 1536 dimensi
  3. Store in Pinecone - Disimpan di database vector dengan metadata
  4. Search Memory - Cari dengan /ingatan keyword menggunakan similarity search
  5. Auto-Save - Bot otomatis menyimpan info penting dari chat

Kategori Memory: journal, learning, important, personal, work

6. Google Services Integration

Bot terintegrasi penuh dengan Google Workspace. Kamu bisa mengelola semua Google services langsung dari Telegram!

Services yang Tersedia:

💡 Tips: Semua operasi Google Services bisa menggunakan Multi-Agent Debate untuk hasil yang lebih akurat!

🏗️ Arsitektur Sistem

Sistem ini dibangun dengan arsitektur modular yang memisahkan setiap fungsi ke dalam handler dan service terpisah. Ini membuat sistem mudah dirawat dan dikembangkan.

Layer 1: Handler Layer

Handler layer adalah lapisan yang menangani interaksi dengan user melalui Telegram. Setiap handler punya tanggung jawab spesifik:

Layer 2: Service Layer

Service layer adalah lapisan yang berkomunikasi dengan external services dan API:

Layer 3: External Services

External services adalah semua API dan service yang digunakan sistem:

Layer 4: Data Storage

📌 Catatan Penting: Semua data user disimpan dengan aman. Sistem mendukung multi-tenant mode untuk beberapa customer dalam satu instance.

🔄 Alur Kerja Sistem

Alur Chat Text Biasa

  1. User kirim pesan text ke bot
  2. Bot cek apakah ada memory relevan di Pinecone
  3. Jika ada, tambahkan context dari memory
  4. Proses dengan AI (DeepSeek-Chat atau DeepSeek-Reasoner)
  5. Stream response ke user
  6. AI analisis apakah info penting, jika ya auto-save ke memory

Alur Voice Message

  1. User kirim voice message
  2. Whisper API transcribe audio ke text
  3. AI detect intent dari text (memory_save, keuangan, dll)
  4. Jika confidence ≥80%, auto execute
  5. Jika confidence <80%, tanya konfirmasi user
  6. Execute action sesuai intent
  7. Kirim response (bisa dengan TTS voice juga)

Alur Multi-Agent Debate

  1. User kirim /thinking atau /debat
  2. STAGE 1 - ARCHITECT: DeepSeek-Reasoner analisis query dan tentukan data yang dibutuhkan
  3. STAGE 2 - GATHERER: Kumpulkan data dari Google Search, Memory, atau keduanya
  4. STAGE 3A - WRITER: DeepSeek-Chat generate draft answer
  5. STAGE 3B - CRITIC: DeepSeek-Chat evaluate dan kritik draft
  6. STAGE 4 - JUDGE: DeepSeek-Reasoner synthesize final answer dengan reasoning
  7. Format dan kirim response ke user

Alur Memory Save

  1. User kirim /ingat text atau AI detect info penting
  2. AI detect kategori (journal/learning/important/personal/work)
  3. Generate embedding menggunakan OpenAI Embedding API (1536 dimensi)
  4. Prepare metadata (user_id, category, timestamp, summary, text)
  5. Upsert ke Pinecone dengan vector + metadata
  6. Konfirmasi ke user

Alur Memory Search

  1. User kirim /ingatan keyword
  2. Generate query embedding
  3. Vector similarity search di Pinecone (cosine distance)
  4. Filter hasil dengan threshold ≥0.7
  5. Return top-K memories
  6. Jika menggunakan /ingatan, AI akan analisis dan synthesize hasil
  7. Jika hanya list, tampilkan daftar memory

💻 Teknologi yang Digunakan

AI & Machine Learning

Database & Storage

Google Services

Framework & Libraries

Infrastructure

🔐 Keamanan & Privasi

Data Protection

Access Control

Privacy

🔒 Catatan: Semua komunikasi dengan API menggunakan HTTPS. Pastikan untuk menjaga API keys kamu dengan baik!

📚 Command Reference

Core Commands

Memory Commands

Google Services Commands

LifeOS Commands

💡 Tips: Kamu juga bisa menggunakan voice message untuk semua operasi ini! Bot akan otomatis detect intent dan execute.
← Kembali ke Flowchart