Carga de archivos
Financiación y uso de IA
IA incluida utiliza créditos REDA. Traiga su propia IA utiliza la cuenta de proveedor de su organización, facturada directamente por ese proveedor. La licencia determina un modelo para toda la organización. En ambos, REDA AI controla las herramientas y acciones configuradas en Salesforce. Configure la licencia y las cuentas de IA.
Con una cuenta propia, el modelo elegido determina los niveles de razonamiento profundo y capacidades disponibles. Revise los niveles y avisos del selector AI Account; no suponga que todos los proveedores admiten la misma combinación. Las herramientas administrativas y el procesamiento de documentos utilizan la conexión predeterminada de la organización. Configure el valor predeterminado y pruebe el flujo.
Esta página cubre la carga de archivos iniciada por el usuario — lo que ocurre cuando un usuario adjunta un archivo dentro de un chat. Para conocer la capacidad más amplia de la plataforma que permite a los agentes ingerir archivos que llegan desde el correo, los Flows, la API o los canales de mensajería — incluidos el flujo de procesamiento de archivos, la entrega de archivos grandes y los tres patrones de conexión — consulta Procesamiento de documentos.
¿Qué es la carga de archivos?
La carga de archivos permite a los usuarios adjuntar documentos, imágenes, hojas de cálculo y archivos de datos a sus conversaciones. El agente procesa el contenido del archivo y puede:
- Responder preguntas sobre el contenido del archivo
- Resumir documentos y extraer información clave
- Importar datos de CSV a registros de Salesforce
- Analizar imágenes y capturas de pantalla
- Vincular los archivos cargados a registros de Salesforce
Tipos de archivo admitidos
| Tipo de archivo | Extensiones | Lo que el agente puede hacer |
|---|---|---|
.pdf |
Leer y resumir documentos, extraer datos, responder preguntas sobre el contenido | |
| CSV | .csv |
Leer datos tabulares, responder preguntas, importar filas como registros de Salesforce |
| Imágenes | .png, .jpg, .jpeg |
Analizar imágenes, leer texto en capturas de pantalla, describir contenido visual |
| Texto | .txt |
Leer y analizar contenido de texto sin formato |
| JSON | .json |
Analizar e interpretar datos estructurados |
La lista de extensiones permitidas se puede configurar en la Configuración de la plataforma. Consulta Configuración más abajo.
Habilitar la carga de archivos
-
Abre la Definición de agente
Ve al registro de Definición de agente de REDAAI.
-
Marca Permitir carga de archivos
La casilla Permitir carga de archivos está habilitada de forma predeterminada en los agentes nuevos. Verifica que esté marcada.
-
(Opcional) Configura los Tipos de archivo admitidos
Si quieres restringir qué tipos de archivo acepta este agente en particular, configura el campo Tipos de archivo admitidos (extensiones separadas por comas). Déjalo en blanco para usar la lista de permitidos global de la Configuración de la plataforma.
-
(Opcional) Habilita Ejecutar acciones de archivo automáticamente
Marca Ejecutar acciones de archivo automáticamente para que el agente realice acciones sobre los archivos cargados de forma automática (por ejemplo, importar datos de CSV) sin pedir confirmación primero.
Cómo cargan archivos los usuarios
En la interfaz de chat (canal interno), los usuarios hacen clic en el icono de adjuntar junto al campo de mensaje para seleccionar uno o más archivos — hasta 5 por mensaje. Cada archivo adjunto aparece como un chip (con su nombre de archivo) que se puede quitar de forma individual antes de enviarlo. Los archivos se cargan en Salesforce como registros ContentVersion y, luego, el agente procesa su contenido.
Los usuarios también pueden arrastrar y soltar archivos en el área de chat en los navegadores compatibles.
Widget del portal de Comunidad. Los usuarios del portal (Experience Cloud) que han iniciado sesión cargan archivos de la misma manera — un botón de clip en la barra de mensajes, hasta 5 archivos por mensaje. Cada archivo adjunto aparece como un chip con su nombre en el mensaje enviado. Los archivos cargados en el portal se asocian automáticamente con el registro de Contacto del cliente que ha iniciado sesión, para que tu equipo pueda encontrarlos más adelante desde el registro del cliente. El botón de clip aparece solo cuando el agente tiene habilitada la opción Permitir carga de archivos.
- El usuario carga
tenants.csvy escribe “Importa estos inquilinos como registros de Contacto” - El agente lee el CSV, identifica los encabezados de columna y los asigna a campos de Contacto
- El agente crea un registro de Contacto por cada fila (con confirmación, a menos que la ejecución automática esté habilitada)
- El agente informa los resultados: cuántos registros se crearon correctamente
Vinculación de archivos
Cuando la herramienta link_file_to_record está asignada al agente, este puede adjuntar los archivos cargados a registros de Salesforce. Por ejemplo, un usuario podría cargar el PDF de una factura y pedirle al agente que lo adjunte a un registro de Cuenta u Oportunidad específico.
En el portal de Comunidad, un archivo cargado se vincula automáticamente al Contacto del cliente. Además, el asistente puede adjuntar el mismo archivo a un registro relacionado cuando se le solicita — por ejemplo, a un Caso que abre para el cliente. En el caso de un agente de portal, mantén esto acotado a los propios registros del cliente (su Contacto, Cuenta o Casos) para que los clientes solo puedan afectar sus propios datos.
Configuración
El comportamiento de la carga de archivos se controla a través de la Configuración de la plataforma en el panel de administración de REDA AI:
| Ajuste | Valor predeterminado | Rango | Descripción |
|---|---|---|---|
| Max File Size (MB) | 5 | 1 – 25 | Tamaño máximo de archivo permitido para las cargas. Los archivos que superan este límite se rechazan. |
| Allowed File Extensions | pdf,csv,png,jpg,jpeg,txt,json |
— | Lista separada por comas de las extensiones de archivo permitidas. Los archivos con otras extensiones se rechazan. |
| Max CSV Characters | 50.000 | 10.000 – 200.000 | Cantidad máxima de caracteres para el contenido de un archivo CSV. Los CSV que superan este límite devuelven un error. |
| File Processing Credit Multiplier | Configurable | — | Amplía el límite máximo de tokens de salida para las solicitudes de procesamiento de archivos. Los valores más altos permiten un análisis más detallado a un mayor costo de créditos. |
Configuración de la Definición de agente
Ajustes de carga de archivos por agente en el registro de Definición de agente:
| Campo | Valor predeterminado | Descripción |
|---|---|---|
| Permitir carga de archivos | Habilitado | Interruptor principal de la carga de archivos en este agente |
| Tipos de archivo admitidos | (en blanco — usa el ajuste global) | Anula las extensiones permitidas globales solo para este agente |
| Ejecutar acciones de archivo automáticamente | Deshabilitado | Cuando está habilitado, el agente actúa sobre los archivos de inmediato, sin pedir confirmación |
Impacto en los créditos
Las cargas de archivos aumentan la cantidad de tokens de entrada de una conversación, porque el contenido del archivo se envía a la IA para su procesamiento. Los archivos más grandes usan más tokens y, por lo tanto, más créditos.
- Archivos de texto y CSV — la cantidad de tokens es proporcional a la cantidad de caracteres
- PDF e imágenes — se procesan como contenido multimodal, que usa más tokens por unidad de contenido
- Multiplicador de créditos — el ajuste Multiplicador de créditos de procesamiento de archivos aumenta el presupuesto de tokens de salida para las respuestas relacionadas con archivos, lo que permite un análisis más detallado
Para archivos CSV grandes, considera dividirlos en lotes más pequeños antes de cargarlos. El ajuste Máximo de caracteres de CSV evita que archivos excesivamente grandes consuman demasiados créditos en una sola solicitud.
Prácticas recomendadas
Establece límites de tamaño adecuados — El límite predeterminado de 5 MB funciona bien para la mayoría de los documentos. Auméntalo solo si los usuarios necesitan cargar archivos más grandes con regularidad.
Restringe las extensiones para los agentes externos — Para los agentes del widget externo, considera limitar los tipos de archivo permitidos únicamente a lo necesario (por ejemplo, solo csv y txt).
Usa la ejecución automática con cuidado — Ejecutar acciones de archivo automáticamente omite la confirmación para las acciones basadas en archivos, como las importaciones de CSV. Habilítala solo para agentes internos de confianza cuyos usuarios comprendan las consecuencias.
Asigna la herramienta link_file_to_record — Si quieres que el agente adjunte los archivos cargados a registros, asegúrate de que la herramienta link_file_to_record esté asignada al agente.
Preguntas frecuentes
Sí — los usuarios pueden adjuntar hasta 5 archivos por mensaje, tanto en el asistente dentro de Salesforce como en el widget del portal de Comunidad. Cada uno se muestra como su propio chip y se puede quitar de forma individual antes de enviarlo; el agente los recibe y procesa todos juntos. Para más de 5, envía archivos adicionales en un mensaje de seguimiento dentro de la misma conversación.
Sí. Cuando el agente tiene habilitada la opción Permitir carga de archivos, aparece un botón de clip en el widget del portal de Comunidad. Los archivos que un cliente carga allí se vinculan automáticamente a su registro de Contacto. El asistente también puede adjuntar un archivo cargado a un registro relacionado (como un Caso que cree) cuando se le solicita.
Sí. La acción invocable de REDA AI acepta varios archivos en una sola llamada, de modo que un flujo automatizado puede enviar varios documentos al asistente a la vez.
Los archivos se almacenan como registros ContentVersion de Salesforce, siguiendo el almacenamiento de archivos estándar de Salesforce. Cuentan para los límites de almacenamiento de archivos de tu organización.
Sí. Cuando un usuario carga un CSV y le pide al agente que lo importe, el agente lee los datos, asigna las columnas a campos de Salesforce y crea registros. El agente pide confirmación antes de crear registros (a menos que la opción Ejecutar acciones de archivo automáticamente esté habilitada).
La carga se rechaza con un mensaje de error que le indica al usuario el tamaño máximo de archivo permitido. El archivo no se procesa.
La carga de archivos depende del canal y de la configuración del agente. La opción Permitir carga de archivos en la Definición de agente controla la disponibilidad por agente.
Las extensiones permitidas se pueden configurar en la Configuración de la plataforma. Sin embargo, el agente solo puede procesar los tipos de archivo que admite de forma nativa (PDF, CSV, PNG, JPG, TXT, JSON). Agregar extensiones no admitidas a la lista de permitidos habilitará las cargas, pero es posible que el agente no pueda leer el contenido.
Próximos pasos
Aprende sobre la Configuración de herramientas para administrar qué herramientas y capacidades se asignan a tus agentes, o revisa Cómo funcionan los créditos para comprender el impacto que tiene el procesamiento de archivos en los créditos.