Optimizador de campos de contexto
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é configura el Optimizador
Cada registro de campo de contexto en REDA AI controla cómo un agente específico lee un objeto específico. El Optimizador recomienda valores para cuatro campos de ese registro:
| Campo | Propósito |
|---|---|
| Nombres de API de campo | Lista separada por comas de los campos que el agente verá para este objeto, en orden de prioridad. |
| Campos Máximos | Límite estricto (1–25) sobre cuántos campos se cargan en tiempo de ejecución — útil cuando un objeto tiene cientos de campos y solo unos pocos son relevantes. |
| Incluir nombres relacionados | Cuando está activado, los campos Name de las relaciones de búsqueda se incluyen automáticamente junto con sus campos Id, de modo que el agente ve “Propietario: Jane Smith” en lugar de solo un Id. |
| Descripción del contexto | Descripción de texto libre sobre para qué sirve este contexto. Ayuda al modelo a entender qué tipo de objeto está mirando y qué hacer con él. |
Consulta Agregar campos de contexto para conocer el ciclo de vida completo de un registro de campo de contexto.
Cómo funciona el Optimizador
-
Abre el registro
El Optimizador se inicia desde cualquier registro de campo de contexto — por lo general, justo después de crear uno nuevo para un nuevo emparejamiento agente/objeto.
-
Agrega una instrucción
Una instrucción breve opcional te permite orientar al optimizador con indicaciones específicas de tu organización — por ejemplo, centrarse en operaciones en lugar de finanzas, o preferir menos campos para mantener bajos los créditos. El cuadro admite hasta 5000 caracteres, pero solo los primeros 1000 llegan al modelo: mantén la instrucción breve y pon primero lo más importante.
-
La plataforma compone la solicitud
La plataforma envía al modelo una solicitud estructurada que contiene la definición del agente, los prompts personalizados del agente, las herramientas asignadas al agente, el canal, el esquema del objeto de destino y la configuración actual del campo de contexto.
-
Llegan las recomendaciones
El modelo devuelve una lista recomendada de Field API Names, un límite de Max Fields, un indicador de Include Related Names, una Context Description y un breve resumen de por qué esas opciones se ajustan al agente.
-
Revisa y guarda
Una comparación lado a lado muestra el valor actual junto a la recomendación para cada uno de los cuatro campos. Acepta el conjunto completo, acepta campos individuales o edita antes de guardar.
Qué entra en la recomendación
El Optimizador no hace sugerencias a ciegas basándose únicamente en el esquema del objeto. La solicitud al modelo incluye:
- La persona, el nombre visible y el canal del agente
- Los prompts personalizados del agente (truncados a una longitud razonable)
- Las herramientas asignadas al agente (hasta un pequeño límite de las más relevantes)
- Los metadatos de los campos del objeto de destino — tipos, etiquetas, listas de selección, relaciones
- Los valores actuales del registro de campo de contexto
- Indicaciones específicas del canal — un agente de canal interno recibe recomendaciones distintas de las de un widget de cara al cliente
El resultado son recomendaciones conscientes del agente: un mismo objeto podría recibir una lista de campos distinta para un agente orientado a ventas que para uno orientado a servicio, incluso en la misma organización.
La vista de comparación
Después de la ejecución, la interfaz muestra una tabla de comparación de cuatro filas — una fila por cada campo que el Optimizador puede cambiar:
| Campo | Actual | Recomendación |
|---|---|---|
| Context Description | … | … |
| Field API Names | … | … |
| Max Fields | … | … |
| Include Related Names | … | … |
Encima de la tabla, un breve resumen del modelo explica el razonamiento — qué priorizó la recomendación, qué relegó y por qué. Léelo antes de guardar.
Costo en créditos y tiempo
Ejecutar el Optimizador es una sola llamada al modelo. El costo en créditos crece con el tamaño de la entrada (principalmente los prompts del agente y el esquema del objeto de destino) y con el tamaño de la salida. La plataforma muestra los créditos realmente consumidos después de la ejecución.
Con IA incluida, una llamada que agota el tiempo puede generar el cargo documentado de 20 créditos. Con Traiga su propia IA, REDA no descuenta una asignación de créditos; la facturación depende del proveedor. Revise el uso registrado y el error antes de reintentar. Un tiempo de espera agotado no identifica por sí solo la causa.
Consulta Optimización del uso de créditos para conocer el modelo de costos más amplio.
Un registro de campo de contexto a la vez
Cada ejecución del Optimizador se limita a un solo registro de campo de contexto — un agente, un objeto. Para optimizar un agente que lee varios objetos, ejecuta el Optimizador una vez por cada registro de campo de contexto de ese agente. Puedes hacerlo en cualquier orden; las recomendaciones de un registro no dependen de las de los demás.
Cuándo ejecutarlo
- Justo después de crear un nuevo registro de campo de contexto. El Optimizador convierte un registro en blanco en una configuración inicial sensata con un solo clic.
- Después de editar el agente de forma significativa. Los cambios en la persona, las reescrituras de prompts o las nuevas herramientas modifican qué contexto necesita realmente el agente.
- Después de cambios en el esquema. Cuando se agregan campos nuevos a un objeto, el Optimizador puede sugerir incluirlos.
- Al ajustar costos. Volver a ejecutar el Optimizador con una instrucción explícita como “reduce a la mitad la cantidad de campos” produce una configuración más ligera.
Qué no hace el Optimizador
- No cambia qué registros de campo de contexto existen. El conjunto de emparejamientos (agente, objeto) es tu decisión; el Optimizador solo edita los cuatro campos configurables de un registro que ya elegiste optimizar.
- No aplica la seguridad a nivel de campo (FLS). El Optimizador recomienda campos que resultan útiles para el propósito del agente. En tiempo de ejecución, la FLS sigue aplicándose — los usuarios ven solo los campos que tienen permitido leer.
- No se aplica automáticamente. Las recomendaciones son orientativas. No cambia nada hasta que haces clic en Guardar en la vista de comparación.
Prácticas recomendadas
Haz que la persona sea específica antes de optimizar. Las recomendaciones del Optimizador son tan enfocadas como la definición del agente que lee. Una persona vaga produce listas de campos genéricas. Afina primero la persona; luego optimiza.
Usa el cuadro de instrucciones para dar contexto de la organización. Una nota breve como “excluye los campos de uso interno” o “mantén menos de 12 campos por costo” cambia la recomendación de forma significativa.
Lee el resumen, no solo la tabla. El resumen explica por qué se eligieron o descartaron los campos. Ese razonamiento a menudo revela aspectos que deberías cambiar en el agente mismo, no solo en el contexto.
Vuelve a ejecutarlo con una instrucción refinada tras observar conversaciones reales. El cuadro de instrucciones opcional orienta la recomendación; una segunda ejecución con indicaciones más precisas produce recomendaciones más precisas que una primera ejecución sin ninguna indicación.
Combínalo con el Depurador de conversaciones. Después de aplicar una recomendación, ejecuta una conversación real y usa el Depurador para ver qué campos usó realmente el agente. Los campos que ignoró son candidatos para eliminar la próxima vez.
Preguntas frecuentes
No. Solo edita los cuatro campos configurables de un registro de campo de contexto existente. Para optimizar un nuevo emparejamiento (agente, objeto), primero crea el registro de campo de contexto y luego ejecuta el Optimizador.
Cada ejecución se limita a un solo registro. Para un agente con varios registros de campo de contexto, ejecuta el Optimizador en cada uno por turnos — las ejecuciones son independientes y se pueden hacer en cualquier orden.
La seguridad a nivel de campo se aplica en tiempo de ejecución, cuando el agente realmente lee el contexto. El Optimizador recomienda campos que resultan útiles para el propósito del agente; no verifica el perfil de FLS de cada usuario. Dos usuarios que ejecuten el mismo agente verán solo los campos recomendados que cada uno tenga permitido leer.
Sí. La vista de comparación muestra la recomendación junto al valor actual. Puedes aceptar la recomendación tal cual, editar cualquiera de los cuatro campos u omitir la optimización por completo.
El Optimizador puede incluir campos polimórficos (como WhoId o WhatId de Task) en la lista de campos, pero la expansión automática de nombres en tiempo de ejecución se limita a las búsquedas de un solo destino. Consulta Relaciones polimórficas para conocer el comportamiento en tiempo de ejecución y el ajuste Allow Degraded Record Context.
Por lo general, unos pocos segundos. Las organizaciones grandes con muchos campos en el objeto de destino tardan un poco más porque el esquema que se envía al modelo es más grande.
El registro de campo de contexto es un registro de Salesforce — el historial de campos estándar (cuando está habilitado) te permite ver los valores anteriores, y puedes volver a pegarlos manualmente. No hay un botón automático para “revertir la última optimización”.
Próximos pasos
Lee Relaciones polimórficas para saber cómo el tiempo de ejecución maneja campos como WhoId y WhatId, o Sugerencias de contexto para agregar chips de acción rápida a la interfaz de chat.