Referencia de configuración de la plataforma
Todos los ajustes, grupo por grupo
Esta es la lista completa tal y como aparece en REDA AI Admin → Configuration en la versión actual: 34 ajustes en seis grupos, en el orden de la pantalla, con el valor por defecto y la descripción del propio producto. Las secciones temáticas siguientes profundizan en los que lo necesitan.
System & Notifications
| Ajuste | Por defecto | Qué controla |
|---|---|---|
| REDA AI Enabled | — | Interruptor maestro. Al desactivarlo, todas las funciones de REDA AI se detienen para todos los usuarios de la organización. |
| Email Reply Tracking | Off | Rastrea las respuestas a los correos enviados desde conversaciones de REDA AI. |
| Notification Sender Email | — | La dirección «De» de los correos de notificación de incidencias. Debe ser una dirección de correo verificada para toda la organización. |
External Channels
| Ajuste | Por defecto | Qué controla |
|---|---|---|
| External Bot API | — | Habilita el endpoint REST para integraciones con chatbots externos (WhatsApp, SMS, etc.). |
| External Bot Daily Credit Cap | 500 | Créditos máximos por día para las llamadas a la API del bot externo. 0 significa sin límite. |
| Community Portal Chat | — | Habilita el widget de chat con IA en los portales de Experience Cloud (comunidad). |
| Community Bot Daily Credit Cap | 2000 | Créditos máximos por día para el chat del portal de comunidad. 0 significa sin límite. |
AI Response Limits
| Ajuste | Por defecto | Qué controla |
|---|---|---|
| Tokens máx. de salida | 4000 | Longitud máxima de respuesta para el chat estándar y la preextracción de archivos. Es un techo, no un objetivo. |
| Agent Builder Max Tokens | 12000 | Tokens máximos para «Build Agent with AI». Se reparten 60/40 entre dos llamadas de IA (paso 1 = 7200, paso 2 = 4800). Sube a 16000 para agentes muy complejos. |
| Prompt Optimizer Max Tokens | 4096 | Tokens máximos para la optimización de prompts y campos de contexto. |
| Tool Builder Max Tokens | 4096 | Tokens máximos para generar y optimizar herramientas. Las herramientas Apex complejas pueden necesitar 6000 o más. |
| Debugger Max Tokens | 3000 | Tokens máximos para la depuración de conversaciones y el análisis de incidencias. |
| Conflict Detector Max Tokens | 1024 | Tokens máximos para el análisis de conflictos entre prompts. |
| Prompt Generator Max Tokens | 2048 | Tokens máximos para el contenido de prompts generado por IA. |
| Tool Iteration Max Tokens | 1000 | Tokens por cada vuelta intermedia del bucle de herramientas (solo llamadas a herramientas, no prosa completa). |
| Greeting Max Tokens | 800 | Tokens para respuestas breves de saludo («Hola», «Buenas»). |
| Deep Reasoning Max Tokens Cap | — | Límite superior de los tokens de salida totales de un agente (respuesta más razonamiento extendido) cuando Deep Reasoning está activo. |
| Max API Retries | 3 | Reintentos ante llamadas limitadas por frecuencia (429) o sobrecargadas (529). No afecta a los trabajos programados. |
| Búsquedas web máx. | 5 | Búsquedas web por turno de conversación. Cada búsqueda consume créditos adicionales. Solo se aplica a los agentes con búsqueda web habilitada. |
Query & Data Limits
| Ajuste | Por defecto | Qué controla |
|---|---|---|
| Max Query Rows | 200 | LIMIT que se añade automáticamente a las consultas SOQL generadas por las herramientas. |
| Max Display Rows | 50 | Filas que se muestran en línea antes de resumir con «mostrando X de Y». |
| Max Query Result Length | 15000 | Caracteres máximos por resultado de herramienta enviado al modelo. Valores más altos aportan más datos y consumen más tokens. |
| Días de retención de archivos | 180 | Días que se conservan los registros de conversación archivados antes de eliminarlos. |
| Incident Deduplication Window | 0 (disabled, logs all incidents) | Minutos durante los que se suprimen incidencias duplicadas (misma clase, método y error). 0 lo desactiva y registra todas. |
Conversation Optimization
| Ajuste | Por defecto | Qué controla |
|---|---|---|
| Presupuesto de tokens de historial | — | Presupuesto estimado de tokens para el historial de la conversación. Se conservan los mensajes completos más recientes hasta agotarlo. |
| Greeting Char Threshold | 20 | Una entrada más corta que esto se trata como un saludo y usa un presupuesto de tokens reducido. |
File Processing & Streaming
| Ajuste | Por defecto | Qué controla |
|---|---|---|
| Max File Size (MB) | 5 MB | Tamaño máximo de archivo subido, en megabytes. Los archivos que lo superen se rechazan. |
| Allowed File Extensions | pdf,csv,png,jpg,jpeg,txt,json | Extensiones permitidas para subir archivos, separadas por comas. |
| Max CSV Characters | 50000 | Número máximo de caracteres del contenido de un CSV. Los CSV que lo superen devuelven un error. |
| File Processing Credit Multiplier | 2 (e | Multiplica el presupuesto máximo de tokens de salida para el procesamiento de archivos (por ejemplo, 2000 tokens × 2 = 4000). |
| File Distribution Threshold (KB) | 1300 KB | Los archivos binarios mayores que este umbral reciben una URL pública temporal para la IA. |
| Distribution Link Expiry (Minutes) | 30 | Minutos hasta que los enlaces temporales de archivo caducan solos. También se eliminan después de cada llamada a la API. |
| Email File Processing | Off | Procesa los archivos adjuntos recibidos por el servicio de correo. Requiere un agente de procesamiento de correo. |
| Admin Tools Always Stream | On | Las herramientas de administración (Agent Builder, Tool Builder, Prompt Builder) usan llamadas en streaming para evitar tiempos de espera. |
Agent Definition → Max Tool Iterations, por defecto 6: cinco vueltas de herramienta más una respuesta de texto forzada). El registro de toda la organización está obsoleto y ya no se lee, así que cambiarlo no tiene efecto. Ajusta el tope por agente.
Interruptores maestros
Estos activan y desactivan capacidades completas. Usa 1 para habilitado y 0 para deshabilitado.
| Configuración | Predeterminado | Propósito |
|---|---|---|
| Is Enabled | 1 |
Interruptor maestro de apagado de REDA AI. Cuando está deshabilitado, se bloquean todas las interacciones de IA. |
| External Bot Enabled | 1 |
Interruptor maestro para la función de chatbot externo. Cuando está deshabilitado, se rechazan todas las solicitudes de la API REST provenientes de los widgets de chatbot externos. Habilítalo después de configurar un sitio de Salesforce y un perfil de usuario invitado. |
| Community Bot Enabled | 1 |
Interruptor maestro para el chatbot del portal de Comunidad. Cuando está deshabilitado, se rechazan todas las solicitudes de la API REST provenientes de los widgets de Comunidad. |
| Email File Processing Enabled | 0 |
Control de seguridad que determina si se procesan los archivos adjuntos de los mensajes entrantes del Email Service. Cuando está deshabilitado, el controlador ignora los archivos adjuntos — pero un correo enrutado igual llega a su agente como una conversación; no bloquea el canal. Desactivado de forma predeterminada. |
| Email Tracking Enabled | 0 |
Habilita el seguimiento de respuestas de correo para las acciones programadas. Cuando está habilitado, un activador (trigger) de EmailMessage monitorea las respuestas entrantes a los correos salientes con seguimiento y dispara las acciones programadas asociadas. Requiere que Enhanced Email esté habilitado en la organización. |
| Admin Tools Always Stream | 1 |
Cuando está habilitado, las herramientas de administración (Creador de agentes, Creador de herramientas, Creador de prompts) siempre usan la API de streaming, independientemente de la configuración del agente. Evita los tiempos de espera agotados durante operaciones complejas asistidas por IA. |
Claves de licencia
Esta configuración contiene valores de licencia cifrados que la plataforma usa para autorizar las llamadas de IA. Los completa el flujo de activación de licencia en la pestaña Administración; los administradores nunca editan los valores directamente. Consulta Activación de tu licencia.
Para cambiar qué licencia está en vigor, ejecuta el flujo Activar licencia desde la pestaña Administración. La plataforma se encarga por ti de la actualización segura de esta configuración.
Procesamiento de archivos
Controla qué archivos pueden leer los agentes, qué tamaño pueden tener y cómo se entregan al modelo los archivos grandes. Consulta Procesamiento de documentos para conocer el flujo más amplio.
| Configuración | Predeterminado | Propósito |
|---|---|---|
| Allowed File Extensions | pdf,csv,png,jpg,jpeg,txt,json |
Lista separada por comas de las extensiones de archivo permitidas para la carga. Los archivos con extensiones que no estén en esta lista se rechazan. |
| Max File Size MB | 5 |
Tamaño máximo permitido para las cargas de archivos en megabytes. Los archivos que superan este límite se rechazan antes de procesarse. |
| Max CSV Characters | 50000 |
Cantidad máxima de caracteres permitidos en un archivo CSV. Los archivos que superan este límite devuelven un error (sin truncamiento). Establécelo en 0 para no aplicar límite. |
| File Distribution Threshold KB | 1300 |
Tamaño de archivo (KB) por encima del cual los archivos binarios (PDF, PNG, JPG) reciben una URL pública temporal para el modelo en lugar de incorporarse en línea. Los archivos de texto siempre se incorporan en línea, independientemente de este umbral. |
| Distribution Expiry Minutes | 30 |
Minutos hasta que expira un enlace temporal de distribución de archivos. Actúa como red de seguridad — los enlaces también se eliminan tras la llamada a la API del modelo y mediante el trabajo de limpieza cada hora. |
| File Processing Credit Multiplier | (predeterminado de la plataforma) | Controla con qué intensidad la plataforma amplía el presupuesto de salida en los turnos que procesan archivos, para que el agente pueda producir resultados de extracción más detallados. Redúcelo en agentes que necesitan salidas estructuradas breves a partir de muchos archivos pequeños; auméntalo en agentes que producen extracciones estructuradas largas. |
Topes de créditos
Los topes diarios evitan costos descontrolados en los canales de cara al público. Son independientes de los créditos mensuales de la licencia. Consulta Cómo funcionan los créditos.
| Configuración | Predeterminado | Propósito |
|---|---|---|
| External Daily Credit Cap | 500 |
Cantidad máxima total de créditos que todas las sesiones de chatbot externo combinadas pueden consumir por día en todos los agentes. Establécelo en 0 para no aplicar límite (no recomendado). |
| Community Daily Credit Cap | 2000 |
Cantidad máxima de créditos que todas las sesiones de chatbot del portal de Comunidad combinadas pueden consumir por día natural. Déjalo en blanco o en 0 para no aplicar límite. Independiente del Tope diario de créditos externos. |
Historial y contexto de la conversación
Controla cuánta conversación previa ve el modelo en cada turno. REDA AI conserva los mensajes completos más recientes cuyo tamaño combinado quepa dentro de un presupuesto de tokens; nunca trunca un mensaje individual (el truncamiento corrompería las llamadas o los resultados de las herramientas). Un presupuesto menor ahorra créditos; un presupuesto mayor le da al agente más memoria.
| Configuración | Predeterminado | Propósito |
|---|---|---|
| Presupuesto de tokens de historial | 30000 |
Presupuesto de tokens para el historial de conversaciones por solicitud. REDA AI incluye los mensajes completos más recientes que quepan en este presupuesto y descarta por completo los más antiguos; nunca corta un mensaje a mitad de contenido. Mínimo 4000. |
| Profundidad máx. de continuación | 3 |
En los canales de widget externo y de Comunidad, después de que una acción se ejecuta automáticamente, el agente toma de forma automática un turno de seguimiento para informar el resultado real. Limita cuántos de esos turnos de continuación automáticos pueden ocurrir por solicitud. |
Ejecución del agente
Controla el presupuesto de salida del modelo por turno y la forma del bucle agéntico.
| Configuración | Predeterminado | Propósito |
|---|---|---|
| Tokens máx. de salida | 2000 |
Cantidad máxima de tokens de salida para las respuestas de REDA AI. Los valores más altos permiten respuestas más largas (por ejemplo, planes de acción complejos), pero cuestan más créditos. Rango: 1000–4096. |
| Máximo de iteraciones de herramientas | 6 |
Cantidad máxima de iteraciones en el bucle agéntico de herramientas (N−1 turnos de herramientas + 1 respuesta de texto forzada). Rango: 3–10. Los valores más altos permiten solicitudes de varios pasos más complejas, pero consumen más créditos. |
| Tool Iteration Max Tokens | — | Presupuesto de salida por iteración dentro del bucle agéntico de herramientas. Restringe la salida durante los turnos intermedios de llamada a herramientas para controlar el costo. |
| Greeting Char Threshold | 20 |
Umbral de longitud de caracteres por debajo del cual un mensaje de nueva conversación se trata como un saludo. Rango: 5–100. Los saludos reciben el presupuesto más pequeño de Máximo de tokens de saludo. |
| Greeting Max Tokens | 800 |
Cantidad máxima de tokens de salida para los mensajes de saludo de nuevas conversaciones (entrada corta). Rango: 400–2000. |
Consulta y visualización
Topes sobre lo que el agente lee de Salesforce por solicitud y sobre cuánto de eso ve el usuario.
| Configuración | Predeterminado | Propósito |
|---|---|---|
| Max Query Rows | 200 |
Tope sobre la cantidad de filas que el agente recupera por consulta SOQL. Se aplica automáticamente cuando una consulta no tiene cláusula LIMIT; las consultas de agregación no agrupadas quedan exentas. |
| Max Query Result Length | 15000 |
Longitud máxima (caracteres) de un resultado de consulta serializado que se devuelve al agente. Las cargas más grandes se truncan para mantener manejable el contexto del modelo. |
| Max Display Rows | 50 |
Cantidad máxima de filas que se muestran en los resultados de consulta con formato. Con cantidades de filas mayores solo se devuelven los totales, con una nota que explica el tope. |
Búsqueda web
| Configuración | Predeterminado | Propósito |
|---|---|---|
| Búsquedas web máx. | 5 |
Cantidad máxima de búsquedas web que la IA puede realizar por turno de conversación. Controla el presupuesto de búsqueda web del lado del servidor del modelo. |
Funciones de IA para administradores — Presupuestos de tokens de salida
Cada función de administración asistida por IA tiene su propio presupuesto de respuesta. Los presupuestos más grandes producen salidas más detalladas con un mayor costo de créditos.
| Configuración | Predeterminado | Usado por |
|---|---|---|
| Agent Builder Max Output Tokens | 12000 |
Crear un agente con IA — analizador amplio de múltiples superficies, de ahí el presupuesto más grande. |
| Tool Builder Max Output Tokens | 4096 |
El generador con IA del Creador de herramientas al producir definiciones de herramientas de plantilla SOQL, mapeo de archivos o clases Apex. |
| Prompt Generator Max Output Tokens | 2048 |
El Generador de prompts con IA al producir nuevos prompts de agente a partir de descripciones de la intención del usuario. |
| Optimizer Max Output Tokens | 4096 |
Optimizador de prompts y Optimizador de campos de contexto. |
| Debugger Max Output Tokens | 3000 |
Depurador de conversaciones y Depurar con IA en los incidentes. |
| Conflict Detector Max Output Tokens | 1024 |
El análisis con IA del Detector de conflictos de prompts. Detecta conflictos entre los prompts, las herramientas y los campos de contexto del agente. |
Red y reintentos
| Configuración | Predeterminado | Propósito |
|---|---|---|
| Reintentos máximos | 3 |
Cantidad máxima de intentos de reintento de llamadas HTTP para respuestas de la API del modelo con límite de tasa superado (HTTP 429) o sobrecargadas (HTTP 529). No afecta a los reintentos de ejecución de acciones programadas. |
Notificaciones
| Configuración | Predeterminado | Propósito |
|---|---|---|
| Notification From Email | (en blanco) | Dirección de correo que se usa como remitente de los correos de notificación de incidentes. También debe estar configurada como una dirección de correo electrónico para toda la organización en Configuración. Déjalo en blanco para deshabilitar las notificaciones por correo — las notificaciones en la aplicación siguen funcionando. |
| Billing Contact Email | (en blanco) | Dirección de correo para las alertas de umbral de créditos y los resúmenes de uso mensuales. Déjalo en blanco para deshabilitar las notificaciones por correo. |
Gestión de incidentes
| Configuración | Predeterminado | Propósito |
|---|---|---|
| Incident Deduplication Minutes | 0 |
Minutos para suprimir incidentes duplicados que comparten la misma clase, método y tipo de error. Establécelo en 0 (predeterminado) para deshabilitar la deduplicación y registrar cada incidente. Rango: 0–60. |
Archivado y retención
| Configuración | Predeterminado | Propósito |
|---|---|---|
| Días de retención de archivos | 180 |
Días para conservar las conversaciones, los mensajes y las transacciones de crédito antes del archivado. Establécelo en 0 para deshabilitar el archivado. |
Integración con la base de conocimiento
| Configuración | Propósito |
|---|---|
| KB JWT Secret | Secreto compartido HMAC-SHA256 que se usa para la autenticación JWT de la base de conocimiento. Los clientes que se integran con la base de conocimiento alojada de REDA AI lo configuran de modo que coincida con la variable de entorno correspondiente en el host de la base de conocimiento. |
Dónde editar la configuración
Abre la pestaña Administración de REDA AI y selecciona Configuración de la plataforma. Cada configuración es un registro de metadatos personalizados en el paquete. Las modificaciones realizadas a través de la interfaz de administración se implementan mediante la API de metadatos estándar de Salesforce; espera una breve demora entre guardar y que el cambio surta efecto.
La configuración también se puede editar directamente en Configuración › Tipos de metadatos personalizados › REDA AI Setup › Administrar registros, pero la pestaña Administración la presenta con etiquetas descriptivas, validación y agrupación que la lista de registros sin procesar no ofrece.
Lista de actualización para administradores
- Confirme el paquete: Configuración → Paquetes instalados → REDA AI debe mostrar 1.16000. Pruebe en un entorno de pruebas adecuado antes de producción.
- Preserve configuración: respalde metadatos de herramientas, prompts propios, formatos, permisos y acciones pendientes.
- Combine herramientas: Configuración → Tipos de metadatos personalizados → Definiciones de herramientas de REDA AI → Administrar registros. Revise Descripción/Esquema de entrada de send_email y Descripción de schedule_action. Son valores controlados por el suscriptor: combine los cambios sin reemplazar registros personalizados completos. Desde versiones antiguas, revise también create_task, create_event y get_record. Requires Confirmation empaquetado está controlado por el desarrollador.
- Combine prompts: Seed Default Data puede sobrescribir todos los prompts predeterminados compartidos. Preserve los cambios propios; no lo ejecute a ciegas para actualizar una instrucción.
- Revise campos: use la tabla. Los conjuntos empaquetados pueden actualizarse; revise asignaciones, perfiles y conjuntos propios/clonados. Coloque campos en formatos personalizados desde Configuración → Gestor de objetos → objeto → Formatos de página, y conceda solo la seguridad de campos necesaria.
- Revise listas: en Campos y relaciones, compruebe Definición de agente → Nivel de procesamiento: valor API exacto
Economy. Si Tipo de solicitud ya existía en Solicitud asíncrona de IA, compruebeContinuationyBulk Turn. Agregue los valores faltantes, conserve la ortografía API y habilítelos para los tipos de registro aplicables. Las listas restringidas pueden rechazarlos; un campo nuevo incluye sus valores empaquetados. - Revise la programación: en los controles del programador de REDA AI Admin, confirme procesador, propietario y trabajo pendiente. Activarlo puede ejecutar acciones existentes; la actualización no toma esa decisión.
Lista completa de campos y verificación
Preguntas frecuentes
Para toda la organización. Todos los usuarios de REDA AI en tu organización ven los mismos valores de configuración. Las anulaciones por agente se hacen en el registro de Definición de agente, no en la Configuración de la plataforma.
En la siguiente conversación del agente. Las modificaciones se implementan a través de la API de metadatos; las conversaciones en curso terminan con los valores con los que comenzaron.
No — esta configuración contiene valores cifrados administrados por la plataforma. Para rotar o reemplazar una licencia, usa el flujo Activar licencia en la pestaña Administración. La plataforma se encarga por ti de la actualización segura.
Los valores predeterminados conservadores mantienen predecible el consumo de créditos desde el primer día. Una vez que hayas observado el uso real en la vista de Análisis de conversaciones, aumenta los valores que mejoran la calidad del agente y reduce los que no.
Para la mayoría de los agentes, el Presupuesto de tokens del historial y el Máximo de tokens de salida son los que tienen el mayor impacto directo. Los agentes con muchos archivos también son sensibles al Multiplicador de créditos de procesamiento de archivos. Consulta Optimización del uso de créditos.
La plataforma lo ajusta al rango admitido en tiempo de ejecución. Los valores fuera de rango no generan error, pero tampoco surten efecto — se usa el valor más cercano dentro del rango.
Algunas configuraciones admiten 0 o un valor en blanco como “deshabilitado” (Días de retención de archivado, Correo del remitente de notificaciones, Tope diario de créditos externos, Minutos de deduplicación de incidentes). La descripción de cada configuración anterior indica si 0 o en blanco es un valor válido para deshabilitarla.
Próximos pasos
Lee Configuración de la plataforma para ver el recorrido por el panel de administración, o Optimización del uso de créditos para saber qué configuración ajustar según el costo.