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"

1. Periksa apakah port 18789 tersedia (tidak digunakan oleh aplikasi lain)
2. Coba mulai ulang aplikasi
3. Periksa kesehatan gateway dari dashboard
4. 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"

1. Pastikan aktivasi suara diaktifkan di Settings
2. Periksa bahwa mode pemicu diatur ke "Porcupine" (bukan "Shortcut" atau "Off")
3. Ucapkan frasa pemicu dengan jelas: "Hey Neotask"
4. Coba pintasan keyboard sebagai gantinya (Cmd+Shift+Space / Ctrl+Shift+Space)
5. 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