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.Documentation Index
Fetch the complete documentation index at: https://craft-support.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
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
- Complexidade e extensão das frases
- Uso de jargão e linguagem técnica
- Transições entre ideias
- Pontuação geral de legibilidade
- Contexto ou histórico ausente
- Lacunas nas explicações
- Perguntas sem resposta
- Áreas que precisam de expansão
- Consistência de tom
- Problemas de formatação
- Redundância e repetição
- Oportunidades de melhoria
Como ativar a Revisão de Documento
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 |
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”
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”
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”
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”
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.
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”
- “Quais 3 problemas devo corrigir primeiro?”
- “Qual é o problema estrutural mais crítico?”
- “Foque apenas nos problemas de clareza”
- “Revise para consistência de tom”
- “Verifique apenas completude e contexto ausente”
- “Foque em se a estrutura faz sentido para um público iniciante”
- 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.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.
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. 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
Usando o Craft Assistant
Aprenda a trabalhar com o Assistant e iniciar conversas
Escolhendo Modelos de IA
Selecione o modelo certo para revisões e outras tarefas
Editando com o Craft Assistant
Aplique sugestões de revisão diretamente no modo Execute
Prompts Personalizados
Crie instruções de revisão reutilizáveis para feedback consistente
Uso e Limites
Entenda o uso de IA para Revisão de Documento e outros recursos