Procesamiento de documentos
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.
¿Qué es el procesamiento de documentos?
El procesamiento de documentos es la capacidad de la plataforma que permite a un agente de REDA AI tratar un archivo como una entrada de primer nivel. El agente puede leer el documento, razonar sobre su contenido y usar los resultados para consultar o actualizar registros de Salesforce, todo en un único turno de conversación o trabajo asíncrono.
A diferencia de un pipeline tradicional de “cargar y luego analizar”, REDA AI envía el documento sin procesar directamente al modelo como contenido multimodal. No hay un paso de OCR aparte, ni una plantilla con esquema rígido, ni un salto a un almacenamiento externo. El mismo procesador gestiona los documentos que llegan por cualquier canal:
- Archivos adjuntados por un usuario dentro de una conversación de chat
- Archivos adjuntos de correo recibidos a través de una dirección del servicio de correo entrante
- Archivos proporcionados por un Flujo de Salesforce como parte de una acción declarativa del agente
- Archivos enviados a través de la API REST por un sistema externo
Formatos admitidos
| Formato | Extensiones | Cómo lo lee el agente |
|---|---|---|
.pdf |
Se envía como un bloque de documento multimodal: el texto, el diseño y las imágenes incrustadas se leen en conjunto. | |
| Imagen | .png, .jpg, .jpeg |
Se envía como una entrada de visión: el agente lee el texto visible y describe el contenido visual. |
| CSV | .csv |
Se analiza como datos tabulares; las filas se pueden asignar a registros de Salesforce mediante una herramienta de mapeo de archivos. |
| Texto | .txt |
Se incorpora como contenido de texto sin formato para que el agente lo resuma o extraiga información de él. |
| JSON | .json |
Se incorpora como datos estructurados para que el agente los consulte o transforme. |
La lista de extensiones permitidas activa se controla mediante la configuración de plataforma Extensiones de archivo permitidas y se puede restringir por agente en el registro de Definición de agente.
Cómo funciona el procesador
-
El archivo llega
Sea cual sea la forma en que el archivo entra en la organización (carga desde el chat, archivo adjunto de correo, entrada de Flujo o llamada a la API), se almacena como un registro
ContentVersionpara que se apliquen las reglas estándar de uso compartido y auditoría. -
Validación
La extensión del archivo se coteja con la lista de extensiones permitidas, el tamaño se compara con Tamaño máximo de archivo (MB) y el recuento de caracteres de los CSV se compara con Máximo de caracteres CSV. Los archivos que no superan la validación se rechazan con un error claro y nunca se envían al modelo.
-
Ensamblaje de bloques
El procesador convierte el archivo en el bloque multimodal adecuado para el modelo: un bloque de documento para los PDF, un bloque de imagen para las entradas de visión o un bloque de texto en línea para los formatos de texto sin formato.
-
Archivos grandes
Los archivos pequeños se incorporan directamente. Los archivos que superan el Umbral de distribución de archivos se exponen mediante una URL
ContentDistributionde corta duración para que el modelo pueda obtenerlos sin que el archivo se cargue en memoria. El enlace de distribución caduca automáticamente y lo elimina un trabajo programado. -
Razonamiento
El agente lee el documento dentro de su turno actual y luego llama a las herramientas que tenga disponibles: consultar registros, crear registros o invocar una herramienta de Apex personalizada que recibe los datos extraídos como JSON estructurado.
-
Resultado
El agente informa lo que encontró, solicita confirmación antes de cualquier acción de escritura (a menos que la ejecución automática esté habilitada para ese agente), y todos los registros nuevos o actualizados quedan sujetos a la seguridad a nivel de campo y al uso compartido del usuario en ejecución.
Tres formas de conectar los documentos con los registros
Leer un documento es solo la mitad del trabajo. La otra mitad es decidir qué debe hacer el agente con lo que leyó. REDA AI te ofrece tres patrones, todos basados en el mismo procesador.
| Patrón | Ideal para | Esfuerzo de configuración |
|---|---|---|
| Extracción conversacional (solo herramientas integradas) |
Preguntas puntuales sobre un archivo, resúmenes, copiar y pegar algunos valores en un registro existente. Funciona con las herramientas estándar get_record, create_record y update_record. |
Ninguno: funciona de inmediato en cualquier agente que tenga habilitado Permitir carga de archivos. |
| Herramienta de mapeo de archivos (tipo de herramienta File_Mapping) |
Importaciones masivas predecibles, normalmente CSV. Tú declaras qué columnas se asignan a qué campos y en qué objeto; el agente completa los valores a partir del archivo. | Bajo: configuración declarativa en el creador de herramientas. No se requiere Apex. |
| Herramienta de Apex con procesamiento de archivos (tipo de herramienta Apex_Class con Es procesamiento de archivos habilitado) |
Extracción específica del dominio donde quieres control total: escrituras en varios objetos, lógica condicional, llamadas a sistemas externos, conciliación frente a registros existentes. | Mayor: requiere una clase de Apex que implemente la interfaz del ejecutor. La clase recibe los datos extraídos como una entrada Map<String, Object>. |
Tanto el tipo de herramienta de mapeo de archivos como el de Apex se crean en el creador de herramientas. Consulta Configuración de herramientas para conocer la interfaz de creación con tarjetas de tipo, el panel de impacto en vivo y la orientación por tipo que el Generador con IA ofrece mientras construyes.
Canales que activan el procesamiento de documentos
En una conversación de chat
En cualquier agente que tenga habilitado Permitir carga de archivos, los usuarios adjuntan un archivo de la misma forma en que escribirían un mensaje. El agente lee el archivo como parte del siguiente turno. Consulta Carga de archivos para conocer la experiencia del usuario, los canales admitidos y los ajustes por agente.
Desde un correo entrante
REDA AI incluye un controlador de servicio de correo que acepta correo entrante en una dirección administrada por Salesforce. Los archivos adjuntos que superan un tamaño mínimo pequeño se filtran con la misma lista de extensiones permitidas, se almacenan como ContentVersion y se ponen en cola para su procesamiento asíncrono por el agente enrutado. Los archivos adjuntos diminutos, como los logotipos y las firmas de correo, se omiten automáticamente.
La asignación de la dirección entrante al agente se guarda en los metadatos personalizados Email Routing. Consulta Canal de correo — Entrante para conocer la configuración completa.
Desde un Flujo de Salesforce
Un Flujo desencadenado por registro puede pasar un ContentDocumentId (o el ContentVersion relacionado) a la acción invocable de REDA AI, junto con un agente de destino y una instrucción. El agente procesa el archivo en segundo plano y escribe los resultados de vuelta en Salesforce. Consulta Invocar REDA AI desde Flujos.
Desde un sistema externo
Tanto la API del widget externo como la de Comunidad aceptan entradas de archivos junto con un mensaje de chat, por lo que una aplicación de terceros puede enviar un documento a una conversación de REDA AI mediante programación.
Confirmación de acciones
El procesamiento de documentos sigue el mismo modelo de seguridad que el resto de la plataforma. Cuando el agente decide escribir en Salesforce según lo que leyó, presenta una tarjeta de acción y espera a que el usuario confirme, a menos que el agente esté configurado con Ejecución automática de acciones de archivo, en cuyo caso las escrituras se realizan de inmediato. Consulta Confirmaciones de acciones para conocer el flujo completo y la postura recomendada para cada canal.
Configuración
El procesamiento de documentos reutiliza los ajustes de gestión de archivos de la página de Configuración de la plataforma. Los valores más relevantes:
| Ajuste | Valor predeterminado | Propósito |
|---|---|---|
| Max File Size (MB) | 5 | Límite máximo absoluto para cualquier archivo que el procesador aceptará. |
| Allowed File Extensions | pdf,csv,png,jpg,jpeg,txt,json |
Lista de extensiones permitidas global que se aplica antes de que cualquier archivo llegue al modelo. |
| Max CSV Characters | 50.000 | Limita el tamaño de un único archivo CSV que el agente procesará en línea. |
| File Distribution Threshold (KB) | 1300 | Los archivos que superan este tamaño se entregan al modelo mediante una URL de corta duración en lugar de incorporarse en línea. |
| Distribution Expiry (Minutes) | 30 | Tiempo de vida de la URL temporal utilizada para la entrega de archivos grandes. |
| File Processing Credit Multiplier | Configurable | Amplía el presupuesto de tokens de salida para los turnos que incluyen archivos, de modo que el agente pueda producir resultados de extracción más completos. |
| Email File Processing Enabled | — | Control de seguridad que determina si se procesan los archivos adjuntos de los mensajes del servicio de correo entrante. Si está desactivado, se ignoran los archivos adjuntos; el correo se sigue enrutando a su agente. |
Consulta Configuración de la plataforma para conocer la referencia completa de los metadatos de configuración.
Impacto en los créditos
El procesamiento de documentos aumenta el recuento de tokens de entrada de una conversación porque el contenido del archivo se envía al modelo. El impacto en los créditos depende del formato:
- Texto y CSV: el recuento de tokens escala con el recuento de caracteres.
- PDF e imágenes: se envían como bloques multimodales, que usan más tokens por unidad de contenido que el texto sin formato.
- Salida: el Multiplicador de créditos por procesamiento de archivos aumenta el presupuesto máximo de respuesta para los turnos que incluyen archivos. Un valor más alto significa resultados de extracción más completos, a un costo de créditos mayor.
Consulta Optimización del uso de créditos para obtener orientación sobre el ajuste.
Seguridad y gobernanza
- Permanece en tu organización. Los archivos se almacenan como
ContentVersionen tu organización de Salesforce. La plataforma no copia los archivos a ningún almacenamiento externo. - Se aplica el uso compartido estándar. Quien ejecute el agente debe tener acceso de uso compartido al archivo y a cualquier registro que el agente lea o escriba.
- Se aplica la seguridad a nivel de campo. Las escrituras que resultan de la extracción de documentos respetan la seguridad a nivel de campo (FLS) del usuario en ejecución: los campos que el usuario no puede editar no se modifican.
- URL de corta duración para archivos grandes. Cuando el modelo obtiene un archivo grande mediante un enlace de distribución, la URL caduca después del período configurado y la elimina un trabajo programado.
- Registro de auditoría. Cada conversación impulsada por archivos se registra en los registros estándar de Conversación y Mensaje, incluidas las llamadas a herramientas que hizo el agente y los registros que modificó.
Consulta Seguridad de datos en REDA AI para conocer la postura de seguridad completa.
Prácticas recomendadas
Ajusta el patrón a la tarea. Usa las herramientas integradas para la extracción puntual; usa una herramienta de mapeo de archivos cuando se procesa repetidamente el mismo tipo de archivo; recurre a una herramienta de Apex solo cuando la lógica realmente necesita código.
Restringe la lista de extensiones permitidas por agente. Un agente que solo procesa facturas no necesita aceptar cargas de imágenes. Limita los Tipos de archivo admitidos en la Definición de agente para reducir las entradas inesperadas.
Mantén los CSV ligeros. Elimina las columnas que no uses antes de procesar y divide los archivos grandes en lotes que quepan holgadamente por debajo de Máximo de caracteres CSV. El agente es más preciso con entradas específicas.
Sé deliberado con la Ejecución automática de acciones de archivo. La ejecución automática elimina el paso de confirmación. Resérvala para agentes internos de confianza y tipos de archivo bien comprendidos.
Prueba los casos problemáticos. Dale al agente archivos PDF con formato incorrecto, CSV en blanco e imágenes irrelevantes durante la construcción: el estilo de respuesta ante entradas incorrectas forma parte de la experiencia del usuario.
Automatización y fiabilidad
Las invocaciones masivas desde Flow pueden devolver identificadores de solicitudes diferidas en lugar de respuestas inmediatas. Revise los elementos posteriores que esperan respuesta, créditos o resultados en la misma transacción. Las acciones automáticas conservan el canal y modo configurados, y sus resultados reales quedan en contexto; esto no garantiza un turno narrativo adicional. Se conservan desplazamientos horarios explícitos en eventos, programación, escritura de campos y CSV compatibles. Sin desplazamiento se conserva la interpretación del usuario ejecutor. El modo Sistema no genera advertencias por el mero hecho de usarlo; continúan los registros y notificaciones de nivel ERROR. La extracción respeta el límite de salida, los colores funcionan en los temas Salesforce admitidos y las pruebas empaquetadas evitan referencias estáticas que bloqueaban la instalación sin tipos de registro de Cuenta.
Preguntas frecuentes
No. Los archivos permanecen en tu organización de Salesforce como registros ContentVersion. El modelo lee el documento directamente como una entrada multimodal: no hay ningún servicio intermedio de OCR ni de extracción de documentos.
Los archivos que superan el Umbral de distribución de archivos se entregan al modelo mediante una URL ContentDistribution de corta duración en lugar de mantenerse en memoria. El enlace caduca después del período configurado y lo elimina un trabajo programado.
Sí. Con el Procesamiento de archivos de correo habilitado, los archivos adjuntos de la dirección del servicio de correo entrante se filtran, se almacenan como archivos en Salesforce y se enrutan al agente asignado a esa dirección mediante los metadatos Email Routing. Consulta Canal de correo — Entrante.
Usa una herramienta de mapeo de archivos cuando el archivo es tabular, el mapeo de columnas a campos es estable y la operación es una simple creación o actualización. Usa una herramienta de Apex cuando necesites lógica condicional, escrituras en varios objetos, eliminación de duplicados frente a registros existentes o llamadas a sistemas externos.
Sí. Las escrituras que desencadena el procesamiento de documentos se ejecutan con los permisos del usuario y respetan la seguridad a nivel de campo y el uso compartido. Los campos que el usuario no puede editar no se modifican, aunque el documento contenga un valor para ellos.
El modelo lee los archivos PDF escaneados y las imágenes como contenido visual, por lo que el texto legible se extrae como parte de la misma llamada. La calidad depende de la imagen de origen: los escaneos nítidos se extraen de forma confiable y las fotos de baja resolución conviene acompañarlas con indicaciones explícitas del usuario en la conversación.
Sí. El contenido del archivo forma parte de la entrada que ve el modelo, por lo que los archivos más grandes consumen más créditos. El Multiplicador de créditos por procesamiento de archivos también amplía el presupuesto de salida para los turnos que incluyen archivos. Consulta Optimización del uso de créditos para obtener consejos de ajuste.
Próximos pasos
Configura importaciones masivas con el tipo de herramienta de mapeo de archivos, crea un extractor personalizado con el tipo de herramienta de Apex o aprende a conectar los documentos entrantes en la página Canal de correo — Entrante.