# Como Comentar em Documentos & Fragmentos

**Colabore no contexto – discuta documentos inteiros ou parágrafos específicos, marque colegas com @menções e receba notificações instantâneas.**

> **Aplica‑se a:** Procurize.AI Base de Conhecimento → Documentos  
> **Papéis de usuário:** Administrador, Editor, Gerente de Segurança (pode comentar) | Auditor (somente visualização)

## Visão geral

Procurize.AI agora traz **comentários no contexto** do módulo de Questionário para seus **documentos da Base de Conhecimento**. Você pode deixar feedback, fazer perguntas ou iniciar uma discussão:

- No **documento inteiro** – usando o botão da barra de ferramentas  
- Em um **fragmento específico** (parágrafo, título, item de lista, célula de tabela) – usando o ícone de comentário acima de cada fragmento

Todos os comentários são visíveis para todos. Usuários que são **@mencionados** recebem notificações. Auditores podem ler todos os comentários, mas não podem publicar ou responder.

## Quem pode fazer o quê

| Ação | Administrador | Editor | Gerente de Segurança | Auditor |
|------|---------------|--------|----------------------|---------|
| Visualizar todos os comentários | ✅ | ✅ | ✅ | ✅ |
| Deixar um novo comentário (documento ou fragmento) | ✅ | ✅ | ✅ | ❌ |
| Responder a um comentário | ✅ | ✅ | ✅ | ❌ |
| @mencionar outro usuário | ✅ | ✅ | ✅ | ❌ |
| Receber notificações quando mencionado | ✅ | ✅ | ✅ | ✅ |
| Seguir um documento (receber notificações de todos os novos comentários) | ✅ | ✅ | ✅ | ✅ |

> 🔒 **Papel de Auditor** tem privilégios mínimos – acesso somente leitura aos comentários para revisão de conformidade.  
> 👁️ O **botão “Seguir”** está disponível para todos – clique nele em qualquer documento para receber notificações por email/aplicativo de **todos** os novos comentários (não apenas @menções).

## Duas formas de deixar comentários

### 1. Comentar no Documento Inteiro

Abra qualquer documento → **Barra de ferramentas** → clique **“Deixar um comentário”** (ícone de balão de fala).

- Um painel de comentário abre à direita.  
- Digite sua mensagem, @mencione colegas se necessário e publique.  
- O comentário fica vinculado ao **documento como um todo** – não a um fragmento específico.

Use isso para: feedback geral, solicitações de aprovação ou perguntas que se aplicam a todo o documento.

![Deixe um comentário no documento](/images/docs/doc-comment-button.png)

### 2. Comentar em um Fragmento Específico (No Contexto)

Ao visualizar um documento, **cada fragmento** (parágrafo, título, lista, linha de tabela) tem um pequeno ícone **“Deixar um comentário”** acima dele (do lado direito).

Clique nesse ícone → um painel de comentário abre, **pré‑vinculado àquele fragmento exato**.

- O fragmento é destacado quando o comentário está ativo.  
- As respostas permanecem anexadas ao mesmo fragmento.  
- A navegação a partir da lista de comentários pula diretamente para aquele fragmento no visualizador de documento.

Use isso para: sugerir uma mudança de redação, perguntar sobre uma cláusula específica ou sinalizar uma inconsistência em uma frase.

![Deixe um comentário na seção do documento](/images/docs/doc-section-comment-button.png)

## Respondendo a Comentários & Discussões em Thread

- Qualquer comentário (de nível de documento ou de fragmento) pode ter **respostas aninhadas**.  
- Para responder: clique **“Responder”** sob o comentário → digite sua resposta → publique.  
- Todas as respostas permanecem agrupadas em um thread, mantendo o contexto claro.

> 💡 Isso funciona exatamente como o painel de mensagens do Questionário, mas ancorado aos fragmentos do documento.

## @Menções & Notificações

Quando você digita `@` seguido de um nome de usuário ou email, o Procurize.AI sugere usuários do seu espaço de trabalho.

- Usuários mencionados recebem uma **notificação por email** (e notificação no aplicativo, se habilitada).  
- A notificação inclui: nome do documento, citação do fragmento (se comentário de fragmento) e sua mensagem.  
- Clicar no link da notificação abre o documento e rola até o fragmento exato (ou cabeçalho do documento).

> ⚠️ Apenas usuários que **podem comentar** (Administrador, Editor, Visualizador) podem usar @menções. Auditores não podem mencionar outros (já que não podem publicar).

## Visualizando Todos os Comentários

Todos (incluindo Auditores) podem ver todos os comentários:

- **Comentários de nível de documento** – visíveis no painel de comentários à direita (aberto via barra de ferramentas).  
- **Comentários de nível de fragmento** – visíveis tanto no painel de comentários **quanto** indicados por um pequeno selo acima do fragmento (mostrando a contagem de comentários).  
- Clique em qualquer comentário no painel → o documento rola até o fragmento relacionado (ou ao topo do documento para comentários de nível de documento).

## Fluxo de Exemplo – Revisão de um Contrato

1. **Líder Jurídico (Editor)** abre um acordo de fornecedor → clica **“Deixar um comentário”** acima do parágrafo de indenização.  
2. Digita: `@John_Procurement O limite de responsabilidade está correto em $500k? Isso conflita com nossa política padrão.`  
3. **John (Visualizador)** recebe uma notificação por email → clica no link → vê o parágrafo destacado.  
4. John responde: `Boa observação – deveria ser $1M. Vou editar após a confirmação.`  
5. **Auditor** abre mais tarde o mesmo documento, lê todo o thread, mas não pode publicar.  

Toda a comunicação permanece dentro do Procurize.AI – sem emails perdidos ou threads no Slack.

## Comentários vs. Análise de IA – Como Eles Trabalham Juntos

| Recurso | Propósito |
|---------|-----------|
| **Análise de IA** | Detecta automaticamente inconsistências e sugere correções |
| **Comentários** | Colaboração humana – faça perguntas, proponha mudanças, solicite esclarecimentos |

Você pode deixar um comentário **em um fragmento que tem um alerta de IA** – por exemplo: *“IA diz que isso conflita com a política X – podemos revisar juntos?”*

## Perguntas Frequentes (FAQ)

**P: Posso editar ou excluir meu próprio comentário?**  
R: Sim – mas somente se ninguém respondeu a ele. Assim que um comentário tem alguma resposta, edição e exclusão são desativadas para manter a consistência do thread.

**P: O que acontece com os comentários quando um fragmento é editado?**  
R: O fragmento antigo é marcado como “Excluído”. Se ele tinha comentários, eles permanecem visíveis no painel global de comentários após habilitar **“Mostrar seções excluídas”** (essa opção aparece apenas quando tais fragmentos existem). Você ainda pode visualizar e responder a esses comentários. Fragmentos sem comentários são removidos permanentemente.

**P: Posso responder a um comentário em um fragmento excluído?**  
R: Sim – com “Mostrar seções excluídas” ativado, o botão de resposta continua ativo.

**P: Os threads de comentários sobrevivem a atualizações do documento?**  
R: Comentários em fragmentos não modificados permanecem anexados. Comentários em fragmentos editados mudam para estado “Excluído” (veja acima).

**P: Posso ser notificado de qualquer novo comentário sem ser @mencionado?**  
R: Atualmente, apenas @menções acionam notificações. Use o botão **“Seguir”** para acompanhar um documento.

**P: O que acontece quando um Auditor tenta publicar um comentário?**  
R: O botão “Deixar um comentário” é ocultado/desativado. Auditores têm acesso somente leitura aos comentários.

**P: Comentários também estão disponíveis no módulo de Questionário?**  
R: Sim – o Questionário possui um painel de mensagens separado. Este artigo cobre **apenas documentos da Base de Conhecimento**.

{{<article-feedback>}}

## Artigos relacionados

[Como editar um documento](/how-to-edit-a-document)

[O que é Análise de Documento por IA?](/what-is-ai-document-analysis)

[Como usar a Análise de Documento por IA](/how-to-use-ai-document-analysis)

[Como se comunicar em questionários](/how-to-communicate-within-the-questionnaire)

[Papéis e Permissões](/what-user-permissions-does-procurize-have)