Lewati ke isi

Review AI Suggestions per Cluster

Tujuan

Halaman ini menjelaskan alur PIC (per-cluster reviewer) untuk membersihkan antrian AI Suggestions — kandidat Q/A hasil generasi AI Crawler v1 yang menunggu validasi sebelum masuk ke knowledge base chatbot.

Tujuan dari proses review: pastikan setiap pertanyaan + jawaban akurat, sesuai konteks UPH, dan tidak hasil halusinasi LLM.

Prasyarat

  • Akses ke https://form.huph.val.id (perlu SITE_PASSWORD dari admin team — lihat halaman Site Gate)
  • Magic link valid untuk session PIC sesuai cluster yang Anda review (CASS / CBT / CHS / CIST / CNE)
  • Memahami konten faktual dari halaman web UPH yang menjadi sumber kandidat (saat ini: 5 fakultas resmi di uph.edu)

Alur kerja

1. Masuk ke portal cluster

Buka https://form.huph.val.id/cluster/<KODE> (misal /cluster/CASS).

Setelah cookie gate aktif, pilih tab AI Suggestions di portal cluster Anda.

2. Pahami filter pills

Empat pill di atas list menunjukkan status review per cluster:

Pill Arti Apa yang ada di sini
Pending Belum direview Antrian Anda — fokus utama
Accepted Disetujui apa adanya Audit history (read-only)
Rejected Ditolak dengan alasan Audit history (read-only)
Edited Diedit lalu disetujui Audit history (read-only)

Angka di samping label = jumlah row di status tersebut. Counter di bawah pills (M dari N total telah direview) menunjukkan progress total cluster Anda.

3. Aksi per row

Setiap kartu suggestion menampilkan:

  • Pertanyaan (textarea — bisa diedit)
  • Jawaban (textarea — bisa diedit)
  • Source URL dengan link ke halaman asal (klik "Show source passage" untuk melihat kutipan verbatim yang digunakan AI)

Empat keputusan yang bisa Anda ambil:

Keputusan Tombol Kapan dipakai
Accept Tombol amber tanpa edit Pertanyaan + jawaban sudah tepat, tidak perlu ubahan
Edit & Accept Otomatis muncul saat textarea diubah Konten benar tapi perlu polish (misal grammar, terminologi UPH)
Reject Tombol abu-abu, perlu alasan ≥10 karakter Konten salah faktual, halusinasi, atau di luar scope cluster
Skip (tidak ada — review berurutan) Lewati dengan refresh halaman, akan kembali sebagai Pending

Bulk accept untuk batch yang clean

Jika 8-9 kandidat dalam satu halaman semua kelihatan benar tanpa perlu edit, gunakan tombol "Accept N di halaman ini" di bagian atas. Konfirmasi dua-klik (Yakin accept N) untuk hindari misclick. Tombol nonaktif jika ada row dengan textarea yang sedang Anda edit — selesaikan dulu yang mana pun.

4. Pagination

Jika cluster Anda punya lebih dari 25 pending, akan muncul tombol Sebelumnya / Berikutnya di bawah list dengan indikator "Halaman X dari Y". Ganti halaman tidak menyimpan perubahan textarea yang belum di-submit — selesaikan dulu sebelum navigasi.

Kriteria reject

Reject dengan alasan jelas (≥10 karakter) jika:

  1. Salah fakta — angka, nama jurusan, atau klaim tidak ada di sumber atau bertentangan dengan halaman UPH lain.
  2. Halusinasi — kalimat kelihatan masuk akal tapi tidak ada landasan di source quote (cek dengan klik "Show source passage").
  3. Out of scope cluster — kandidat untuk halaman fakultas medicine masuk ke CASS, misalnya.
  4. Generic/vague — pertanyaan terlalu umum sampai tidak actionable bagi calon mahasiswa (mis. "Apakah UPH bagus?").
  5. Duplikat — kandidat hampir identik dengan FAQ atau Live KB yang sudah ada.

Alasan reject masuk ke kolom audit dan akan dipakai tim engineering untuk tuning prompt AI di iterasi berikutnya.

Setelah Anda accept

  • Status row berubah ke accepted atau edited_accepted
  • reviewed_by_session_id + reviewed_at tercatat untuk audit
  • Belum otomatis masuk ke FAQ atau Live KB — tahap berikutnya (Phase berikut yang belum dirilis) akan menyalin accepted suggestions ke faq_local setelah review final dari admin team

Selama tahap ini, accepted = "siap untuk promote" dan reject = "jangan gunakan". Tab Accepted/Rejected adalah audit trail keputusan Anda.

FAQ

Berapa lama tab Pending diisi ulang?

Saat ini AI Crawler dijalankan manual oleh tim engineering (belum cron otomatis). Jika antrian habis dan Anda butuh batch baru, hubungi engineering. Cron schedule akan diaktifkan setelah pola review PIC stabil.

Bagaimana jika source URL ternyata error 404?

Reject dengan alasan "source not accessible — broken link". Tim engineering akan update URL_SEEDS di crawler.

Bisa edit setelah accept?

Tidak melalui tab AI Suggestions — pindah ke FAQ atau Live KB management setelah row dipromote ke faq_local. Tab Accepted di sini read-only (textarea disabled).

Lihat juga