Escribir un documento extenso
Configura los tipos de documento, ejecuta el lienzo de escritura, dirige el breve de una sección, reescribe un pasaje, usa versiones, añade tu propio material, exporta a PDF y traduce una copia.
Para qué sirve
La mayoría de las tareas que realiza un agente caben en una sola respuesta. Esto es para lo que entregas a otra persona: un trámite regulatorio, un informe de entrada al mercado, un memorando de debida diligencia, una respuesta a un pliego de condiciones. El agente planifica el esquema primero, solicita lo que necesite antes de comenzar, investiga cada sección y la redacta por secciones en segundo plano —mientras tú lees y editas el resultado en un lienzo junto al chat.
Si eres nuevo en esta idea, comienza con la página del concepto de escritura de formato largo. Esta página es la guía de uso.
1. Definir un tipo de documento
Un tipo de documento es la definición reutilizable de un tipo de documento que produces. Los creas en la consola bajo Tipos de documento. Cada uno incluye:
| Campo | Qué hace |
|---|---|
| Esquema | El esqueleto: claves de sección, títulos, orden, qué debe cubrir cada una, longitud objetivo y qué hechos obligatorios requiere. Déjalo vacío para que el agente proponga un esquema por documento. |
| Información requerida | El puñado de hechos que solo tiene el cliente —fabricante legal, mercado objetivo, fecha límite. El agente solicita estos datos antes de escribir. |
| Límites | Lo que este documento nunca debe hacer: nunca citar una tasa, nunca predecir un resultado, nunca afirmar una clasificación como definitiva. Adjunto a las instrucciones de cada sección por el sistema. |
| Bases de conocimiento | Cuáles de tus bases de conocimiento puede consultar este tipo. Esto es un permiso, no una sugerencia —se intersecta con lo que el agente mismo tiene permitido. |
| Cuándo usar | Una descripción en lenguaje natural de cuándo aplica este tipo. Se utiliza para reconocer el tipo a partir de lo que escribe un cliente. |
Un tipo es un borrador hasta que lo publicas. Publicar congela una revisión, y un documento que ya está en ejecución se mantiene fijado a la revisión con la que comenzó —por lo que editar un tipo esta tarde nunca renumerará un documento que comenzó esta mañana.
Las claves de sección son identificadores, no prosa. Renombrar una clave rompe los anclajes en los documentos ya escritos a partir de ese tipo. Cambia el título libremente; deja la clave intacta.
2. Iniciar un documento
Tres formas de entrar, todas por la misma línea de producción:
- El menú + → Escribir un documento, luego indica de qué debe tratar.
- Simplemente dilo —"escríbeme un informe completo sobre el registro de este dispositivo en Brasil". Escribirlo es equivalente a seleccionarlo del menú.
- Desde un paso de una historia que produce un entregable.
Si la solicitud carece del tema ("escribe un documento"), el agente pregunta sobre qué —no adivina, porque un documento escrito sobre un tema adivinado es el tipo de adivinanza más costosa.
3. Pregunta antes de comenzar
El agente verifica la información requerida del tipo contra lo que ya sabe —incluyendo cualquier cosa que el cliente haya dicho anteriormente en la conversación— y solicita lo que falta, una cosa a la vez, con una línea que explica por qué lo necesita.
No se genera nada ni se cobra nada hasta que esas respuestas estén presentes. Para visitantes anónimos en un enlace compartido hay un paso extra: una dirección de correo electrónico antes de que comience el trabajo. Esto es tanto el límite de costo como la forma en que recibirán el documento más tarde.
4. Confirmar, luego escribe
Antes de que comience la escritura, ves el recuento exacto de secciones y una estimación de tokens. Esa pausa es deliberada — es el último punto antes de la parte costosa.
Luego se ejecuta el trabajo. Algunas cosas que vale la pena saber:
- Puedes cerrar la pestaña. El trabajo es un proceso en segundo plano, no una solicitud. Vuelve al mismo enlace.
- Un reinicio es soportable. Si el servidor se reinicia a mitad del documento, la sección en curso se reescribe desde el principio y las secciones finalizadas permanecen intactas.
- Puedes detenerlo. Las secciones ya escritas se conservan —fueron pagadas.
- El progreso es por sección: en qué sección está, y en qué dominios leyó para esa sección.
5. De dónde provienen los hechos
Cada sección investiga por su cuenta, en este orden: primero tus bases de conocimiento, luego —solo si las fuentes públicas están habilitadas en ese agente— una búsqueda web donde abre y lee la página en lugar de responder desde el resumen de búsqueda. Cada hecho se almacena junto a la fuente de la que proviene.
La sección se escribe luego solo a partir de esos hechos. Los detalles específicos que aparecen en ninguna fuente son marcados por código que escanea el texto final, no preguntando al modelo si fue cuidadoso.
Un tipo de documento no puede activar fuentes públicas por sí mismo. Si las desactivaste en el agente, esa decisión se mantiene —un tipo solo puede ser más restrictivo que el agente, nunca más amplio.
6. Guiar una sección
Cada sección tiene tres controles, al pasar el cursor, en la propia línea de estado de la sección:
- Breve — las instrucciones que se le dan al modelo para esta sección. Editarlo y elegir guardar y reescribir vuelve a ejecutar solo esa sección. Esta es la forma más rápida de corregir una sección que salió genérica.
- Editar — el texto en sí, en un editor de markdown a pantalla completa. Una edición manual marca la sección como editada, y el escritor nunca sobrescribe una sección editada.
- Historial — cada versión de esta sección (ver abajo).
Para cambiar un pasaje, selecciónalo en el texto y di qué quieres:
Solo ese pasaje se reemplaza; el resto de la sección es idéntica byte a byte. Puedes previsualizar el reemplazo antes de aplicarlo. El mismo camino maneja una reescritura de toda la sección —es una selección de toda la sección.
7. Historial y volver atrás
Abre Historial en cualquier sección. Obtienes cada versión: la que fue escrita inicialmente, tus ediciones manuales, cada reescritura solicitada y cada restauración —con la fecha, la longitud, qué pasaje tocó y, para una reescritura solicitada, lo que pediste con tus propias palabras.
Selecciona una versión para verla comparada línea por línea contra el texto actual, o léela completa. Restaurar esta versión la devuelve —añadiendo una nueva versión. Nada en el historial se elimina nunca.
8. Añadir tu propio material a mitad del documento
Suelta un archivo en el chat mientras un documento está abierto y se convierte en material de apoyo para ese documento: el agente te indica qué secciones afecta y ofrece reescribirlas. El material se gestiona por documento —puedes ver qué está adjunto, por fuente, y eliminar cualquiera de ellos.
9. Exportar y traducir
- PDF con una tabla de contenidos clickeable y números de página. Los gráficos e imágenes están integrados.
- Copias traducidas — una copia de solo lectura del documento en otro idioma. El original permanece intacto, los anclajes de sección se comparten, y una copia se marca como obsoleta cuando la sección fuente cambia después de haber sido traducida. Las ediciones pertenecen a la fuente; una copia traducida es para entregar.
- Compartir — cuando compartes la conversación que produjo un documento, hay una casilla de verificación para si los documentos van con ella. Está desactivada por defecto y el lector obtiene una vista de solo lectura. Ver Compartir una conversación.
Límites que vale la pena saber antes de prometerlo a un cliente
- Un documento está limitado a 40 secciones. Más allá de eso, divídelo.
- Los enlaces de exportación expiran; el documento no. Vuelve a exportar cuando necesites un enlace nuevo.
- La exportación a PDF requiere que el componente de exportación esté instalado en el despliegue. Si el botón no está, esa es la razón —no da error, simplemente no aparece.
- La escritura de formato largo es por agente. Habilítala para los agentes que producen entregables, no para el bot de preguntas frecuentes.