Siklus Hidup Sesi

Sesi adalah unit kerja inti dalam Whisperer: rentang waktu saat klien mendengarkan rapat, menyusun transkrip ucapan, dan menerima respons LLM. Memahami siklus hidupnya membantu Anda menggunakan mulai/jeda dengan benar, menafsirkan status di dasbor, dan memecahkan masalah.

Kapan Membaca Ini

Baca artikel ini jika Anda ingin memahami:

  • apa yang terjadi pada data Anda di setiap fase rapat;
  • mengapa respons terkadang tertunda dan kapan transkrip disimpan;
  • bagaimana koneksi antara klien dan server bekerja.

Fase-Fase Sesi

1. Mulai

Menekan tombol "Mulai" (atau pintasan keyboard) menempatkan klien ke mode aktif:

  1. Klien membuka koneksi ke server dan mengirimkan pengenal perangkat serta token.
  2. Server memvalidasi langganan dan kuota menit. Jika pemeriksaan lolos, server mengonfirmasi awal sesi dan mengembalikan pengenal sesi.
  3. Klien mengaktifkan penangkapan audio dan mulai merekam.

2. Perekaman (Streaming)

Audio dikirimkan dalam potongan-potongan singkat setiap ~0,8 detik. Setiap potongan diberi label dengan pembicara: pengguna atau lawan bicara.

Server menyangga potongan-potongan tersebut dan mengirimkannya untuk dikenali. Transkrip dikembalikan ke klien secara waktu nyata dan ditampilkan di LiveTranscriptStrip.

3. Permintaan dan Respons

Saat pengguna menekan "Tanya" (atau pintasan keyboard), klien mengirimkan bingkai ask dengan konteks transkrip saat ini.

Server menyusun prompt sistem (prompt peran → konteks pengguna → RAG dari basis pengetahuan) dan menanyakan LLM. Respons mengalir masuk: teks muncul saat dihasilkan dan langsung ditampilkan di AnswerArea dengan dukungan Markdown dan paginasi (jika ada beberapa respons).

4. Jeda

Menekan "Jeda" menghentikan penangkapan audio, tetapi koneksi WebSocket tetap terbuka. Pengatur waktu sesi dijeda. Lanjutkan dengan menekan "Lanjutkan".

5. Akhiri

Menekan "Berhenti" atau menutup klien:

  1. Klien mengirimkan bingkai session.end.
  2. Server membuang transkrip yang tersangga dan daftar respons yang telah selesai ke basis data.
  3. WebSocket ditutup.
  4. Di dasbor web, sesi muncul di bagian Riwayat dengan transkrip lengkap dan analitik.

📸 [Tangkapan layar: panel Whisperer dalam mode perekaman — LiveTranscriptStrip dan tombol kontrol terlihat]

Penyimpanan Data

Secara bawaan, transkrip dan respons LLM disimpan ke basis data dan dapat diakses di dasbor. Jika mode no-logs diaktifkan, data dihapus setelah sesi berakhir — tetapi menit yang terpakai tetap dihitung.

Kesalahan Umum

Kesalahan Penyebab Solusi
Sesi tidak dimulai Email belum dikonfirmasi atau tidak ada langganan aktif Periksa status akun dan kuota
"Tidak bisa mendengar lawan bicara" Izin perekaman layar belum diberikan (macOS) atau penangkapan audio sistem tidak tersedia (Windows) Izin macOS / Windows
Transkrip tidak muncul Koneksi internet buruk atau WebSocket terputus Periksa jaringan Anda; mulai ulang sesi
Respons LLM terlalu lama Penyedia AI kelebihan beban atau model lambat dipilih Ganti model di pengaturan

Praktik Terbaik

  • Hentikan sesi secara eksplisit dengan tombol "Berhenti" — ini menjamin data tertulis ke riwayat.
  • Jeda selama jeda panjang dalam rapat — pengatur waktu berhenti dan menit tidak terbuang.
  • Gunakan no-logs untuk rapat rahasia di mana penyimpanan transkrip tidak diinginkan.

Artikel Terkait