Archivos
Una tarea puede llevar archivos: una factura que quieres que se revise, la exportación que devuelve un conector, el informe que el agente prepara para ti. Sea cual sea su origen, los archivos de una tarea se guardan juntos: aparecen en el panel lateral de la tarea, se abren en el mismo visor, se pueden descargar, se pueden compartir por enlace y se copian a la computadora del agente para que pueda trabajar con ellos.
A un agente también se le pueden dar archivos de conocimiento — listas de precios, procedimientos, contratos — que consulta en cada tarea. Esos pertenecen al agente y no a una tarea concreta; consulta Archivos de conocimiento.
De dónde vienen los archivos de una tarea
Sección titulada «De dónde vienen los archivos de una tarea»| Origen | Cómo llega | Tamaño máximo | Se guarda durante |
|---|---|---|---|
| Lo adjuntas tú | Desde el cuadro de mensajes, al enviar un mensaje | 50 MB | 2 días; 8 horas para un archivo de más de 10 MB |
| Lo devuelve un conector | Un archivo en la respuesta del conector, o una respuesta demasiado grande para entregársela entera al agente, incluida la respuesta larga de una llamada al sitio | 50 MB | 1 hora |
| Lo crea el agente | Se guarda como resultado de su trabajo en su computadora | 50 MB | 10 días |
Cada espacio de trabajo puede guardar hasta 10 GB de archivos que todavía no han vencido. Si se supera, un archivo nuevo se rechaza con el mensaje este espacio de trabajo agotó su espacio de almacenamiento de archivos hasta que venzan los más antiguos.
Adjuntar archivos
Sección titulada «Adjuntar archivos»Adjunta archivos a cualquier mensaje — en Nueva tarea o en una tarea que ya está en curso — con Adjuntar un archivo, o arrastrándolos a la página (Suelta archivos para adjuntarlos).
- Hasta 50 archivos por mensaje, de 50 MB cada uno. Puedes adjuntar cualquier tipo de archivo. Un archivo de más de 10 MB se guarda solo 8 horas después de subirlo, y el cuadro de mensajes lo avisa antes de enviarlo.
- Puedes marcar las imágenes antes de enviarlas. Abre la imagen y elige Anotar: dibuja a mano alzada, líneas, rectángulos y elipses, o agrega texto, en rojo, azul, verde o gris. Guardar imagen anotada reemplaza la imagen por una copia PNG con tus marcas. Un archivo ya enviado no se puede anotar.
- El agente ve de inmediato las imágenes adjuntas. Una imagen PNG, JPEG, GIF o WebP de hasta 5 MB le llega al agente dentro de tu mensaje — hasta tres por mensaje —, así que puede responder “¿qué dice esta captura de pantalla?” sin abrir nada.
- Cada archivo se coloca también en la computadora del agente, en la
carpeta de archivos de la tarea,
/tmp/<task id>/files/, y se le dice al agente su nombre. Dos archivos con el mismo nombre en una tarea se mantienen separados: el segundoinvoices.csvpasa a serinvoices-2.csv.
Un archivo enviado a mitad de una tarea aparece marcado como Enviado durante la tarea en el panel lateral.
Archivos que devuelve un conector
Sección titulada «Archivos que devuelve un conector»Algunos conectores responden con un archivo — por ejemplo, una exportación en hoja de cálculo o CSV. El archivo se guarda con la tarea y el agente recibe su ruta, su tipo y tamaño, y una vista previa de su contenido. Una exportación grande puede llegar en varias partes.
Si un archivo de una respuesta no se puede guardar, el resto de la respuesta le llega igual al agente, con una nota que indica qué archivo no se guardó y por qué.
Una respuesta demasiado grande para entregársela entera al agente — unos 20 KB
o más — se guarda del mismo modo, como archivo .json (o .csv o .txt cuando
la respuesta es texto plano), y el agente recibe en su lugar una vista previa y
la ruta. Luego lee lo que necesita del archivo en su computadora, en lugar de
arrastrar la respuesta completa por la conversación. La respuesta larga de una
llamada al sitio se guarda del
mismo modo y sigue todas las reglas de abajo.
Los datos de un conector nunca se cortan por la mitad. Con qué puedes contar:
- Un resultado se conserva entero o no se conserva. Un resultado grande nunca se recorta a su primera parte. Si no se pudo guardar como archivo, el agente no recibe ninguna de sus filas — solo una nota que dice que no se pudo guardar — y se le indica que pida menos (un filtro, una página más pequeña, un rango de fechas más corto) o que diga que no se pudieron leer los datos. No rellena el hueco.
- Una lista también es un archivo. Una respuesta con diez filas o más se guarda además como archivo de datos, para que el agente pueda calcular sobre todas las filas con código. Lee las filas de ese archivo; no vuelve a teclear cifras en un script ni las suma de cabeza. El archivo indica cuándo se obtuvieron los datos, porque se quedan desactualizados.
- Un archivo que se retiró de la computadora vuelve. Los archivos que devolvió un conector pueden retirarse de la computadora del agente unos minutos después de llegar; cuando el código del agente necesita uno de nuevo, se vuelve a colocar. Un archivo que ya superó su plazo de conservación no vuelve: al agente se le dice cuándo se obtuvo y le pide los datos otra vez al conector.
- Las descargas lentas se esperan. Cuando el agente descarga un archivo de
un sitio web — una exportación, un PDF — espera a que la descarga termine
(hasta 30 segundos) y guarda el resultado en la carpeta
downloadsde la tarea, en lugar de trabajar con un archivo a medio escribir o con lo que muestra la página.
Si una parte de un resultado aun así no llegó al agente, la transcripción lo dice y se impide que el agente envíe nada construido sobre ella; consulta Cuando los datos de un conector llegan incompletos.
Archivos que crea el agente
Sección titulada «Archivos que crea el agente»Un agente puede trabajar con archivos mediante código, en su computadora: leer una hoja de cálculo, sumar una columna, extraer el texto de un PDF, comparar dos listas, dibujar un gráfico, generar un informe. En la transcripción aparece como Trabajando con los archivos de la computadora.
Todo lo que el agente guarda como resultado se conserva para ti: se muestra en la conversación debajo de la respuesta del agente y en el panel lateral. Los documentos comunes conservan su tipo real, así que un archivo PDF, Word, Excel, PowerPoint o CSV se abre como tal; una imagen que dibuje, el agente también la puede ver. También puede conservar a propósito cualquier otro archivo de la carpeta de archivos de la tarea, lo que aparece como Guardando un archivo para ti. Cada archivo conservado puede tener hasta 50 MB.
El agente también puede compartir por enlace uno de los archivos de la tarea cuando se lo pides.
El límite de seguridad Puede analizar archivos de la configuración del agente controla esto, y está activado en un agente nuevo. Si está desactivado, el agente no puede trabajar con archivos mediante código en absoluto.
Si pregunta antes o no depende de un nivel de aprobación. En Preguntar por todo, la primera vez en una tarea el agente pregunta: El agente quiere leer y analizar los archivos de la computadora de esta tarea. Si lo apruebas, podrá hacerlo durante el resto de esta tarea sin volver a preguntar. Desde Archivos sin preguntar, no pregunta.
Trabajar con archivos requiere la computadora del agente, así que una tarea sin agente no puede hacerlo.
En su computadora, el agente también puede poner un archivo de la tarea en el campo de carga de un sitio web — lo que aparece como Subiendo un archivo —, por ejemplo para adjuntar una factura a un formulario en uno de tus sistemas.
Dónde se guardan los archivos
Sección titulada «Dónde se guardan los archivos»Un archivo de una tarea tiene dos copias.
- La copia almacenada se guarda en el almacenamiento de archivos de AptiveAI durante el tiempo indicado en la tabla de arriba: 2 días para un archivo que adjuntaste (8 horas si pesa más de 10 MB), una hora para uno que devolvió un conector o una llamada al sitio, 10 días para uno que creó el agente. Esta es la copia que ves, descargas y compartes. Cada archivo de Documentos indica cuándo se elimina —El archivo caduca en 9 d, El archivo caduca en 5 h—, y el cuadro para compartir también. Cuando vence, el archivo sigue en la lista pero indica La descarga expiró, y ya no se puede abrir.
- La copia en la computadora es con la que trabaja el agente. Los archivos se copian ahí cuando la tarea tiene una computadora. Una tarea nunca inicia una computadora solo para guardar un archivo: hasta que tenga una, sus archivos esperan, y se copian cuando la consigue — y de nuevo si pasa a otra computadora. Esta copia dura solo lo que dure la computadora.
Descarga tus resultados antes de que venzan si necesitas conservarlos.
Ver los archivos de una tarea
Sección titulada «Ver los archivos de una tarea»-
En la transcripción. Los archivos que adjuntaste aparecen debajo de tu mensaje; los que creó el agente, debajo de su respuesta. Haz clic en uno para abrirlo. Una página web que creó el agente también puede mostrarse en la propia conversación, como una tarjeta debajo de su respuesta.
-
En el panel lateral. La pestaña Documentos muestra Archivos: todos los archivos de la tarea, sea cual sea su origen. Cada uno muestra una vista previa o un icono de tipo, su nombre, Haz clic para ver o Haz clic para descargar con El archivo caduca en …, su tamaño, cuándo llegó y cuándo expira su descarga. Al hacer clic en la fila se abre el archivo; el botón del ojo lo muestra junto a la transcripción. Su menú ⋯ tiene Descargar, Compartir enlace… y, mientras el archivo tiene un enlace activo, Copiar enlace para compartir y Desactivar enlace para compartir; después, las versiones anteriores del archivo y Eliminar, cuando corresponden. Un archivo con un enlace activo lleva la etiqueta Compartido · 71 h: las horas que le quedan a su enlace.
Los archivos se agrupan en Subidos, Generados y Artefactos del agente: lo que trajeron los conectores y las llamadas al sitio, que se elimina de la computadora del agente unos minutos después de llegar y cuyas descargas expiran después de una hora.
-
En la página Archivos del agente. Todos los archivos de las tareas de un agente que puedes ver, de todas sus tareas; consulta El panel del agente y sus archivos.
El visor
Sección titulada «El visor»Al hacer clic en un archivo, se abre en el visor. ◀ y ▶ (o las teclas de flecha) pasan de un archivo a otro del mismo mensaje o lista, Esc lo cierra, y siempre hay un botón de descarga. En una tarea, la cabecera del visor también tiene Compartir enlace… (Compartir un archivo por enlace) y Presentar (Presentar un archivo).
| Archivo | Se muestra como |
|---|---|
| Imágenes — PNG, JPEG, GIF, WebP, BMP | La imagen, con Acercar, Alejar y Restablecer zoom |
| El lector de PDF de tu propio navegador — páginas, zoom, búsqueda e impresión. Abrir en una pestaña nueva lo muestra a tamaño completo, que es la mejor opción en un teléfono | |
Hojas de cálculo — Excel (.xlsx, .xlsm, .xls), OpenDocument (.ods), CSV y TSV | Una tabla con columnas con letras y filas numeradas, una pestaña por hoja. Se muestran hasta 5,000 filas, 200 columnas y 50 hojas |
Word (.docx) | El documento |
PowerPoint (.pptx) | Las diapositivas — Vista previa — el diseño puede diferir de PowerPoint. |
| Markdown | Texto con formato |
Texto y datos — .txt, .log, JSON, XML, YAML | Una vista de texto de solo lectura, con resaltado para JSON, XML y YAML. Se muestran los primeros 500,000 caracteres |
Páginas web — .html | La página, en un entorno aislado: sus propios scripts se ejecutan, pero no puede llegar a internet, a tu cuenta ni a nada más de la tarea, y no puede descargar archivos |
| Cualquier otro | Su nombre y tamaño, con Descargar |
Cuando una parte de un archivo no se muestra, el visor lo indica; la descarga siempre es el archivo completo.
Presentar un archivo
Sección titulada «Presentar un archivo»Presentar, en la cabecera del visor, muestra el archivo a pantalla completa, para una reunión o para compartir pantalla.
- Un archivo de PowerPoint se convierte en una presentación, una diapositiva a la vez sobre una pantalla oscura. Las flechas o la barra espaciadora pasan de una diapositiva a otra (Flechas o Espacio para avanzar, Esc para salir), y Salir o Esc la terminan.
- Cualquier otro archivo llena la pantalla en el mismo visor: desplázalo, amplíalo o úsalo como en el visor. Esc termina la presentación.
La página compartida tiene el mismo botón Presentar en una computadora, con Salir de la presentación para salir.
Compartir un archivo por enlace
Sección titulada «Compartir un archivo por enlace»Puedes compartir un archivo de una tarea con alguien que no tiene cuenta en AptiveAI —un informe para un cliente, una presentación para una reunión— con un enlace privado. El enlace abre ese archivo y nada más, durante poco tiempo.
Quién puede compartir
Sección titulada «Quién puede compartir»Cualquiera que pueda trabajar en la tarea puede compartir sus archivos: crear un enlace, volver a copiarlo y desactivarlo. Quien solo puede ver la tarea, en solo lectura, no puede. Se puede compartir cualquier archivo de la tarea, lo hayas adjuntado tú, lo haya devuelto un conector o lo haya creado el agente.
Crear un enlace
Sección titulada «Crear un enlace»Comparte desde cualquiera de estos lugares:
- el menú ⋯ del archivo en la pestaña Documentos de la tarea → Compartir enlace…;
- Compartir enlace… en la cabecera del visor, con el archivo abierto;
- el botón para compartir de una página web que el agente muestra en la conversación;
- el ⋯ del archivo en la página Archivos del agente o en su panel.
El cuadro, Compartir “‹nombre del archivo›”, dice Solo se comparte este archivo. Nada más de la tarea. Elige durante cuánto tiempo funciona el enlace —24 horas, 48 horas o 72 horas (la opción predeterminada)—, lee Antes de compartir y selecciona Crear enlace:
Cualquiera que tenga este enlace, incluidas las personas a quienes se lo reenvíen, puede ver y descargar este archivo hasta que venza. Los archivos que crean los agentes pueden incluir nombres, cifras y otros datos del trabajo del que provienen. Revisa el archivo antes y no compartas nada que no enviarías por correo.
El aviso aparece cada vez que se crea un enlace. Después, el cuadro muestra el enlace con Copiar enlace, cuándo vence, Crear un enlace nuevo y Desactivar enlace.
Vista inmersiva, un interruptor en el mismo cuadro, es para un panel o un informe que deba verse como una página propia. Se define por enlace y puedes cambiarla en cualquier momento: el enlace sigue siendo el mismo. Consulta Lo que ve quien tiene el enlace.
- Un enlace activo por archivo. Crear un enlace nuevo desactiva el anterior, así que también es la forma de reemplazar un enlace que llegó a la persona equivocada.
- Un archivo compartido se nota. En Documentos y en la página Archivos del agente, el archivo lleva la etiqueta Compartido · N h, y su ⋯ agrega Copiar enlace para compartir y Desactivar enlace para compartir.
- Si el cuadro dice Este enlace está activo, pero su dirección no se puede mostrar de nuevo, selecciona Crear un enlace nuevo para obtener uno que puedas copiar.
Lo que ve quien tiene el enlace
Sección titulada «Lo que ve quien tiene el enlace»El enlace abre una página sin iniciar sesión. Muestra solo ese archivo, en el mismo visor que la consola. Nada más llega a ella: ni la tarea, ni su conversación, ni el agente, ni tu espacio de trabajo, ni sus otros archivos, ni quién lo compartió.
- La barra de abajo tiene el nombre del archivo, el tiempo que le queda al enlace (Vence en 71 h), Buscar cuando el archivo tiene texto, Descargar y, en una computadora, Presentar. Quien tenga el enlace puede descargar el archivo.
- Una página web se ejecuta en el mismo entorno aislado que en la consola.
- Una pequeña marca “Con la tecnología de AptiveAI Agents” aparece en la esquina y abre aptiveai.io.
- Los buscadores no la indexan.
Vista inmersiva
Sección titulada «Vista inmersiva»Con la Vista inmersiva activada, la página muestra solo el archivo, a pantalla completa, con la marca de AptiveAI en la esquina y, en una computadora, un pequeño botón redondo de pantalla completa. Quienes abran el enlace no verán su nombre, cuándo vence ni los botones Buscar, Descargar y Presentar.
El enlace en sí funciona igual: vence, se puede desactivar y cualquiera que lo tenga puede llegar al archivo.
En un teléfono o una tableta
Sección titulada «En un teléfono o una tableta»En un iPhone, un iPad o un dispositivo Android no hay Presentar ni botón de pantalla completa, porque ahí una página no puede ponerse realmente a pantalla completa. El resto de la página es igual.
Cuándo deja de funcionar un enlace
Sección titulada «Cuándo deja de funcionar un enlace»Un enlace deja de funcionar, y la página indica entonces Este enlace ya no está disponible, cuando:
- se acaba su tiempo;
- alguien lo desactiva — Desactivar enlace para compartir en el ⋯ del archivo, o Desactivar enlace en el cuadro;
- se crea un enlace nuevo para el mismo archivo;
- el archivo se elimina, o llega al final del tiempo que se guarda;
- se elimina la tarea.
Un enlace nunca dura más que su archivo. Si el archivo se elimina antes de que pasen las 24, 48 o 72 horas del enlace, el enlace deja de funcionar con él, y el cuadro lo indica: El archivo se conserva hasta el ‹fecha›. Un enlace no puede durar más. Así, el archivo de un conector (que se guarda una hora) o una subida grande (que se guarda 8 horas) solo se pueden compartir durante ese tiempo. Una página que alguien ya tiene abierta conserva lo que ya cargó, pero nada más.
Cuando el agente comparte un archivo
Sección titulada «Cuando el agente comparte un archivo»Puedes pedirle al agente que comparta uno de los archivos de la tarea —«comparte report.pdf conmigo como enlace»—. Crea el mismo enlace que crearías tú, durante 24 horas salvo que pidas 48 o 72, y la transcripción muestra Compartió un archivo: report.pdf. El enlace es tuyo: aparece en el archivo en Documentos, donde puedes copiarlo o desactivarlo.
Con el conector AptiveAI Messaging, el agente también puede enviar el enlace por correo a alguien —«comparte el informe y envía el enlace por correo a nuestro contador»—. Enviar el correo pregunta antes, como cualquier envío de Messaging; consulta Cuándo pregunta antes.
Archivos de conocimiento
Sección titulada «Archivos de conocimiento»Los archivos de conocimiento se suben en el creador del agente, en Configurar → Conocimiento, y pertenecen a ese agente. No vencen y no se copian a su computadora: el agente los consulta y los lee directamente, en cada tarea en la que trabaja.
| Tipos de archivo | PDF, imágenes PNG y JPEG, texto (.txt, .md, .csv), Word (.docx), Excel (.xlsx) y PowerPoint (.pptx) |
| Límites | 25 MB por archivo, 20 archivos por agente, hasta 50 páginas escaneadas por archivo |
Cuando se agrega un archivo, se lee una vez, y su estado pasa de Leyendo el archivo… a Listo — o a Falló, con el motivo.
- Los PDF se leen a partir de su texto. Una página sin texto — un escaneo — se lee con reconocimiento de texto, en inglés y en español, y el estado indica cuántas páginas escaneadas se leyeron. Una imagen se lee del mismo modo. Solo texto impreso: no se leen la letra manuscrita, los gráficos ni las fotos.
- Las hojas de cálculo y los archivos CSV se guardan como tablas: cada fila sigue siendo una fila, con los nombres de sus columnas. Los valores de Excel conservan su formato — las fechas como fechas, los porcentajes como porcentajes — y cada hoja es una página.
- Los archivos de Word y de texto se dividen en páginas de unos 3,000 caracteres; PowerPoint es una página por diapositiva.
En una tarea, el agente ve el nombre, el número de páginas y la descripción de cada archivo. Cuando necesita un dato, los consulta (Buscando … en su conocimiento) y lee las páginas que necesita, hasta diez a la vez (Leyendo un archivo de conocimiento).
Quién puede ver los archivos de una tarea
Sección titulada «Quién puede ver los archivos de una tarea»Un archivo lo pueden ver exactamente las personas que pueden ver su tarea: quien la inició, las personas con quienes se compartió y quienes pueden ver la automatización que la inició. Los propietarios que abren una tarea con su enlace pueden leerla, en solo lectura. Los administradores no tienen acceso adicional. Un archivo que adjuntaste pero que todavía no enviaste solo lo ves tú. Cuando se elimina una tarea, nadie puede abrir sus archivos.
La única excepción es un enlace para compartir: cualquiera que lo tenga puede ver ese único archivo, sin iniciar sesión, hasta que el enlace deje de funcionar.
Los archivos de conocimiento de un agente aparecen en su creador. Solo las personas que pueden configurar el agente los agregan, describen o quitan, y el agente solo consulta los suyos. AptiveAI Agents no ofrece la descarga de un archivo de conocimiento, así que guarda tu propia copia.