Telegram AI Agent Automation v3.0

Bot Telegram yang berperan sebagai asisten pribadi di seluruh layanan Google — Drive, Sheets, Docs, Calendar, Gmail, dan Forms — dengan DeepSeek sebagai mesin penalaran dan lapisan pengambilan hibrida agar ia bisa menjawab dari dokumen yang Anda unggah, bukan hanya dari data latihnya sendiri.

Sorotan

• Pengambilan yang memadukan dua keluarga perangkingan — pencarian vektor Pinecone berdampingan dengan perangkingan kata kunci BM25, sehingga pertanyaan yang dirumuskan longgar maupun pertanyaan yang mengutip istilah persis sama-sama mendarat di bagian yang tepat. Dokumen dipotong memakai NLTK, bukan dipenggal pada jumlah karakter tetap.
• Unggah berkas sebagai jalan memutari batas pesan Telegram — Telegram membatasi satu pesan di 4.096 karakter, yang membuat penempelan dokumen panjang mustahil. Mengunggah berkasnya justru menghapus batas itu sepenuhnya: bot mengurai, menyimpan, lalu mengindeksnya.
• Teks utuh disimpan di Postgres karena penyimpan vektor tidak sanggup — metadata Pinecone terbatas sekitar 1.000 karakter, sehingga menaruh dokumen di sana akan memotongnya diam-diam. Embedding tinggal di Pinecone dan teks lengkapnya tinggal di Postgres, masing-masing memegang apa yang memang menjadi keunggulannya.
• Lima format dokumen, diurai murni dengan Python — .txt dengan deteksi enkode otomatis, .pdf, .docx, .xlsx, dan .csv dengan dukungan banyak enkode. Jalur PDF sengaja menghindari dependensi native agar image tetap bisa dibangun dan berjalan di Fly.io.
• Jawaban panjang dipecah, bukan dipotong — respons di atas batas Telegram dipisah otomatis ke beberapa pesan, dan itulah beda antara jawaban yang terpenggal dengan jawaban yang utuh.
• Multi-tenant sejak lapisan layanan — varian multi-tenant dari klien AI, klien Google, dan layanan memori tersedia berdampingan dengan versi pengguna tunggal, sehingga satu deployment bisa melayani lebih dari satu pemilik.

Fitur Utama

1. Obrolan AI dalam dua kedalaman — mode Chat yang cepat dan mode Thinking yang lebih lambat untuk analisis mendalam, keduanya di atas DeepSeek.
2. Kendali Google Workspace dari obrolan — mengunggah dan merapikan berkas Drive, menyusun dan menganalisis spreadsheet, menulis dan menyunting Docs, mengelola acara dan pengingat Calendar, memilah Gmail dan menyusun balasan, serta membuat Forms atau kuis.
3. Tanya jawab dokumen — unggah berkas lalu ajukan pertanyaan atas isinya, ditopang pipeline RAG hibrida.
4. Berita dan riset — agregasi RSS lewat feedparser plus pencarian DuckDuckGo untuk penelusuran terkini.
5. Transkrip YouTube — menarik transkrip sebuah video lalu meringkas atau menanyainya.
6. Memori yang bertahan — layanan memori khusus agar asisten membawa konteks antar sesi, bukan memulai dari nol setiap kali.
7. Grafik dari data — pandas dan matplotlib merender hasil analisis kembali ke obrolan sebagai gambar.

Tech Stack

• Python 3.10+ dengan python-telegram-bot 20+ (job queue aktif)
• DeepSeek lewat OpenAI SDK
• Pinecone 5 (pencarian vektor) + rank-bm25 (perangkingan kata kunci)
• PostgreSQL lewat psycopg2-binary dan asyncpg (penyimpanan dokumen utuh)
• Google API Python Client + google-auth-oauthlib + gspread
• pypdf, python-docx, openpyxl, chardet (pengurai dokumen), NLTK (pemotongan)
• feedparser, duckduckgo-search, youtube-transcript-api, beautifulsoup4
• pandas + matplotlib (analisis dan grafik)
• Deployment Docker + Fly.io (Procfile dan docker-compose juga tersedia)

Status & Kematangan

Aktif. Repositorinya membawa dokumentasi operasional yang luar biasa lengkap — panduan deployment, panduan multi-tenant, daftar periksa penyiapan, referensi cepat, serta laporan implementasi untuk peningkatan pengambilan yang sendirian saja mencakup sekitar 1.750 baris. Ada empat suite test, cakupan yang nyata tetapi sederhana untuk basis kode sebesar ini; khususnya integrasi Google masih diverifikasi manual terhadap akun sungguhan.

Metrik Terukur