Configuración del agente
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 IA incluida, seleccione el Processing Tier del agente. Con Traiga su propia IA, elija AI Connection y Model en AI Account, o herede el valor predeterminado de la organización. Los agentes pueden usar diferentes proveedores y modelos compatibles. Los prompts, herramientas, contexto y permisos del canal siguen definiendo su función. Configure la cuenta de IA del agente.
Propiedades principales del agente
| Propiedad | Tipo | Descripción |
|---|---|---|
| Nombre visible | Texto | El nombre que se muestra a los usuarios en la interfaz de chat. Hazlo descriptivo y orientado a la acción (por ejemplo, "Asistente de embudo de ventas" en lugar de "Agente 1"). |
| Canal | Lista de selección | Determina dónde se implementa el agente y cómo se autentica. Opciones: Interno, Widget externo, Comunidad, API. |
| Estado activo | Casilla de verificación | Cuando se desmarca, el agente queda deshabilitado. Los agentes inactivos muestran un mensaje de "no disponible" y no responden. |
| Persona | Área de texto largo (5000) | El prompt de sistema inicial que define el rol, el tono y el propósito del agente. Ejemplo: "Eres un asistente de ventas amigable que ayuda a cerrar negocios...". |
| Prioridad | Número | Cuando varios agentes aparecen en la misma ubicación, se muestra el agente con el número de prioridad más alto. Valor predeterminado del paquete: 50. |
Configuración de mensajes y tokens
| Propiedad | Tipo | Propósito |
|---|---|---|
| Longitud máxima del mensaje | Número | Cantidad máxima de caracteres que un usuario puede enviar en un solo mensaje. Valor predeterminado del paquete: 2000 caracteres. Úsalo para evitar prompts extremadamente largos que consuman tokens. |
| Máximo de mensajes por sesión | Número | Cantidad máxima de mensajes por sesión antes de que la sesión se reinicie y se borre el historial de la conversación. Valor predeterminado del paquete: 50. |
| Tiempo de espera de sesión (minutos) | Número | Cuántos minutos de inactividad deben pasar antes de que expire una sesión. Valor predeterminado: 30 minutos. Se reinicia cada vez que el usuario envía un mensaje. |
| Presupuesto de complejidad inmediata | Número | Limita cuánto del prompt del sistema del agente se ensambla, no cuánto puede usar la IA en un turno. El motor de ensamblado concatena registros de Prompt personalizado por Sort Order hasta agotar el presupuesto, y el texto de la Persona cuenta dentro de él. Valor predeterminado del paquete: 8000. El campo se llama «Prompt Complexity Budget» en el registro; material más antiguo lo llama Token Budget. Bajarlo no abarata cada respuesta: descarta en silencio los prompts que ya no caben. |
| Utilizar la transmisión | Casilla | Desactivada de forma predeterminada. Con ella activada, todas las llamadas de IA de este agente usan streaming, lo que mantiene viva la conexión HTTP a medida que llegan los tokens y evita los tiempos de espera de lectura. Recomendada para agentes que procesan archivos, razonan de forma compleja o generan respuestas largas. Si REDA AI te dice alguna vez que «actives el streaming en el agente para evitar tiempos de espera», se refiere a esta casilla. |
| Iniciar al cargar | Casilla | Desactivada de forma predeterminada. Con ella activada, el componente de chat envía un saludo en cuanto se monta en una página de registro, pidiendo al agente que revise el registro y empiece con ideas, tareas o señales de riesgo, en lugar de esperar a que le pregunten. Es lo que convierte el panel de un cuadro de búsqueda en un asistente proactivo. |
| Ventana de conversación (horas) | Número | Un valor positivo establece la ventana de reanudación automática en horas. En blanco usa el valor de la organización, inicialmente 30 minutos; 0 desactiva la reanudación automática. La conversación debe coincidir con el canal, agente, usuario y contexto de registro exigidos por ese canal. Consulte la sección de continuidad. |
Rendimiento y control de costes
Estas opciones controlan lo que cuesta ejecutar el agente. Todas son opcionales: si dejas una en blanco, el agente sigue usando el valor predeterminado de toda la organización, así que un agente que no toques se comporta exactamente igual que antes. Aparecen en la sección Rendimiento y control de costes del formato de Definición de agente, salvo donde se indique.
| Propiedad | Tipo | Para qué sirve |
|---|---|---|
| Nivel de procesamiento | Lista de selección | Estándar, Eficiente o Económico. En blanco se comporta como Estándar.
|
| Consentimiento del nivel Económico | Casilla | Obligatorio para usar Económico. Revise las condiciones de tratamiento de datos mostradas y marque esta casilla solo si su organización las acepta. Sin consentimiento, las solicitudes Económico se rechazan; REDA AI no cambia silenciosamente de nivel. |
| Almacenamiento en caché mejorado | Casilla de verificación | Mantiene el contexto estable del agente (sus instrucciones y su lista de herramientas) activo durante una hora en lugar de cinco minutos, para que una conversación retomada tras una pausa no se cobre como si acabara de empezar. Actívalo en agentes con los que la gente conversa; déjalo desactivado en agentes autónomos que terminan de una vez. Nunca puede costarte más: REDA asume el mayor coste de almacenamiento. |
| Tokens máx. de salida | Número | Limita cuánto puede durar una respuesta de este agente. En blanco usa el valor de la organización. No lo confundas con Presupuesto de tokens, más arriba, que limita lo que se envía a la IA; este limita lo que vuelve. |
| Presupuesto de tokens de historial | Número | Cuánta conversación anterior se reenvía en cada turno para que el agente recuerde lo dicho. En blanco usa el valor de la organización. Suele ser la mayor palanca de coste en un agente conversacional de alto volumen, pero redúcelo por pasos: si lo bajas demasiado, el agente empieza a olvidar el contexto anterior. |
| Búsquedas web máx. | Número | Cuántas búsquedas web puede hacer este agente por turno. En blanco usa el valor de la organización. Solo tiene sentido cuando Permitir búsqueda web está activado; cada búsqueda cuesta créditos además del cargo habitual por tokens. |
| Profundidad máx. de continuación | Número | Hasta dónde puede seguir trabajando el agente entre turnos en los canales externo y de comunidad. En blanco usa el valor de la organización; 0 desactiva la continuación por completo. Está en la sección Controles externos, porque solo aplica a esos canales. |
| Contexto de ejecución | Lista de selección | Usuario (predeterminado) o Sistema. Solo aplica a agentes del canal API y se ignora en el resto. Sistema permite que un agente desatendido omita los permisos de objeto y de campo; no le permite ver registros que antes no pudiera ver. Está en Contexto y persona, justo debajo de Canal. Consulta Acceso a datos y permisos antes de cambiarlo. |
Configuración de herramientas y funciones
| Propiedad | Tipo | Descripción |
|---|---|---|
| Modo de herramientas | Lista de selección | Siempre: carga las herramientas en todas las páginas (alto uso de tokens). Solo páginas de registro: carga las herramientas únicamente en las páginas de registro (ahorra tokens en las páginas de inicio y de listas). |
| Máximo de herramientas | Número | Cuántas herramientas ofrece este agente a la IA por turno (1–100). En blanco equivale a 25. Cada herramienta a la que puede acceder se le describe en cada mensaje, así que una lista larga cuesta créditos en cada turno se usen o no. Redúcelo en un agente que solo necesita unas pocas. |
| Máximo de iteraciones de herramientas | Número | Cuántos pasos puede dar el agente dentro de un mismo turno al encadenar herramientas (3–25). En blanco equivale a 6. Súbelo para trabajo realmente de varios pasos; bájalo para evitar que un agente se quede dando vueltas en una tarea que no puede terminar. Sustituye a la opción de toda la organización con el mismo nombre, que ya no se usa. |
| Razonamiento profundo | Lista de selección | Con qué profundidad razona el agente antes de responder: Desactivado (predeterminado), Bajo, Medio, Alto, Xhigh, Máximo. Los niveles más altos mejoran la precisión en preguntas complejas, a costa de respuestas más lentas y más créditos. Un valor en blanco se trata como Desactivado. Consulta Razonamiento profundo. |
| Permitir solicitudes automatizadas | Casilla de verificación | Cuando se habilita, los Flujos y las automatizaciones de Salesforce pueden invocar este agente mediante programación. Es obligatorio para la integración con Flow. |
| Objetos de contexto predeterminados | Texto | Lista separada por comas de los objetos de Salesforce (por ejemplo, "Cuenta, Oportunidad, Contacto") con los que este agente trabaja principalmente. |
| Permitir búsqueda web | Casilla de verificación | Cuando se habilita, el agente puede buscar en la web información en tiempo real durante las conversaciones. Cada búsqueda web consume una pequeña cantidad de créditos adicionales, más allá del costo base de la conversación. Valor predeterminado: deshabilitado. Consulta Búsqueda web. |
| Permitir carga de archivos | Casilla de verificación | Cuando se habilita, los usuarios pueden cargar archivos (PDF, CSV, imágenes, texto, JSON) en las conversaciones. El agente lee y procesa el contenido del archivo. Valor predeterminado: habilitado. Consulta Carga de archivos. |
| Tipos de archivo admitidos | Texto | Lista separada por comas de las extensiones de archivo que acepta este agente (por ejemplo, "pdf,csv,txt"). Déjalo en blanco para usar el ajuste global Extensiones de archivo permitidas de la Configuración de la plataforma. |
| Ejecutar acciones de archivo automáticamente | Casilla de verificación | Cuando se habilita, el agente realiza las acciones basadas en archivos (por ejemplo, la importación de CSV) de inmediato, sin pedir la confirmación del usuario. Valor predeterminado: deshabilitado. |
Ajustes de colaboración entre agentes
Estos ajustes controlan si este agente puede participar en la delegación entre agentes, es decir, que un agente consulte a otro en mitad de una conversación. Ambos interruptores empiezan desactivados, así que una actualización nunca cambia el comportamiento de un agente existente.
| Propiedad | Tipo | Descripción |
|---|---|---|
| Agente invocable | Casilla de verificación | Permite que otros agentes consulten a este. Desactivado de forma predeterminada. No basta por sí solo: también debe estar activado Permitir solicitudes automatizadas, porque una consulta llega como una solicitud automatizada. Si solo está marcado uno de los dos, el agente que llama recibe un mensaje que indica cuál falta, en lugar de fallar en silencio. |
| Profundidad máxima de llamadas entre agentes | Número | Se define en el agente que pregunta. Cuántos niveles pueden encadenarse las consultas: 1 (el valor predeterminado) significa que puede consultar a un agente, y ese agente no puede consultar a un tercero; 0 significa no consultar nunca. Si se deja vacío, se comporta como 1. Cada nivel añade tiempo de respuesta y créditos, así que auméntalo solo para un caso en el que hayas visto que hace falta. |
Ajustes del widget externo
Estos ajustes se aplican cuando el canal está configurado como "Widget externo" (agente implementado en un sitio web).
| Propiedad | Tipo | Descripción |
|---|---|---|
| Orígenes permitidos | Texto | Lista separada por comas de los dominios de sitio web permitidos (por ejemplo, "https://example.com, https://www.example.com"). Es obligatorio para el widget externo. Evita la incrustación no autorizada. |
| Mensaje de bienvenida externo | Área de texto largo | Mensaje de bienvenida que se muestra cuando se abre el chat del widget externo. Ejemplo: "¡Hola! ¿En qué puedo ayudarte hoy?". |
| Abrir al cargar | Casilla de verificación | Cuando se habilita, la ventana de chat del widget externo se abre automáticamente al cargar la página. Cuando se deshabilita, los usuarios deben hacer clic en un botón para abrir el chat. |
Configuración de apariencia
| Propiedad | Tipo | Descripción |
|---|---|---|
| Nombre del icono | Texto | Nombre del icono de SLDS (Salesforce Lightning Design System) que se muestra junto al nombre del agente. Valor predeterminado del paquete: "standard:bot". Ejemplo: "standard:service_resource". Consulta la documentación de iconos de SLDS. |
| Imagen de mascota | Archivo / Imagen | Imagen de mascota o avatar personalizado opcional para el agente. Se muestra en la interfaz de chat. Recomendado: 200x200 px o más grande. |
Configuración de límite de frecuencia
| Propiedad | Tipo | Descripción |
|---|---|---|
| Límite de frecuencia por hora | Número | Cantidad máxima de interacciones (mensajes) que un solo usuario puede enviar a este agente por hora. Valor predeterminado del paquete: 500. |
| Límite de frecuencia por sesión | Número | Cantidad máxima de interacciones que un solo usuario puede enviar en una sesión. Valor predeterminado del paquete: 10. |
Configuración de administración de datos
| Propiedad | Tipo | Descripción |
|---|---|---|
| Retención de archivado (días) | Número | Cuántos días se conservan las conversaciones de este agente antes de archivarse automáticamente. Si se deja en blanco, se usa el valor predeterminado de la organización: 180 días (configurable en la Configuración de la plataforma). El mínimo por agente es de 60 días. |
| Omitir archivado | Casilla de verificación | Cuando se habilita, las conversaciones con este agente quedan exentas del archivado automático. Úsalo para agentes que manejan datos confidenciales que deben conservarse más tiempo. |
Flujo de trabajo de configuración
- Abre la Definición de agente — Ve al registro de Definición de agente que quieres configurar.
- Revisa los ajustes principales — Asegúrate de que el Nombre visible, el Canal y la Persona sean correctos.
- Establece los límites de rendimiento — Configura la Longitud máxima del mensaje, el Máximo de mensajes por sesión y el Presupuesto de tokens según tu caso de uso.
- Habilita las automatizaciones — Activa Permitir solicitudes automatizadas si planeas invocar el agente desde Flujos.
- Configura los ajustes específicos del canal — Si usas el canal de widget externo, establece los Orígenes permitidos y un mensaje de bienvenida.
- Agrega la apariencia — Si lo deseas, establece un Nombre del icono y una Imagen de mascota para la personalización de marca.
- Establece los límites de frecuencia — Configura los límites de frecuencia si quieres evitar el abuso o el uso excesivo.
- Prueba — Guarda los cambios y prueba el agente en un entorno sandbox.
Consejos para ajustar el rendimiento
El ajuste Presupuesto de tokens afecta directamente al costo. Un presupuesto de tokens más bajo significa interacciones más económicas, pero puede limitar la profundidad de razonamiento de la IA. El valor predeterminado del paquete es de 8000 tokens por turno — redúcelo por pasos si el costo por interacción importa más que el margen, y supervisa que las respuestas no queden cortadas.
Usa Solo páginas de registro para el modo de herramientas — Si tu agente está implementado en una página de registro de Salesforce, configura el Modo de herramientas como "Solo páginas de registro" para evitar cargar las herramientas en las páginas de inicio y las vistas de lista, lo que ahorra tokens y costo.
Establece tiempos de espera de sesión razonables — Un Tiempo de espera de sesión de 30 minutos es estándar para la mayoría de los casos de uso. Los tiempos de espera más cortos ahorran memoria; los más largos preservan el contexto de la conversación.
Usa el Máximo de mensajes por sesión para conversaciones largas — Si notas que las conversaciones se vuelven demasiado largas y consumen muchos tokens, establece un límite de Máximo de mensajes por sesión (por ejemplo, 50) para reiniciar la conversación después de esa cantidad de mensajes.
Configuración específica del canal
Para usuarios de Salesforce. Configura el Modo de herramientas como "Siempre" o "Solo páginas de registro", habilita las herramientas libremente y asigna una persona adaptada a las necesidades de tu equipo.
Para visitantes del sitio web. Establece los Orígenes permitidos, configura un Mensaje de bienvenida externo y sé conservador con las asignaciones de herramientas (solo las herramientas que tengan sentido para usuarios invitados).
Para usuarios del portal. Las herramientas y los campos de contexto están limitados por los permisos del usuario del portal. Configúralo de forma segura para evitar el acceso no deseado a los datos.
Escenarios de configuración habituales
| Escenario | Ajustes recomendados |
|---|---|
| Asistente del equipo de ventas (Interno) | Modo de herramientas: Siempre · Presupuesto de tokens: 2.500 · Solicitudes automatizadas: habilitado · Tiempo de espera de sesión: 45 min |
| Bot de chat para sitio web (Widget externo) | Abrir al cargar: habilitado · Orígenes permitidos: tu-dominio.com · Presupuesto de tokens: 1.500 · Límite de frecuencia por hora: 10 |
| Agente de portal de clientes (Comunidad) | Modo de herramientas: Solo páginas de registro · Presupuesto de tokens: 2.000 · Máximo de mensajes por sesión: 30 · Omitir archivado: deshabilitado |
| Agente de integración por API (API) | Solicitudes automatizadas: habilitado · Presupuesto de tokens: 3.000 · Límite de frecuencia por hora: 100 |
Comprender el cambio de créditos Económico
El uso ordinario del nivel Económico aplica ahora un multiplicador de 0,40 a la tarifa base de créditos. Con los mismos tokens y tarifas, un ejemplo de 100 créditos base consume 40 créditos Económico. Con el multiplicador anterior de 0,10 consumía 10: el débito es cuatro veces el anterior y un 60 % inferior al base. Cambia el consumo, no el precio de suscripción. La extracción previa de archivos se cobra por separado a tarifa completa. Una ruta alternativa del proveedor puede usar otro nivel efectivo; consulte la transacción real y no aplique 0,40 a toda operación mixta. Las transacciones nuevas registran Nivel de procesamiento; las anteriores no se rellenan retroactivamente. Económico exige consentimiento y una licencia/configuración compatible. Sin consentimiento, la solicitud se rechaza; no se procesa silenciosamente en otro nivel.
Revisar la continuidad de conversaciones
Ventana de conversación (horas) vacía utiliza ahora el valor de la organización, inicialmente 30 minutos. Un valor positivo define la ventana del agente; 0 desactiva la reanudación automática. La coincidencia depende del canal: API usa agente y registro; Interno/MCP autenticado usa agente, usuario y contexto de registro pertinente. Comunidad utiliza el ajuste compartido en lugar del tiempo de espera de sesión externa. El chat en inicio, páginas de aplicación y barra de utilidades puede retomar conversaciones válidas. Los identificadores explícitos siguen sujetos al acceso de su ruta. Si dependía de que vacío iniciara una conversación, use 0. También se corrigen permisos empaquetados de continuidad Interna y Comunidad.
Preguntas frecuentes
Si la respuesta de la IA superara el presupuesto de tokens, REDA AI trunca la respuesta o devuelve una respuesta parcial. Configura un presupuesto lo suficientemente alto para tu caso de uso. Supervisa el uso de tokens en los registros y aumenta el valor si las respuestas se cortan de forma recurrente.
Sí, pero cambiar el canal puede afectar las implementaciones existentes. Los agentes internos implementados en una página dejarán de funcionar si cambias al canal de widget externo. Planifica cuidadosamente la elección del canal antes de implementar.
El máximo de mensajes por sesión limita la cantidad de turnos en una conversación. El tiempo de espera de sesión finaliza una sesión si el usuario está inactivo. Ambos reinician el contexto de la conversación; úsalos en conjunto para administrar el presupuesto de tokens y la vigencia de la conversación.
No. Los orígenes permitidos solo se usan para el canal de widget externo. Los agentes internos se autentican mediante la sesión de Salesforce y no necesitan restricciones de origen.
Próximos pasos
Después de configurar los ajustes del agente, aprende a activar y desactivar agentes, o explora la administración de prompts para refinar el comportamiento de tu agente.