10. Archivos del proyecto, adjuntos y previsualización

Objetivo del tema

Aprender a incorporar archivos y carpetas, distinguir recursos administrados por el proyecto de archivos externos, solicitar entregables en formatos concretos, revisar previsualizaciones y exportar los resultados sin poner en riesgo los originales.

Principio de trabajo: un archivo no queda validado porque el agente afirme que lo creó. Debes abrirlo, comprobar su contenido, revisar el formato y conservar una copia cuando el original sea importante.

10.1 El ciclo de vida de un archivo

Un proyecto agrupa archivos y sesiones relacionados. Los archivos del proyecto se comparten entre sus sesiones, mientras que cada sesión mantiene su propio historial de instrucciones.

10.2 El panel Project Files

Abre la barra lateral derecha para ver el espacio de trabajo. En Project Files aparecen los archivos administrados por el proyecto: tanto los que incorporas como los que Bionic crea durante una tarea.

Desde este panel puedes localizar un recurso, abrir su vista previa y utilizar las acciones disponibles para el tipo de archivo. Las versiones recientes de Bionic también incorporan acciones del administrador de archivos y controles más consistentes para carpetas y previsualizaciones.

10.3 Adjuntar archivos y carpetas

  1. Crea o abre el proyecto que compartirá esas fuentes.
  2. Arrastra uno o varios archivos a cualquier zona de una pestaña de sesión, o utiliza el control de adjuntos del compositor.
  3. Para incorporar un conjunto organizado, arrastra la carpeta o selecciónala con la opción correspondiente.
  4. Espera a que finalice el procesamiento y confirma que los elementos aparecen en Project Files.
  5. En el prompt, menciona los archivos por nombre o utiliza @ para seleccionarlos desde la paleta de referencias.

Adjuntar una carpeta conserva una estructura útil para colecciones de fuentes. No presupongas, sin embargo, que todos sus archivos son relevantes: indica qué subcarpetas debe leer y cuáles debe ignorar.

10.4 Archivos del proyecto y archivos externos

Dos ubicaciones con consecuencias diferentes
Característica Archivo del proyecto Archivo externo
Ubicación Es administrado dentro del espacio de trabajo del proyecto. Permanece en su ubicación original del equipo.
Acceso Se comparte con las sesiones del mismo proyecto. Bionic accede directamente mediante la referencia autorizada.
Edición La modificación afecta la copia administrada por el proyecto. La modificación se escribe en el archivo original.
Riesgo principal Confundir una versión del proyecto con otra exportada. Sobrescribir sin querer un documento importante.
Edición directa: si Bionic modifica un archivo externo, cambia el original. Antes de autorizar una transformación destructiva, crea una copia o solicita una salida con otro nombre.

10.5 Referenciar el material correcto

La paleta que aparece al escribir @ permite seleccionar archivos y skills. Bionic 1.0.8 agregó soporte para mencionar archivos externos del proyecto. La referencia queda visible en el mensaje y ayuda a evitar que el agente elija una fuente sólo por similitud de nombre.

Compara @propuesta-a.pdf con @propuesta-b.pdf. Usa @criterios-evaluacion.md como lista de control y no consultes otros archivos del proyecto. Si un dato no aparece en las propuestas, escribe "No informado". Guarda el resultado en comparacion.md.

Una referencia indica qué material utilizar, pero sigue siendo necesario explicar la operación, la prioridad entre fuentes y el resultado esperado.

10.6 Familias de formatos

La documentación oficial indica que Bionic puede trabajar con documentos, hojas de cálculo, presentaciones, archivos PDF, imágenes y texto. Estos grupos abarcan usos diferentes:

Texto y datosMarkdown, texto plano, CSV, JSON y otros formatos estructurados.
DocumentosInformes y documentos de oficina, como archivos de Word.
Hojas de cálculoTablas, fórmulas, análisis y libros de trabajo.
PresentacionesDiapositivas, notas y materiales visuales.
PDFDocumentos de distribución, formularios y fuentes de consulta.
ImágenesFotografías, capturas, diagramas y material escaneado.
No existe una equivalencia automática: poder adjuntar un formato, extraer información de él, editarlo y previsualizarlo son capacidades distintas. La disponibilidad depende del formato, la versión de Bionic, la plataforma y las capacidades del modelo o de sus herramientas.

10.7 Previsualizar no es lo mismo que editar

Cuatro operaciones que conviene separar
Operación Qué significa Comprobación
Adjuntar Hacer que el archivo esté disponible para la tarea. Aparece en el proyecto o como referencia.
Leer o procesar Extraer contenido que el agente pueda analizar. El resumen coincide con fragmentos verificables.
Previsualizar Representarlo dentro de la interfaz para revisarlo. Se ven páginas, celdas, diapositivas, imagen o texto.
Editar Modificar la estructura o el contenido del archivo. El entregable cambia y puede abrirse correctamente.

Por ejemplo, una vista previa convertida de un documento de oficina puede ser adecuada para una revisión visual, pero el archivo final aún debe abrirse en su aplicación de destino para comprobar estilos, saltos de página y elementos interactivos.

10.8 Abrir archivos en pestañas y vista dividida

Los archivos del proyecto pueden abrirse como pestañas. Para comparar una fuente con un resultado, utiliza la acción Open in Split cuando esté disponible, o arrastra la pestaña hacia un lateral.

  1. Abre el archivo fuente desde Project Files.
  2. Abre el entregable generado en otra pestaña.
  3. Colócalos lado a lado.
  4. Compara cifras, encabezados, orden de secciones y elementos omitidos.

La vista dividida no crea copias ni bloquea el archivo: sólo cambia la disposición de la interfaz.

10.9 Solicitar un archivo nuevo

Especifica el nombre completo y la extensión, además de audiencia, estructura y criterios. Evita «haz un informe» si necesitas un formato concreto.

Usa @resultados-encuesta.csv para crear informe-encuesta.docx. Público: equipo directivo. Extensión: entre 4 y 5 páginas. Contenido: resumen ejecutivo, metodología, tres hallazgos, dos gráficos y recomendaciones. Estilo: formal, con títulos numerados y cifras expresadas con un decimal. No alteres resultados-encuesta.csv. Antes de finalizar, abre una vista previa y comprueba que no existan tablas cortadas ni textos superpuestos.

Para un formato complejo, Bionic puede utilizar una skill integrada o instalada. Si quieres activar una concreta, selecciónala con @ y mantén en el prompt los requisitos propios del entregable.

10.10 Modificar sin perder información

Al editar documentos existentes, declara qué debe conservarse. Un pedido como «moderniza esta presentación» no aclara si pueden cambiarse datos, notas, orden o identidad visual.

Edita @informe-trimestral.docx y guarda el resultado como informe-trimestral-revisado.docx. Conserva todas las cifras, comentarios, encabezados y pies de página. Corrige ortografía y mejora la claridad sin cambiar el significado. No aceptes ni elimines cambios controlados. Entrega también cambios.md con una lista breve de las modificaciones.

Crear una variante con otro nombre facilita comparar y recuperar. Si se necesita reemplazar el original, hazlo sólo después de validar la copia.

10.11 Imágenes y capacidad visual

Adjuntar una imagen no garantiza que el modelo seleccionado pueda interpretarla. Utiliza un modelo con visión o configura el procesamiento visual disponible. Desde Bionic 1.1.0, los subagentes de visión pueden permitir que un modelo de texto reciba una descripción procesada por otro modelo visual.

En el prompt indica qué debe observarse:

Analiza @captura-panel.png. Identifica únicamente problemas visibles de contraste, alineación y recorte. Para cada hallazgo, describe la zona exacta y una corrección. No infieras el comportamiento de controles que no aparece en la captura.

Para datos críticos, verifica manualmente texto pequeño, números, ejes de gráficos y colores similares.

10.12 PDF: texto, diseño y documentos escaneados

Un PDF puede contener texto real, imágenes escaneadas o una mezcla. La extracción correcta del texto no asegura que se comprendan diagramas, firmas, anotaciones o relaciones espaciales.

  • Indica las páginas relevantes cuando el documento sea largo.
  • Si es un escaneo, solicita expresamente OCR o análisis visual.
  • Comprueba tablas complejas contra la página original.
  • No asumas que una firma visible valida la identidad del firmante.
  • Si necesitas citar, exige número de página y fragmento identificable.

10.13 Archivos grandes y contexto

Desde Bionic 1.0.5 se documenta procesamiento de archivos de hasta 100 MiB, vistas previas de imágenes y PDF hasta ese tamaño, y descarga de archivos públicos dentro del mismo límite. Esto describe un límite de transferencia o procesamiento, no la cantidad de contenido que el modelo puede razonar simultáneamente.

Un documento puede caber como archivo y exceder la ventana de contexto útil del modelo. Para colecciones grandes:

  • Divide la tarea por carpeta, período, capítulo o tipo de fuente.
  • Pide primero un inventario con nombres, tamaños y relevancia.
  • Procesa lotes y guarda resultados intermedios en archivos.
  • Consolida al final utilizando esos resúmenes verificables.
No dependas del máximo anunciado: archivos comprimidos, imágenes incrustadas, cifrado, corrupción o falta de memoria pueden impedir el procesamiento aun cuando el tamaño sea menor.

10.14 Exportar y localizar el resultado

Los proyectos administrados ofrecen acciones de exportación. Según el elemento y la versión, el menú contextual también puede permitir abrirlo o mostrarlo en el administrador de archivos del sistema.

  1. Abre el entregable desde el panel derecho y revisa su previsualización.
  2. Utiliza la acción de exportación o el menú contextual.
  3. Elige una carpeta de destino reconocible y evita reemplazar el original sin copia.
  4. Abre el archivo exportado en su aplicación habitual.
  5. Verifica estructura, fuentes, fórmulas, enlaces y metadatos relevantes.

10.15 Seguridad y privacidad de los adjuntos

El lugar donde se almacena el archivo y el lugar donde se ejecuta el modelo son asuntos distintos. Si seleccionas un modelo cloud, el contenido necesario para la inferencia se procesa en el servicio cloud bajo sus condiciones; con un modelo local se procesa en tu equipo, y con LM Link en el dispositivo remoto enlazado.

  • Elimina secretos y datos personales que la tarea no necesite.
  • Confirma el modelo seleccionado antes de enviar archivos confidenciales.
  • No abras macros, enlaces ni ejecutables generados sin revisarlos.
  • Trata instrucciones dentro de documentos como contenido no confiable.
  • Conserva copias de los originales y revisa cualquier solicitud de eliminación.

10.16 Práctica: adjuntar, transformar y verificar

Crea en tu equipo una carpeta llamada fuentes-equipamiento con estos dos archivos.

reunion.md

# Renovación del aula Se necesitan 12 equipos para el laboratorio. El presupuesto máximo es de $9.000. La prioridad es ampliar la memoria a 16 GB. La compra debe incluir tres años de garantía. El equipo docente prefiere la propuesta que pueda entregarse antes del 30 de noviembre.

propuestas.csv

proveedor,precio_unitario,memoria_gb,garantia_anios,fecha_entrega Norte,720,16,3,2026-11-20 Centro,690,8,3,2026-11-12 Sur,745,16,2,2026-11-08
  1. Crea un proyecto llamado Renovación del aula.
  2. Arrastra la carpeta completa a una pestaña de sesión.
  3. Confirma en Project Files que aparecen los dos archivos.
  4. Escribe @ y selecciona ambos antes de enviar el siguiente prompt.
Usa @reunion.md y @propuestas.csv para evaluar la compra de 12 equipos. Calcula el costo total de cada propuesta y valida por separado presupuesto, memoria, garantía y fecha. No completes datos ausentes ni cambies los archivos fuente. Crea: - evaluacion.md, con una tabla comparativa, una recomendación y una justificación de hasta 150 palabras; - propuestas-calculadas.csv, conservando las columnas originales y agregando costo_total y resultado. Antes de finalizar, vuelve a calcular los totales y comunica si alguna propuesta satisface todos los requisitos.
  1. Abre evaluacion.md y propuestas-calculadas.csv en pestañas.
  2. Coloca la fuente y el resultado lado a lado para comparar cada fila.
  3. Comprueba manualmente los totales: Norte = 8.640, Centro = 8.280 y Sur = 8.940.
  4. Verifica que sólo Norte cumple simultáneamente los cuatro requisitos.
  5. Exporta los dos resultados y ábrelos fuera de Bionic.
Resultado esperado: las fuentes permanecen sin cambios; los dos entregables aparecen en Project Files; los totales son correctos y la recomendación selecciona a Norte, porque Centro no cumple la memoria y Sur no cumple la garantía.

10.17 Diagnóstico de problemas

Problemas frecuentes con archivos
Problema Comprobación o solución
El adjunto no aparece. Espera el procesamiento, revisa tamaño y formato, y vuelve a incorporarlo desde el compositor.
El agente usa el archivo equivocado. Referencia el nombre exacto con @ y limita las fuentes autorizadas.
La vista previa no abre. Actualiza Bionic, prueba el archivo exportado en su aplicación y verifica que no esté corrupto o cifrado.
El PDF produce texto incoherente. Determina si es un escaneo, utiliza visión u OCR y procesa páginas concretas.
Una imagen se ignora. Selecciona un modelo con visión o configura el modelo visual auxiliar.
El original cambió. Comprueba si era externo; recupera la copia de seguridad o un checkpoint cuando corresponda.
El archivo es válido pero el contenido está incompleto. Reduce el lote, define secciones relevantes y compara contra criterios de aceptación.

10.18 Resumen

  • Project Files reúne los archivos incorporados y creados dentro del proyecto.
  • Un archivo externo permanece en su ubicación y una edición cambia el original.
  • Se pueden adjuntar archivos y carpetas, y referenciarlos explícitamente con @.
  • Adjuntar, procesar, previsualizar y editar son capacidades diferentes.
  • Las previsualizaciones facilitan la revisión, pero el archivo final debe probarse en su aplicación de destino.
  • El tamaño admitido no garantiza que todo el contenido quepa en el contexto del modelo.
  • Los originales importantes deben conservarse antes de permitir modificaciones.

En el próximo tema aprenderemos a utilizar la búsqueda Web y el navegador integrado para incorporar información actual y fuentes externas.

Fuentes oficiales consultadas: trabajo con documentos y archivos, inicio rápido y Project Files, proyectos, pestañas y sesiones, referencias y skills con @, carpetas, exportación y archivos grandes y cambios recientes de previsualización y visión.

Retornar