# ドキュメントとフラグメントへのコメント方法

**文脈の中で協働 – ドキュメント全体や特定の段落について議論し、@メンションでチームメイトをタグ付けし、即座に通知を受け取りましょう。**

> **対象:** Procurize.AI ナレッジベース → ドキュメント  
> **ユーザーロール:** 管理者、編集者、セキュリティマネージャー（コメント可） | 監査人（閲覧のみ）

## 概要

Procurize.AI は **アンケートモジュール** で提供されていた **インコンテキストコメント** 機能を、**ナレッジベースのドキュメント** にも拡張しました。フィードバックや質問、議論を開始できます。

- **ドキュメント全体** に対して – ツールバーのボタンを使用  
- **特定のフラグメント**（段落、見出し、リスト項目、表のセル）に対して – 各フラグメント上部のコメントアイコンを使用  

すべてのコメントは全員に公開されます。@メンションされたユーザーには通知が届きます。監査人はコメントを読むことはできますが、投稿や返信はできません。

## できることのロール別一覧

| アクション | 管理者 | 編集者 | セキュリティマネージャー | 監査人 |
|-----------|--------|--------|---------------------------|--------|
| すべてのコメントを表示 | ✅ | ✅ | ✅ | ✅ |
| 新規コメントを残す（ドキュメントまたはフラグメント） | ✅ | ✅ | ✅ | ❌ |
| コメントに返信する | ✅ | ✅ | ✅ | ❌ |
| 他ユーザーを @メンションする | ✅ | ✅ | ✅ | ❌ |
| メンションされたときに通知を受け取る | ✅ | ✅ | ✅ | ✅ |
| ドキュメントを「フォロー」して全コメントの通知を受け取る | ✅ | ✅ | ✅ | ✅ |

> 🔒 **監査人ロール** は最小限の権限 – コメントは閲覧のみで、コンプライアンスレビューに使用します。  
> 👁️ **「フォロー」ボタン** は全員が使用可能 – 任意のドキュメントでクリックすると、@メンションの有無に関わらず **すべての新規コメント** のメール／アプリ内通知を受け取れます。

## コメントの残し方は 2 通り

### 1. ドキュメント全体にコメントする

任意のドキュメントを開く → **ツールバー** → **「コメントを残す」**（吹き出しアイコン）をクリック。

- 右側にコメントパネルが開きます。  
- メッセージを入力し、必要なら @メンションで同僚を呼び出し、投稿します。  
- コメントは **ドキュメント全体** に紐付けられ、特定のフラグメントには結びつきません。

以下のような場面で使用してください: 全体的なフィードバック、承認依頼、全体に関わる質問など。

![ドキュメントにコメントを残す](/images/docs/doc-comment-button.png)

### 2. 特定のフラグメントにコメントする（インコンテキスト）

ドキュメント閲覧中、**各フラグメント**（段落、見出し、リスト、表の行）の上部右側に小さな **「コメントを残す」** アイコンが表示されます。

そのアイコンをクリック → コメントパネルが開き、**そのフラグメントに直接リンク** されます。

- コメントがアクティブになると対象フラグメントがハイライトされます。  
- 返信も同じフラグメントに付随します。  
- コメントリストからのナビゲーションは、直接該当フラグメントへジャンプします。

以下のような場面で使用してください: 文言変更の提案、特定条項への質問、1 文の不整合指摘など。

![ドキュメントのセクションにコメントを残す](/images/docs/doc-section-comment-button.png)

## コメントへの返信とスレッド化

- ドキュメントレベルでもフラグメントレベルでも **入れ子状の返信** が可能です。  
- 返信するには、コメント下部の **「返信」** をクリック → メッセージを入力 → 投稿します。  
- すべての返信は同一スレッドにまとめられ、文脈が明確に保たれます。

> 💡 この操作感はアンケートのメッセージパネルと同一ですが、対象がドキュメントのフラグメントに固定されている点が異なります。

## @メンションと通知

`@` に続けてユーザー名やメールアドレスを入力すると、Procurize.AI がワークスペース内のユーザーをサジェストします。

- メンションされたユーザーには **メール通知**（設定によりアプリ内通知も）が届きます。  
- 通知にはドキュメント名、フラグメントの抜粋（フラグメントコメントの場合）、およびメッセージ本文が含まれます。  
- 通知リンクをクリックすると、ドキュメントが開き該当フラグメントまで自動スクロールします。

> ⚠️ @メンションは **コメント権限があるユーザー**（管理者、編集者、ビューア）だけが利用できます。監査人はコメントできないためメンションもできません。

## すべてのコメントを閲覧する

全員（監査人を含む）がすべてのコメントを確認できます。

- **ドキュメントレベルのコメント** – ツールバー経由で開く右側パネルに表示。  
- **フラグメントレベルのコメント** – 右側パネルに加えて、フラグメント上部に小さなバッジ（コメント数）で表示。  
- 任意のコメントをパネルでクリックすると、ドキュメントが該当フラグメント（またはドキュメント冒頭）へスクロールします。

## ワークフロー例 – 契約書のレビュー

1. **リーガルリード（編集者）** がサプライヤー契約書を開き、保証条項の上部にある **「コメントを残す」** をクリック。  
2. `@John_Procurement リスク上限が 500k USD で正しいですか？ 当社の標準ポリシーと食い違っています。` と入力。  
3. **John（ビューア）** がメール通知を受け取り、リンクをクリックするとハイライトされた段落が表示。  
4. John が返信: `指摘通りです – 1M にすべきです。確認後に編集します。`  
5. **監査人** が同じドキュメントを開き、スレッド全体を確認できるが投稿はできない。  

すべてのやり取りは Procurize.AI 内に収まり、メールや Slack のスレッドが散逸することはありません。

## コメントと AI 分析の組み合わせ

| 機能 | 目的 |
|------|------|
| **AI 分析** | 不整合を自動検出し、修正案を提示 |
| **コメント** | 人間同士の協働 – 質問、変更提案、確認依頼 |

AI 警告が出ているフラグメントにも **コメント** を残せます。例: *「AI がポリシー X と衝突していると指摘しています – 共同で確認しましょう」*

## FAQ（よくある質問）

**Q: 自分のコメントを編集または削除できますか？**  
A: はい。ただし、誰かが返信している場合は編集・削除できません。スレッドの整合性を保つためです。

**Q: フラグメントを編集した場合、コメントはどうなりますか？**  
A: 編集前のフラグメントは「削除済み」とマークされます。コメントが付いていた場合は、**「削除済みセクションを表示」** を有効にするとグローバルコメントパネルに残ります（このオプションは削除済みフラグメントがあるときだけ表示）。コメントのないフラグメントは完全に削除されます。

**Q: 削除済みフラグメントに対して返信できますか？**  
A: 「削除済みセクションを表示」状態では、返信ボタンは有効です。

**Q: ドキュメントが更新されてもスレッドは残りますか？**  
A: 変更が加えられていないフラグメントのコメントはそのまま保持されます。変更されたフラグメントのコメントは「削除済み」状態に移行します（上記参照）。

**Q: @メンションされなくても新規コメントの通知を受け取れますか？**  
A: 現時点では @メンションが通知の唯一のトリガーです。全コメントの通知を受け取りたい場合は **「フォロー」** ボタンでドキュメントを監視してください。

**Q: 監査人がコメントしようとしたらどうなりますか？**  
A: 「コメントを残す」ボタンは非表示または無効化されます。監査人はコメントを閲覧するだけの権限です。

**Q: アンケートモジュールでもコメント機能は利用できますか？**  
A: はい。アンケートには別途メッセージパネルが用意されています。この記事は **ナレッジベースのドキュメント** に限定しています。

{{<article-feedback>}}

## 関連記事

[ドキュメントの編集方法](/how-to-edit-a-document)

[AI ドキュメント分析とは](/what-is-ai-document-analysis)

[AI ドキュメント分析の使い方](/how-to-use-ai-document-analysis)

[アンケート内でのコミュニケーション方法](/how-to-communicate-within-the-questionnaire)

[ロールと権限](/what-user-permissions-does-procurize-have)