Pemecahan Masalah
Panduan ini mencakup masalah umum yang mungkin Anda temui saat menggunakan Neotask dan cara mengatasinya.
Lisensi & Aktivasi
"Kunci lisensi tidak valid"
- Verifikasi format kunci:
SC-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX - Periksa spasi ekstra atau karakter yang hilang
- Pastikan Anda memiliki koneksi internet aktif
- Coba masukkan kunci kembali dengan hati-hati
"Lisensi dicabut"
- Lisensi Anda telah dicabut oleh server
- Periksa status penagihan Anda di neotask.ai
- Hubungi dukungan jika Anda yakin ini adalah kesalahan
"Lisensi kedaluwarsa"
- Langganan Anda telah berakhir
- Perbarui paket Anda melalui portal penagihan
- Aplikasi masuk mode baca-saja saat kedaluwarsa
"Masa tenggang offline kedaluwarsa"
- Anda telah offline lebih dari 72 jam
- Hubungkan ke internet untuk revalidasi otomatis
- Aplikasi akan melanjutkan operasi normal setelah terhubung
"Versi diblokir"
- Versi aplikasi Anda telah diblokir karena alasan keamanan
- Segera perbarui ke versi terbaru
- Pembaruan otomatis akan memberi tahu Anda; jika tidak, unduh dari situs web
Masalah Gateway
"Gateway gagal dimulai"
- Periksa apakah port 18789 tersedia (tidak digunakan oleh aplikasi lain)
- Coba mulai ulang aplikasi
- Periksa kesehatan gateway dari dashboard
- Jika menggunakan macOS, pastikan aplikasi memiliki izin yang diperlukan di System Preferences → Privacy & Security
"Penguncian 3-percobaan"
- Setelah 3 kegagalan gateway berturut-turut, operasi diblokir
- Mulai ulang aplikasi untuk mengatur ulang penghitung penguncian
- Jika tetap terjadi, periksa log untuk error yang mendasarinya
"Gateway terputus"
- Runtime lokal kehilangan koneksi
- Klik "Reconnect" di panel gateway
- Jika terus terputus, mulai ulang aplikasi
- Pastikan tidak ada firewall yang memblokir koneksi localhost
Masalah Suara
"Tidak ada input audio yang terdeteksi"
- Berikan izin mikrofon:
- macOS: System Preferences → Privacy & Security → Microphone → Aktifkan untuk Neotask
- Windows: Settings → Privacy → Microphone → Izinkan aplikasi untuk mengakses
- Periksa bahwa mikrofon Anda tidak dibisukan
- Verifikasi perangkat input yang benar dipilih di pengaturan sistem
"Kata pemicu tidak berfungsi"
- Pastikan aktivasi suara diaktifkan di Settings
- Periksa bahwa mode pemicu diatur ke "Porcupine" (bukan "Shortcut" atau "Off")
- Ucapkan frasa pemicu dengan jelas: "Hey Neotask"
- Coba pintasan keyboard sebagai gantinya (Cmd+Shift+Space / Ctrl+Shift+Space)
- Periksa apakah aplikasi lain menggunakan mikrofon
"Audio TTS terputus-putus atau tertunda"
- Periksa koneksi internet Anda (TTS memerlukan ElevenLabs API)
- ElevenLabs mungkin mengalami pembatasan permintaan
- Coba suara berbeda dari Settings
- Kurangi aktivitas jaringan latar belakang
"Pintasan suara tidak berfungsi"
- Aplikasi lain mungkin telah mengklaim pintasan yang sama
- Ubah pintasan di Settings → Activation → Keyboard Shortcut
- Di macOS, periksa System Preferences → Keyboard → Shortcuts untuk konflik
Koneksi & Jaringan
"Tidak dapat terhubung ke server"
- Verifikasi koneksi internet Anda
- Periksa apakah neotask.ai dapat diakses di browser Anda
- Jika di balik firewall perusahaan, pastikan lalu lintas HTTPS diizinkan
- Coba nonaktifkan VPN sementara
"Permintaan API gagal"
- Periksa koneksi internet Anda
- Verifikasi bahwa lisensi Anda aktif
- Jika menggunakan BYOK, periksa bahwa kunci API Anda valid dan memiliki kredit
- Coba segarkan dashboard
Agen & Sesi
"Tidak dapat membuat agen: batas tercapai"
- Jumlah agen tidak dibatasi oleh paket; pembuatan agen kustom memerlukan paket berbayar
- Jika Anda melihat pesan ini pada paket Free, tingkatkan ke paket berbayar untuk membuat agen kustom
- Hapus agen yang tidak digunakan agar ruang kerja Anda tetap rapi
"Agen tidak merespons"
- Periksa kesehatan gateway (harus berjalan)
- Verifikasi bahwa model agen dapat diakses (kunci API valid, provider tersedia)
- Periksa anggaran harian, jika terlampaui, agen dijeda hingga tengah malam UTC
- Coba atur ulang sesi
"Pesan sesi tidak memuat"
- Segarkan halaman/aplikasi
- Periksa status koneksi gateway
- Jika sesi sangat panjang, coba buat sesi baru
Penagihan & Pembayaran
"Pembayaran gagal"
- Verifikasi detail kartu Anda sudah benar
- Tanyakan ke bank Anda untuk pemblokiran transaksi internasional
- Coba metode pembayaran lain
- Hubungi dukungan jika masalah berlanjut
"Alokasi penggunaan terlampaui"
- Konsumsi token agen Anda telah melebihi alokasi yang termasuk dalam langganan Anda
- Penggunaan tambahan ditagih dengan tarif penggunaan. Periksa halaman Penggunaan di dashboard Anda untuk detailnya.
- Beralih ke mode BYOK (gunakan kunci API Anda sendiri) untuk mengarahkan biaya token langsung ke provider Anda
- Tetapkan batas anggaran harian untuk mencegah kelebihan yang tidak terduga
"Paket tidak diperbarui setelah pembayaran"
- Webhook Stripe mungkin memiliki sedikit penundaan (biasanya di bawah 1 menit)
- Segarkan dashboard
- Jika masih belum diperbarui setelah 5 menit, hubungi dukungan dengan konfirmasi pembayaran Anda
Performa
"Aplikasi lambat saat startup"
- Validasi lisensi dan startup gateway terjadi saat peluncuran, ini normal
- Pastikan sistem Anda memenuhi persyaratan minimum
- Tutup aplikasi latar belakang yang tidak diperlukan
"Penggunaan CPU tinggi"
- Jika menggunakan kata pemicu yang selalu aktif (Porcupine), ini menggunakan CPU minimal tetapi dapat dinonaktifkan
- Jeda sesi suara saat tidak digunakan
- Periksa proses gateway yang macet di Activity Monitor / Task Manager
"Penggunaan memori tinggi"
- Sesi chat yang panjang mengakumulasi memori
- Buat sesi baru secara berkala
- Mulai ulang aplikasi untuk membersihkan status yang terakumulasi
Mendapatkan Bantuan
- Dokumentasi: Anda berada di sini, telusuri basis pengetahuan
- Dukungan: Kunjungi halaman Dukungan di neotask.ai/support
- Kontak: Gunakan formulir kontak di situs web
- Status: Periksa status layanan di neotask.ai