La Revisión de documentos ofrece comentarios estructurados y prácticos sobre tu escritura. En lugar de hacerle preguntas generales al Asistente, la Revisión de documentos analiza tu documento completo y aporta ideas sobre estructura, claridad, completitud y calidad general. Esto te ayuda a detectar problemas antes de compartir, mejorar la calidad del contenido y obtener una perspectiva externa sobre tu trabajo, todo sin salir de 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.
Qué hace la Revisión de documentos
La Revisión de documentos examina tu documento en varias dimensiones: Estructura y organización:- Flujo y progresión lógica
- Jerarquía y coherencia de encabezados
- Equilibrio y ritmo de secciones
- Arquitectura de la información
- Complejidad y longitud de las oraciones
- Uso de jerga y lenguaje técnico
- Transiciones entre ideas
- Puntuación general de legibilidad
- Contexto o antecedentes que faltan
- Lagunas en las explicaciones
- Preguntas sin respuesta
- Áreas que necesitan ampliación
- Coherencia del tono
- Problemas de formato
- Redundancias y repeticiones
- Oportunidades de mejora
Cómo iniciar una Revisión de documentos
El Asistente leerá tu documento completo y proporcionará comentarios estructurados organizados por categoría.
La Revisión de documentos funciona con todos los modelos, pero Max ofrece los comentarios más completos y matizados, especialmente para documentos largos o complejos. Para revisiones rápidas, Fast ofrece un buen equilibrio entre profundidad y velocidad.
Revisión de documentos vs. chat general del Asistente
| Característica | Revisión de documentos | Chat general del Asistente |
|---|---|---|
| Objetivo | Comentarios estructurados sobre el documento | Conversación y tareas abiertas |
| Alcance | Análisis del documento completo | Responde preguntas específicas |
| Formato de salida | Organizado por categorías de comentarios | Respuestas conversacionales |
| Profundidad | Completo y multidimensional | Centrado en tu pregunta específica |
| Ideal para | Revisiones de calidad antes de publicar | Ediciones rápidas, resúmenes, consultas de contenido |
| Seguimiento | Puede hacer preguntas aclaratorias | Conversación continua |
| Uso | Mayor (analiza el documento completo) | Varía según la complejidad de la consulta |
Cuándo usar la Revisión de documentos
La Revisión de documentos es más valiosa en estos escenarios:Antes de compartir externamente
Revisa presentaciones, propuestas o documentos orientados al cliente para detectar problemas estructurales, secciones poco claras o contexto que falta antes de enviarlos.Control de calidad
Realiza revisiones periódicas de documentación importante, wikis de equipo o artículos de base de conocimiento para mantener alta calidad y consistencia a lo largo del tiempo.Mejora del contenido
Obtén sugerencias prácticas para entradas de blog, informes o redacción de formato largo. El Asistente puede identificar áreas que necesitan ampliación, simplificación o reestructuración.Preparación para la colaboración
Antes de compartir con compañeros, asegúrate de que tu documento sea claro, completo y bien organizado. Esto reduce el ir y venir y mejora la eficiencia de la colaboración.Aprendizaje y desarrollo de habilidades
Usa las revisiones para entender patrones en tu escritura: problemas recurrentes de claridad, tendencias estructurales o áreas donde consistentemente necesitas mejorar.Puedes ejecutar la Revisión de documentos varias veces. Realiza cambios basados en los comentarios y vuelve a revisar para comprobar si los problemas se han resuelto. Este enfoque iterativo te ayuda a aprender qué funciona y a refinar tu contenido progresivamente.
Interpretar los comentarios
Los comentarios de la Revisión de documentos están organizados en categorías claras. Así puedes interpretarlos y actuar sobre ellos:Comentarios sobre estructura
Qué te dice: Qué tan bien fluye tu contenido, si las secciones están equilibradas y si la arquitectura de la información tiene sentido. Ejemplo de comentario:- “La introducción es demasiado larga en relación al resto del documento”
- “La sección 3 carece de una transición clara desde la sección 2”
- “La jerarquía de encabezados salta de H2 a H4”
Comentarios sobre claridad
Qué te dice: Si tu redacción es fácil de entender, si las oraciones son demasiado complejas y dónde pueden confundirse los lectores. Ejemplo de comentario:- “Este párrafo usa mucho la voz pasiva, lo que dificulta su seguimiento”
- “La jerga técnica en la primera sección puede confundir a lectores no especializados”
- “La longitud promedio de las oraciones es de 35 palabras: considera dividirlas en oraciones más cortas”
Comentarios sobre completitud
Qué te dice: Lagunas en tu contenido: contexto que falta, preguntas sin respuesta o áreas que necesitan más detalle. Ejemplo de comentario:- “El documento menciona ‘el nuevo proceso’ pero nunca lo define”
- “Los pasos 2 y 3 asumen conocimientos previos no explicados en la introducción”
- “No se incluye conclusión ni próximos pasos”
Comentarios sobre calidad
Qué te dice: Coherencia del tono, problemas de formato y oportunidades para pulir tu contenido. Ejemplo de comentario:- “El tono cambia de formal a informal entre secciones”
- “Los puntos de la lista tienen formato inconsistente (algunos terminan con punto, otros no)”
- “Este concepto se explica dos veces: considera consolidarlo”
Uso
La Revisión de documentos consume más de tu cuota de IA que una pregunta simple, ya que analiza el documento completo en una sola pasada. Los documentos más largos y complejos consumen más. Usa Fast para revisiones más rápidas y ligeras.El uso real depende de la longitud del documento, la estructura, la complejidad del formato y el modelo que elijas. Consulta tu uso en el menú del Asistente en Uso y límites.
Consejos para mejores revisiones
1. Prepara tu documento primero Asegúrate de que tu documento esté razonablemente completo antes de ejecutar una revisión. El Asistente proporciona mejores comentarios sobre borradores terminados que sobre esquemas preliminares. 2. Especifica tu audiencia En un mensaje de seguimiento, dile al Asistente para quién es el documento:- “Esto es para un equipo técnico familiarizado con el producto”
- “La audiencia son stakeholders no técnicos”
- “Escrito para nuevos usuarios que nunca han usado Craft”
- “¿Cuáles son los 3 problemas que debo corregir primero?”
- “¿Cuál es el problema estructural más crítico?”
- “Céntrate solo en los problemas de claridad”
- “Revisa esto en cuanto a coherencia de tono”
- “Comprueba solo la completitud y el contexto que falta”
- “Céntrate en si la estructura tiene sentido para una audiencia principiante”
- On-device: No recomendado para la Revisión de documentos (contexto limitado)
- Core: Revisiones estructurales rápidas en documentos cortos
- Fast: Buen equilibrio para la mayoría de revisiones (500-2000 palabras)
- Max: Mejor para documentos largos y complejos o cuando necesitas los comentarios más completos
Ejemplo: Antes de publicar una entrada de blog
Sara escribe una entrada de blog sobre el uso de Colecciones en Craft. Antes de publicarla, quiere asegurarse de que sea clara y completa.El Asistente analiza el documento y proporciona comentarios:
- Estructura: “La introducción es sólida, pero la sección 2 es el doble de larga que las secciones 3 y 4 juntas. Considera dividirla en dos partes.”
- Claridad: “Varios términos técnicos (relaciones, propiedades, vistas) se usan antes de definirse. Añade un glosario o defínelos en el primer uso.”
- Completitud: “La entrada explica qué son las Colecciones pero no aborda cuándo usarlas en lugar de carpetas o etiquetas.”
- Calidad: “El tono es consistente. Hay una sección redundante al final que repite la introducción: considera eliminarla.”
Sara realiza ajustes basados en los comentarios: divide la sección 2, añade definiciones, incluye una sección “Cuándo usar Colecciones” y elimina la redundancia.
Ejecuta la Revisión de documentos de nuevo. El Asistente confirma que los problemas están resueltos.
Limitaciones
La Revisión de documentos proporciona comentarios pero no aplica cambios directamente. Para actuar sobre las sugerencias, cambia al modo Ejecutar con un modelo Fast o Max y pídele al Asistente que implemente los cambios recomendados. Consulta Editar con Craft Assistant. Para documentos muy cortos (menos de 200 palabras), la Revisión de documentos puede no aportar mucho valor; el chat general del Asistente suele ser más apropiado para tareas rápidas.Artículos relacionados
Usar Craft Assistant
Aprende a trabajar con el Asistente e iniciar conversaciones
Elegir modelos de IA
Selecciona el modelo adecuado para la Revisión de documentos y otras tareas
Editar con Craft Assistant
Aplica las sugerencias de revisión directamente en el modo Ejecutar
Instrucciones personalizadas
Crea instrucciones de revisión reutilizables para comentarios consistentes
Uso y límites
Entiende el uso de IA para la Revisión de documentos y otras funciones