# Cara Mengulas Dokumen & Fragmen

**Berkolaborasi dalam konteks – bincangkan keseluruhan dokumen atau perenggan khusus, tag rakan sepasukan dengan @sebutan, dan terima notifikasi serta‑merta.**

> **Berkenaan:** Procurize.AI Pangkalan Pengetahuan → Dokumen  
> **Peranan pengguna:** Pentadbir, Penyunting, Pengurus Keselamatan (boleh mengulas) | Pemeriksa (baca‑saja)

## Gambaran Keseluruhan

Procurize.AI kini memperkenalkan **ulasan dalam‑konteks** dari modul Soal Selidik ke **dokumen Pangkalan Pengetahuan** anda. Anda boleh meninggalkan maklum balas, mengajukan soalan, atau memulakan perbincangan:

- Pada **keseluruhan dokumen** – gunakan butang bar alat  
- Pada **fragmen tertentu** (perenggan, tajuk, item senarai, sel jadual) – gunakan ikon ulasan di atas setiap fragmen  

Semua ulasan dapat dilihat oleh semua orang. Pengguna yang **@disebut** akan menerima notifikasi. Pemeriksa dapat membaca semua ulasan tetapi tidak dapat menulis atau membalas.

## Siapa Boleh Buat Apa

| Tindakan | Pentadbir | Penyunting | Pengurus Keselamatan | Pemeriksa |
|----------|-----------|------------|----------------------|-----------|
| Lihat semua ulasan | ✅ | ✅ | ✅ | ✅ |
| Tinggalkan ulasan baru (dokumen atau fragmen) | ✅ | ✅ | ✅ | ❌ |
| Balas ulasan | ✅ | ✅ | ✅ | ❌ |
| @sebut pengguna lain | ✅ | ✅ | ✅ | ❌ |
| Terima notifikasi ketika disebut | ✅ | ✅ | ✅ | ✅ |
| Ikuti dokumen (terima notifikasi semua ulasan baru) | ✅ | ✅ | ✅ | ✅ |

> 🔒 **Peranan Pemeriksa** mempunyai keistimewaan minimum – akses baca‑saja ke ulasan untuk semakan pematuhan.  
> 👁️ **Butang “Ikuti”** tersedia untuk semua orang – klik pada mana‑mana dokumen untuk menerima notifikasi e‑mel/dalam‑aplikasi bagi **semua** ulasan baru (bukan hanya @sebutan).

## Dua Cara untuk Tinggalkan Ulasan

### 1. Ulas Keseluruhan Dokumen

Buka mana‑mana dokumen → **Bar Alat** → klik **“Tinggalkan ulasan”** (ikon gelembung ucapan).

- Panel ulasan terbuka di sebelah kanan.  
- Taip mesej anda, @sebut rakan sekerja jika perlu, dan hantar.  
- Ulasan tersebut dikaitkan dengan **dokumen secara keseluruhan** – bukan kepada fragmen tertentu.

Gunakan ini untuk: maklum balas umum, permintaan kelulusan, atau soalan yang berlaku ke seluruh dokumen.

![Tinggalkan ulasan pada dokumen](/images/docs/doc-comment-button.png "Tinggalkan ulasan pada dokumen")

### 2. Ulas Fragmen Tertentu (Dalam‑Konteks)

Semasa melihat dokumen, **setiap fragmen** (perenggan, tajuk, senarai, baris jadual) mempunyai ikon **“Tinggalkan ulasan”** kecil di atasnya (di sebelah kanan).

Klik ikon tersebut → panel ulasan terbuka, **dipautkan kepada fragmen itu tepat**.

- Fragmen tersebut disorot ketika ulasan aktif.  
- Balasan tetap melekat pada fragmen yang sama.  
- Navigasi dari senarai ulasan melompat terus ke fragmen tersebut dalam penonton dokumen.

Gunakan ini untuk: mencadangkan perubahan perkataan, menanyakan klausa tertentu, atau menandakan ketidakserasian dalam satu ayat.

![Tinggalkan ulasan pada bahagian dokumen](/images/docs/doc-section-comment-button.png "Tinggalkan ulasan pada bahagian dokumen")

## Membalas Ulasan & Perbincangan Berulir

- Sebarang ulasan (pada peringkat dokumen atau fragmen) boleh mempunyai **balasan bersarang**.  
- Untuk membalas: klik **“Balas”** di bawah ulasan → taip jawapan anda → hantar.  
- Semua balasan tetap berkumpul dalam satu thread, memastikan konteks tetap jelas.

> 💡 Ini berfungsi tepat seperti panel pesanan Soal Selidik, tetapi terikat kepada fragmen dokumen.

## @Sebut & Notifikasi

Apabila anda menaip `@` diikuti nama pengguna atau e‑mel, Procurize.AI mencadangkan pengguna dari ruang kerja anda.

- Pengguna yang disebut menerima **notifikasi e‑mel** (dan notifikasi dalam aplikasi, jika diaktifkan).  
- Notifikasi tersebut mengandungi: nama dokumen, kutipan fragmen (jika ulasan fragmen), dan mesej anda.  
- Mengklik pautan notifikasi membuka dokumen dan menatal ke fragmen tepat (atau tajuk dokumen).

> ⚠️ Hanya pengguna yang **boleh mengulas** (Pentadbir, Penyunting, Penonton) boleh menggunakan @sebut. Pemeriksa tidak boleh menyebut orang lain (kerana mereka tidak dapat menulis).

## Melihat Semua Ulasan

Semua orang (termasuk Pemeriksa) dapat melihat semua ulasan:

- **Ulasan peringkat dokumen** – kelihatan dalam panel ulasan sebelah kanan (dibuka melalui bar alat).  
- **Ulasan peringkat fragmen** – kelihatan dalam panel ulasan **dan** ditandai dengan lencana kecil di atas fragmen (menunjukkan kiraan ulasan).  
- Klik mana‑mana ulasan dalam panel → dokumen menatal ke fragmen berkenaan (atau ke bahagian atas dokumen untuk ulasan peringkat dokumen).

## Aliran Kerja Contoh – Menyemak Kontrak

1. **Ketua Undang‑Undang (Penyunting)** membuka perjanjian pembekal → klik **“Tinggalkan ulasan”** di atas perenggan pampasan.  
2. Menulis: `@John_Procurement Adakah had liabiliti sudah betul pada $500k? Ini bercanggah dengan polisi standard kami.`  
3. **John (Penonton)** menerima notifikasi e‑mel → mengklik pautan → melihat perenggan yang disorot.  
4. John membalas: `Bagus – sepatutnya $1M. Saya akan edit selepas pengesahan.`  
5. **Pemeriksa** kemudian membuka dokumen yang sama, membaca seluruh thread, tetapi tidak dapat menulis.

Semua komunikasi kekal di dalam Procurize.AI – tiada e‑mel atau thread Slack yang hilang.

## Ulasan vs. Analisis AI – Cara Mereka Bekerjasama

| Ciri | Tujuan |
|------|--------|
| **Analisis AI** | Secara automatik mengesan ketidakserasian & mencadangkan pembaikan |
| **Ulasan** | Kolaborasi manusia – ajukan soalan, cadangkan perubahan, minta penjelasan |

Anda boleh meninggalkan ulasan **pada fragmen yang mempunyai amaran AI** – contohnya: *“AI berkata ini bercanggah dengan polisi X – bolehkah kita semak bersama?”*

## Soalan Lazim (FAQ)

**S: Bolehkah saya mengedit atau memadam ulasan saya sendiri?**  
J: Ya – tetapi hanya jika tiada siapa yang membalasnya. Sekiranya ulasan sudah mempunyai balasan, penyuntingan dan pemadaman dimatikan supaya thread kekal konsisten.

**S: Apa yang berlaku kepada ulasan apabila fragmen diubah?**  
J: Fragmen lama ditandakan sebagai "Terpadam". Jika fragmen tersebut mempunyai ulasan, ulasan itu tetap kelihatan dalam panel ulasan global selepas anda mengaktifkan **“Tunjuk bahagian terpadam”** (pilihan ini muncul hanya bila terdapat fragmen terpadam). Anda masih boleh melihat dan membalas ulasan tersebut. Fragmen tanpa ulasan dibuang secara kekal.

**S: Bolehkah saya membalas ulasan pada fragmen yang telah dipadam?**  
J: Ya – dengan “Tunjuk bahagian terpadam” dihidupkan, butang balas tetap aktif.

**S: Adakah thread ulasan masih ada selepas kemas kini dokumen?**  
J: Ulasan pada fragmen yang tidak diubah tetap melekat. Ulasan pada fragmen yang diedit berpindah ke keadaan “Terpadam” (lihat di atas).

**S: Bolehkah saya mendapat notifikasi bagi sebarang ulasan baru tanpa @sebut?**  
J: Pada masa ini, hanya @sebut yang memicu notifikasi. Gunakan butang **“Ikuti”** untuk memantau dokumen.

**S: Apa yang berlaku apabila Pemeriksa cuba menulis ulasan?**  
J: Butang “Tinggalkan ulasan” disembunyikan/diaktifkan. Pemeriksa bersifat baca‑saja untuk ulasan.

**S: Adakah ulasan tersedia dalam modul Soal Selidik juga?**  
J: Ya – Soal Selidik mempunyai panel pesanan berasingan. Artikel ini hanya merangkumi **dokumen Pangkalan Pengetahuan**.

{{<article-feedback>}}

## Artikel Berkaitan

[How to edit a document](/how-to-edit-a-document)

[What is AI Document Analysis?](/what-is-ai-document-analysis)

[How to use AI Document Analysis](/how-to-use-ai-document-analysis)

[How to communicate in questionnaires](/how-to-communicate-within-the-questionnaire)

[Roles and Permissions](/what-user-permissions-does-procurize-have)