> ## Documentation Index > Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Revisão de Documento > Receba feedback orientado por IA sobre estrutura, clareza e completude do seu documento. A Revisão de Documento oferece feedback estruturado e prático sobre sua escrita. Em vez de fazer perguntas gerais ao Assistant, a Revisão de Documento analisa seu documento inteiro e traz insights sobre estrutura, clareza, completude e qualidade geral. Isso ajuda a identificar problemas antes de compartilhar, melhorar a qualidade do conteúdo e obter uma perspectiva externa sobre seu trabalho – tudo sem sair do Craft. ## O que a Revisão de Documento faz A Revisão de Documento examina seu documento em várias dimensões: **Estrutura e organização:** * Fluxo lógico e progressão * Hierarquia e consistência dos títulos * Equilíbrio e ritmo das seções * Arquitetura da informação **Clareza e legibilidade:** * Complexidade e extensão das frases * Uso de jargão e linguagem técnica * Transições entre ideias * Pontuação geral de legibilidade **Completude:** * Contexto ou histórico ausente * Lacunas nas explicações * Perguntas sem resposta * Áreas que precisam de expansão **Indicadores de qualidade:** * Consistência de tom * Problemas de formatação * Redundância e repetição * Oportunidades de melhoria A revisão é objetiva, específica e prática – você recebe sugestões concretas, não feedback vago. ## Como ativar a Revisão de Documento Abra o documento que deseja revisar. Clique no ícone do Assistant no canto inferior. Selecione **Novo Chat**. Escolha **Revisão de Documento** no seletor de modo. Aguarde a análise ser concluída (geralmente de 10 a 30 segundos). O Assistant lerá seu documento inteiro e fornecerá feedback estruturado organizado por categoria. A Revisão de Documento funciona com todos os modelos, mas o **Max** oferece o feedback mais completo e detalhado, especialmente para documentos mais longos ou complexos. Para verificações rápidas, o **Fast** oferece um bom equilíbrio entre profundidade e velocidade. ## Revisão de Documento vs. chat geral com o Assistant | Recurso | Revisão de Documento | Chat Geral com o Assistant | | ------------------------------- | -------------------------------------------------- | ----------------------------------------------- | | **Finalidade** | Feedback estruturado do documento | Conversa aberta e tarefas | | **Escopo** | Análise do documento inteiro | Responde a perguntas específicas | | **Formato de saída** | Organizado por categorias de feedback | Respostas conversacionais | | **Profundidade** | Completa, multidimensional | Focada na sua pergunta específica | | **Melhor para** | Verificações de qualidade, revisões pré-publicação | Edições rápidas, resumos, consultas de conteúdo | | **Perguntas de acompanhamento** | Pode fazer perguntas de esclarecimento | Conversa contínua | | **Uso** | Maior (analisa o documento completo) | Varia conforme a complexidade | Use a **Revisão de Documento** quando quiser feedback abrangente sobre o documento inteiro. Use o **chat geral** quando tiver perguntas ou tarefas específicas. ## Quando usar a Revisão de Documento A Revisão de Documento é mais valiosa nestes cenários: ### Antes de compartilhar externamente Revise apresentações, propostas ou documentos voltados ao cliente para identificar problemas estruturais, seções pouco claras ou contexto ausente antes de enviá-los. ### Garantia de qualidade Execute revisões periódicas em documentações importantes, wikis de equipe ou artigos da base de conhecimento para manter alta qualidade e consistência ao longo do tempo. ### Melhoria de conteúdo Obtenha sugestões práticas para posts de blog, relatórios ou textos longos. O Assistant pode identificar áreas que precisam de expansão, simplificação ou reestruturação. ### Preparação para colaboração Antes de compartilhar com colegas de equipe, garanta que seu documento esteja claro, completo e bem organizado. Isso reduz idas e vindas e melhora a eficiência da colaboração. ### Aprendizado e desenvolvimento Use as revisões para entender padrões na sua escrita – problemas recorrentes de clareza, tendências estruturais ou áreas em que você consistentemente precisa melhorar. Você pode executar a Revisão de Documento várias vezes. Faça alterações com base no feedback e revise novamente para ver se os problemas foram resolvidos. Essa abordagem iterativa ajuda a aprender o que funciona e a refinar seu conteúdo progressivamente. ## Entendendo o feedback O feedback da Revisão de Documento é organizado em categorias claras. Veja como interpretá-lo e agir sobre ele: ### Feedback de estrutura **O que ele indica:** Quão bem seu conteúdo flui, se as seções estão equilibradas e se a arquitetura da informação faz sentido. **Exemplos de feedback:** * "A introdução é muito longa em relação ao restante do documento" * "A Seção 3 não tem uma transição clara a partir da Seção 2" * "A hierarquia de títulos pula do H2 para o H4" **Como usar:** Reorganize seções, ajuste o ritmo, corrija os níveis de título ou adicione conteúdo de transição. ### Feedback de clareza **O que ele indica:** Se o seu texto é fácil de entender, se as frases são muito complexas e onde os leitores podem se confundir. **Exemplos de feedback:** * "Este parágrafo usa muito a voz passiva, dificultando a leitura" * "O jargão técnico na primeira seção pode confundir leitores não especializados" * "O comprimento médio das frases é de 35 palavras – considere dividi-las em frases mais curtas" **Como usar:** Simplifique as frases, substitua jargões por linguagem simples ou adicione definições para termos técnicos. ### Feedback de completude **O que ele indica:** Lacunas no seu conteúdo – contexto ausente, perguntas sem resposta ou áreas que precisam de mais detalhes. **Exemplos de feedback:** * "O documento menciona 'o novo processo' mas nunca o define" * "Os passos 2 e 3 pressupõem conhecimento prévio não abordado na introdução" * "Nenhuma conclusão ou próximos passos fornecidos" **Como usar:** Adicione histórico ausente, expanda seções mais rasas ou inclua resumos e conclusões. ### Feedback de qualidade **O que ele indica:** Consistência de tom, problemas de formatação e oportunidades de polir seu conteúdo. **Exemplos de feedback:** * "O tom muda de formal para informal entre as seções" * "Os pontos de lista têm formatação inconsistente (alguns terminam com ponto, outros não)" * "Este conceito é explicado duas vezes – considere consolidar" **Como usar:** Padronize a formatação, mantenha um tom consistente, remova redundâncias. ## Uso A Revisão de Documento usa mais da sua cota de IA do que uma pergunta simples porque analisa o documento inteiro de uma só vez. Documentos mais longos e complexos consomem mais. Use o **Fast** para revisões mais rápidas e leves. O uso real depende do tamanho do documento, estrutura, complexidade da formatação e do modelo escolhido. Verifique seu uso no menu do Assistant em **Uso e Limites**. O feedback abrangente frequentemente economiza tempo e melhora a qualidade de forma mais eficiente do que várias consultas individuais. ## Dicas para melhores revisões **1. Prepare seu documento antes** Certifique-se de que seu documento esteja razoavelmente completo antes de executar uma revisão. O Assistant fornece feedback melhor em rascunhos acabados do que em esboços preliminares. **2. Especifique seu público** Em um prompt de acompanhamento, diga ao Assistant para quem é o documento: * "Isso é para uma equipe técnica familiarizada com o produto" * "O público são stakeholders não técnicos" * "Escrito para novos usuários que nunca usaram o Craft" Esse contexto ajuda o Assistant a personalizar o feedback para suas necessidades específicas. **3. Peça feedback priorizado** Se a revisão identificar muitos problemas, peça ao Assistant para priorizá-los: * "Quais 3 problemas devo corrigir primeiro?" * "Qual é o problema estrutural mais crítico?" * "Foque apenas nos problemas de clareza" **4. Solicite tipos específicos de feedback** Você pode guiar a revisão pedindo análises focadas: * "Revise para consistência de tom" * "Verifique apenas completude e contexto ausente" * "Foque em se a estrutura faz sentido para um público iniciante" **5. Use o modelo certo** * **On-device:** Não recomendado para Revisão de Documento (contexto limitado) * **Core:** Verificações estruturais rápidas em documentos curtos * **Fast:** Bom equilíbrio para a maioria das revisões (500–2.000 palavras) * **Max:** Melhor para documentos longos e complexos ou quando você precisa do feedback mais completo ## Exemplo: Antes de publicar um post de blog Sarah escreve um post de blog sobre o uso de Coleções no Craft. Antes de publicar, ela quer garantir que está claro e completo. Sarah abre seu rascunho do post de blog no Craft. Ela clica no ícone do Assistant e seleciona **Revisão de Documento**. O Assistant analisa o documento e fornece feedback: * **Estrutura:** "A introdução é forte, mas a Seção 2 é duas vezes mais longa que as Seções 3 e 4 juntas. Considere dividi-la em duas partes." * **Clareza:** "Vários termos técnicos (relações, propriedades, visualizações) são usados antes de serem definidos. Adicione um glossário ou defina na primeira ocorrência." * **Completude:** "O post explica *o que* são as Coleções, mas não aborda *quando* usá-las vs. pastas ou tags." * **Qualidade:** "O tom é consistente. Uma seção redundante no final reafirma a introdução – considere remover." Sarah faz ajustes com base no feedback: divide a Seção 2, adiciona definições, inclui uma seção "Quando usar Coleções" e remove redundâncias. Ela executa a Revisão de Documento novamente. O Assistant confirma que os problemas foram resolvidos. Sarah publica com confiança, sabendo que o conteúdo está claro e completo. ## Limitações A Revisão de Documento fornece feedback, mas não aplica alterações diretamente. Para agir sobre as sugestões, mude para o modo **Execute** com um modelo **Fast** ou **Max** e peça ao Assistant para implementar as alterações recomendadas. Consulte [Editando com o Craft Assistant](/pt-BR/ai-assistant/editing). Para documentos muito curtos (menos de 200 palavras), a Revisão de Documento pode não oferecer muito valor – o chat geral com o Assistant costuma ser mais adequado para tarefas rápidas. ## Artigos Relacionados Aprenda a trabalhar com o Assistant e iniciar conversas Selecione o modelo certo para revisões e outras tarefas Aplique sugestões de revisão diretamente no modo Execute Crie instruções de revisão reutilizáveis para feedback consistente Entenda o uso de IA para Revisão de Documento e outros recursos