Pular para o conteúdo principal

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.

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

1
Abra o documento que deseja revisar.
2
Clique no ícone do Assistant no canto inferior.
3
Selecione Novo Chat.
4
Escolha Revisão de Documento no seletor de modo.
5
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

RecursoRevisão de DocumentoChat Geral com o Assistant
FinalidadeFeedback estruturado do documentoConversa aberta e tarefas
EscopoAnálise do documento inteiroResponde a perguntas específicas
Formato de saídaOrganizado por categorias de feedbackRespostas conversacionais
ProfundidadeCompleta, multidimensionalFocada na sua pergunta específica
Melhor paraVerificações de qualidade, revisões pré-publicaçãoEdições rápidas, resumos, consultas de conteúdo
Perguntas de acompanhamentoPode fazer perguntas de esclarecimentoConversa contínua
UsoMaior (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.
1
Sarah abre seu rascunho do post de blog no Craft.
2
Ela clica no ícone do Assistant e seleciona Revisão de Documento.
3
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.”
4
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.
5
Ela executa a Revisão de Documento novamente. O Assistant confirma que os problemas foram resolvidos.
6
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. 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