Descripción de los campos de contexto
¿Qué son los campos de contexto?
Los campos de contexto son un mecanismo de configuración en REDA AI que carga automáticamente campos específicos de un registro de Salesforce en el contexto de la IA cuando un usuario está en una página de registro. En lugar de que la IA tenga que llamar a una herramienta de consulta para obtener los datos de un registro, los datos se cargan de antemano y están disponibles de inmediato.
Los campos de contexto cumplen dos propósitos:
- Conocimiento — La IA sabe qué registro está viendo el usuario
- Eficiencia — La IA tiene los datos del registro sin realizar llamadas a herramientas (ahorrando tokens y costo)
Por ejemplo, si un usuario abre un registro de oportunidad y tu agente tiene campos de contexto configurados para "Amount", "StageName" y "CloseDate", esos tres campos quedan disponibles automáticamente para la IA. La IA puede hablar de la oportunidad de inmediato sin consultarla primero.
Por qué son importantes los campos de contexto
Sin campos de contexto, cuando un usuario pregunta "¿Cuál es el próximo paso para este negocio?", la IA tendría que:
- Llamar a soql_query o get_record para obtener los datos de la oportunidad
- Esperar el resultado (agrega latencia)
- Luego formular una respuesta
- Costo: tokens adicionales por la llamada a la herramienta y su resultado
Con campos de contexto:
- Los datos de la oportunidad se cargan de antemano en el contexto de la IA
- La IA accede a los datos de inmediato sin llamadas a herramientas
- Respuesta instantánea (sin latencia)
- Costo: sin tokens adicionales — los datos ya están en el contexto
Estructura de los campos de contexto
Los campos de contexto se almacenan como registros de configuración dentro de la configuración de REDA AI. Cada campo de contexto especifica:
| Propiedad | Descripción |
|---|---|
| Definición de agente | A qué agente se aplica esta configuración. Déjalo en blanco para hacerla universal: se aplicará entonces a todos los agentes para ese objeto. |
| Object API Name | El objeto de Salesforce que cubre la configuración (p. ej., Opportunity, Account, Case). |
| Nombres de API de campo | Los campos que se cargarán, como una lista de nombres de API (p. ej., StageName, Amount, CloseDate). Un solo registro de configuración lleva toda la lista: no creas un registro por campo. |
| Campos Máximos | Cuántos campos puede aportar esta configuración. Predeterminado: 10. |
| Incluir nombres relacionados | Cuando está activado (el valor predeterminado), los campos de búsqueda aportan el nombre del registro relacionado en lugar de su Id: así el agente lee «Acme Properties» en vez de una clave de 18 caracteres. |
| Descripción del contexto | Texto libre opcional que explica al agente qué representa este contexto de registro y cómo usarlo. |
| Record Type Developer Name | Limita opcionalmente la configuración a un tipo de registro. Una configuración específica de tipo de registro tiene prioridad sobre una general para el mismo agente. |
| Orden de clasificación | Orden en el que se aplican las configuraciones. Los números más bajos primero; predeterminado 100. |
| Is Active | Solo se cargan las configuraciones activas. Activado de forma predeterminada. |
Tres reglas que las etiquetas de los campos no te cuentan.
- Max Fields se acota a 1–25 en tiempo de ejecución. El valor predeterminado es 10. Si introduces 40, el agente recibe 25 igualmente; si introduces 0, recibe 1. El valor no se rechaza al guardar, así que una configuración que pide 40 parece funcionar mientras entrega 25 en silencio.
- Sort Order es el último criterio de desempate, no la primera regla. Lo específico del agente gana a lo universal, y lo acotado por tipo de registro gana a lo no acotado, antes de que Sort Order se tenga siquiera en cuenta. Solo ordena configuraciones que, por lo demás, están empatadas. Una configuración universal con Sort Order 1 sigue perdiendo frente a una específica del agente con Sort Order 100.
- Record Type Developer Name es el DeveloperName, no la etiqueta. Si el tipo de registro aparece como «Commercial Lease» en Configuración, el valor aquí será probablemente
Commercial_Lease. Una etiqueta escrita por error simplemente nunca coincide, y la configuración nunca llega a activarse.
Como máximo se consideran 50 configuraciones para un objeto en un mismo turno. Está muy por encima de cualquier montaje razonable, pero es el techo.
Dónde se usan los campos de contexto
Los campos de contexto se cargan solo en las páginas de registro. En concreto:
- Página de registro de oportunidad — Se cargan los campos de contexto del objeto Oportunidad
- Página de registro de cuenta — Se cargan los campos de contexto del objeto Account
- Página de registro de caso — Se cargan los campos de contexto del objeto Caso
Los campos de contexto NO se cargan en:
- Páginas de inicio
- Vistas de lista
- Páginas de informes
- Implementaciones del widget externo
Esto es intencional: los campos de contexto sirven para agregar datos específicos de un registro cuando el usuario está enfocado en un registro en particular.
Jerarquía de prioridad
Los campos de contexto siguen una jerarquía de prioridad para determinar qué campos se cargan:
- Agente + tipo de registro — Campos de contexto vinculados al agente específico Y a un tipo de registro específico (máxima prioridad)
- Agente + cualquier tipo de registro — Campos de contexto vinculados al agente sin restricción de tipo de registro
- Universal + tipo de registro — Campos de contexto universales (sin agente) con una restricción de tipo de registro específico
- Universal + cualquier tipo de registro — Campos de contexto universales sin restricciones (prioridad más baja)
Si un campo de contexto se define en varios niveles de prioridad, se usa el de mayor prioridad. Esto permite patrones de herencia en los que los campos universales se aplican a todos los agentes, a menos que los reemplacen campos específicos de un agente.
Se aplica la seguridad a nivel de campo
REDA AI respeta la seguridad a nivel de campo (FLS) de Salesforce. Si un usuario no puede leer un campo en Salesforce, ese campo no se incluye en el contexto, incluso si está configurado como campo de contexto. Esto garantiza que:
- Los campos sensibles no se expongan a usuarios sin permiso
- Distintos usuarios puedan ver distintos datos de contexto según sus permisos de FLS
- No haya brechas de seguridad a través de la IA
Por ejemplo, si tu agente tiene "Salary" como campo de contexto para los objetos Contact, pero el perfil del usuario no tiene acceso de lectura al campo Salary, ese usuario no verá los datos de salario en el contexto de la IA.
Costo en tokens de los campos de contexto
Más campos de contexto = más tokens por interacción. Cada campo incluido en el contexto consume tokens. Esto afecta directamente el costo en créditos. Por lo tanto:
- Incluye solo los 5 a 10 campos más relevantes por objeto
- Usa el Optimizador de campos de contexto para obtener recomendaciones
- Elimina los campos que el agente rara vez consulta
- Equilibra la amplitud del contexto con la eficiencia en el costo
Como regla general, cada campo de contexto adicional agrega proporcionalmente más tokens a cada interacción, así que reducir tu lista únicamente a los campos que el agente realmente consulta puede disminuir los costos de forma significativa con el tiempo.
Campos de contexto universales
Un campo de contexto con la Definición de agente en blanco es un campo de contexto "universal": se aplica a TODOS los agentes de la organización para ese tipo de objeto. Esto es útil para:
- Estándares compartidos — Campos a los que todos los agentes deberían tener acceso (por ejemplo, "Name", "CreatedDate")
- Consistencia — Asegurar que todos los agentes partan de un conjunto básico de campos de contexto
- Eficiencia — Actualizar el campo una sola vez en lugar de actualizar varias copias específicas de cada agente
Los campos de contexto específicos de un agente pueden reemplazar a los universales mediante la jerarquía de prioridad.
Patrones comunes de campos de contexto
- AccountName (relacionado con Account)
- StageName (estado de la oportunidad)
- Amount (tamaño del negocio)
- CloseDate (cierre previsto)
- Probability (confianza del pronóstico)
- CaseNumber (número de referencia)
- Status (abierto/cerrado)
- Priority (urgencia)
- Description (resumen del problema)
- ContactName (contacto del cliente)
- AccountName
- Industry
- AnnualRevenue
- NumberOfEmployees
Configurar instrucciones reutilizables
Los Prompts exclusivos permiten asignar instrucciones reutilizables a agentes seleccionados. Revise Prompt exclusivo y Resumen en Prompt personalizado, y Definición de agente, Prompt personalizado, Activo y Modo de carga en la asignación. El modo Bajo demanda requiere la herramienta de prompts de contexto en el agente. Los corchetes de tipo de registro comparten reglas de alcance, también en las vistas previas. El orden de prompts y herramientas es determinista; la vista previa admite un ID de registro. Las instrucciones de idioma siguen el mensaje en canales API/externos; los marcadores de usuario solo se aplican en los contextos previstos. Preserve los prompts propios al combinar los valores actuales.
Preguntas frecuentes
Empieza con los 5 a 10 campos que tu agente consulta con mayor frecuencia en las conversaciones. Usa el Optimizador de campos de contexto para obtener recomendaciones basadas en IA según el propósito de tu agente y el esquema de Salesforce.
Sí, puedes agregar cualquier campo que la API de Salesforce exponga. Sin embargo, los campos de relación pueden consumir más tokens que los campos simples de texto o número. Úsalos con cuidado y prueba el impacto en el consumo de tokens.
Los cambios en los campos de contexto se aplican de inmediato. La próxima vez que el agente se cargue en una página de registro, el nuevo campo de contexto se incluye (sujeto a la FLS y a las prioridades).
Si un campo de contexto no tiene valor para un registro en particular, la IA ve el campo como vacío o no proporcionado. La IA maneja los datos faltantes con naturalidad y puede hacer preguntas de seguimiento o continuar sin esa información.
Próximos pasos
Aprende a agregar campos de contexto a tus agentes o usa el Optimizador de campos de contexto para obtener recomendaciones basadas en IA.