Agregar campos de contexto
Cómo agregar un campo de contexto
-
Abre la Definición de agente
Ve a la aplicación REDA AI y abre la Definición de agente que quieres configurar.
-
Ubica la lista relacionada Campos de contexto
Desplázate hacia abajo hasta la lista relacionada "Campos de contexto", que muestra los campos configurados actualmente.
-
Haz clic en "Nuevo campo de contexto"
Haz clic en el botón "Nuevo" para crear un nuevo registro de campo de contexto.
-
Selecciona el nombre de API del objeto
Ingresa el tipo de objeto de Salesforce (por ejemplo, "Oportunidad", "Account", "Contact"). Este es el nombre de API, no la etiqueta.
-
Ingresa los nombres de API de los campos
Ingresa todos los campos que quieres que cargue esta configuración, como una lista separada por comas de nombres de API — por ejemplo
StageName, Amount, CloseDate. Un solo registro de configuración lleva toda la lista; no creas un registro por campo. Los nombres de API los encuentras en Configuración → Administrador de objetos → Campos. -
Establece Max Fields (opcional)
Limita cuántos campos puede aportar esta configuración. El valor predeterminado es 10: súbelo si tu lista es más larga, y recuerda que cada campo cuesta tokens en cada turno.
-
Deja Include Related Names activado (recomendado)
Activado de forma predeterminada. Los campos de búsqueda aportan entonces el nombre del registro relacionado en lugar de su Id, así el agente lee «Acme Properties» en vez de una clave de 18 caracteres.
-
Añade una Context Description (opcional)
Texto libre que indica al agente qué representa este contexto de registro y cómo usarlo — útil cuando los nombres de los campos por sí solos no transmiten el significado de negocio.
-
Define el orden de clasificación (opcional)
Controla el orden en que se aplican las configuraciones cuando coincide más de una. Los números más bajos van primero; el valor predeterminado del paquete es 100.
-
Restricción por tipo de registro (opcional)
Si este campo solo debe cargarse para un tipo de registro específico, selecciona el tipo de registro. Déjalo en blanco para todos los tipos de registro.
-
Guarda el campo de contexto
Haz clic en Guardar. El campo ya está configurado para este agente.
Cómo encontrar los nombres de API de campos y objetos
Los campos de contexto requieren nombres de API, no etiquetas. Para encontrarlos:
- Ve a Configuración → Administrador de objetos
- Ubica el objeto (por ejemplo, "Oportunidad")
- Haz clic en "Campos y relaciones"
- Ubica el campo que quieres (por ejemplo, "Stage")
- Haz clic en el campo para abrir sus detalles
- Busca "Nombre de campo" o "Nombre de API": esto es lo que ingresas en los campos de contexto
- Ejemplo: la etiqueta "Stage" tiene el nombre de API "StageName"
Nombres de API comunes frente a sus etiquetas:
| Objeto | Etiqueta | Nombre de API |
|---|---|---|
| Oportunidad | Etapa | StageName |
| Fecha de cierre | CloseDate | |
| Ingresos esperados | ExpectedRevenue | |
| Cuenta | Nombre de la cuenta | Name |
| Ingresos anuales | AnnualRevenue | |
| Número de empleados | NumberOfEmployees | |
| Caso | Estado | Status |
| Prioridad | Priority | |
| Descripción | Description |
Campos de configuración del campo de contexto
| Campo | ¿Obligatorio? | Descripción |
|---|---|---|
| Definición de agente | No (opcional) | A qué agente se aplica este campo de contexto. Déjalo en blanco para campos de contexto universales. |
| Object API Name | Sí | El objeto de Salesforce (por ejemplo, "Oportunidad", "Account"). Usa el nombre de API, no la etiqueta. |
| Nombres de API de campo | Sí | El campo específico (por ejemplo, "StageName", "Amount"). Usa el nombre de API, no la etiqueta. |
| Campos Máximos | No | Limita cuántos campos aporta esta configuración. Predeterminado: 10. |
| Incluir nombres relacionados | No | Activado de forma predeterminada: los campos de búsqueda aportan el nombre del registro relacionado en lugar de su Id. |
| Descripción del contexto | No | Texto libre que explica al agente qué representa este contexto de registro y cómo usarlo. |
| Orden de clasificación | No | Número que controla el orden en que los campos se presentan a la IA. Los números más bajos van primero. Valor predeterminado: 0. |
| Record Type Developer Name | No | Opcionalmente, limita este campo de contexto a un tipo de registro específico. Déjalo en blanco para aplicarlo a todos los tipos de registro. |
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.
Campos de contexto universales
Para crear un campo de contexto que se aplique a TODOS los agentes (universal):
- Deja en blanco la búsqueda de Definición de agente (no selecciones ningún agente)
- Completa el nombre de API del objeto y los nombres de API de los campos como de costumbre
- Guarda
Este campo de contexto ahora se aplica a todos los agentes para ese tipo de objeto, a menos que lo anulen campos de contexto específicos de un agente (que tienen mayor prioridad).
Probar los campos de contexto
Después de agregar un campo de contexto:
-
Abre un registro en Salesforce
Abre un registro del tipo de objeto que configuraste (por ejemplo, una oportunidad si agregaste campos de contexto para Oportunidad).
-
Activa el chat del agente
Abre el widget de chat de REDA AI en la página del registro.
-
Haz una pregunta sobre el registro
Pregunta algo como "¿En qué etapa está esta oportunidad?" o "Cuéntame sobre esta operación".
-
Verifica que los campos de contexto aparezcan en la respuesta
La IA debería mencionar los valores de los campos que definiste como campos de contexto. Si lo hace, los campos de contexto están funcionando.
-
Revisa los registros (opcional)
Si tienes acceso a los registros de conversación o a información de depuración, verifica que los datos del campo de contexto se hayan incluido en el contexto de la IA.
Prácticas recomendadas para los campos de contexto
Agrega de 3 a 5 campos de contexto al principio y pruébalos. Monitorea el uso de tokens y ajusta. Agrega más campos solo si la IA los necesita y los tokens se mantienen dentro del presupuesto.
Explica el contexto, no los nombres de los campos: el agente lee directamente los nombres de API, así que usa Context Description para transmitir qué representa el registro y cómo usarlo (por ejemplo, «Este es un contrato de arrendamiento activo; Amount es la renta mensual, no el total del contrato»). Eso aporta mucho más significado que renombrar campos individuales.
Ordena los campos dentro de la lista: los campos se presentan al agente en el orden en que los escribes en Field API Names, así que pon primero los más importantes. El orden de clasificación se aplica entre registros de configuración completos, no entre los campos de uno solo.
Aprovecha las restricciones por tipo de registro: si tienes distintos tipos de registro con campos diferentes, usa las restricciones por tipo de registro para adaptar los campos de contexto a cada tipo.
Monitorea el uso de tokens: cada campo de contexto agrega tokens. Después de agregar campos de contexto, monitorea el consumo de tus créditos y ajusta si los costos aumentan de forma inesperada.
Eliminar campos de contexto
Para dejar de usar un campo de contexto:
- Abre el registro del campo de contexto
- Haz clic en el botón Eliminar
- Confirma la eliminación
El campo se elimina de inmediato del contexto del agente. La IA ya no tiene acceso a ese campo en las páginas de registro.
Conjuntos comunes de campos de contexto
- Orden 1: AccountName (campo relacionado de la búsqueda de cuenta)
- Orden 2: StageName (etapa actual de la operación)
- Orden 3: Amount (valor de la operación)
- Orden 4: CloseDate (cierre previsto)
- Orden 5: Probability (confianza del pronóstico)
- Orden 1: CaseNumber (referencia)
- Orden 2: Status (abierto/cerrado)
- Orden 3: Priority (urgencia)
- Orden 4: Description (resumen del problema)
- Orden 5: CreatedDate (cuándo se reportó)
- Orden 1: Name (nombre de la cuenta)
- Orden 2: Industry (tipo de industria)
- Orden 3: AnnualRevenue (indicador del tamaño de la empresa)
- Orden 4: BillingCity (ubicación)
Preguntas frecuentes
Sí. Cualquier campo accesible mediante la API de Salesforce se puede agregar como campo de contexto. Los campos de fórmula y de resumen (roll-up) están incluidos: solo ingresa el nombre de API del campo exactamente como aparece en el Administrador de objetos.
Si un campo está vacío en un registro, la IA lo ve como vacío. La IA maneja los datos faltantes de forma correcta: no interrumpe la conversación. Los campos opcionales pueden incluirse sin problema.
El consumo de tokens aumenta cuantos más campos haya. Una buena pauta: de 5 a 10 campos por objeto. Usa el Optimizador de campos de contexto para identificar los campos más valiosos y eliminar los que se usan poco.
No. Los campos de contexto solo se cargan en las páginas de detalle de un registro. En las vistas de lista o en las páginas de inicio, la IA no tiene el contexto de un registro específico, por lo que los campos de contexto no se cargan.
Consideraciones de ejecución
La plataforma aplica dos mecanismos de seguridad al cargar el contexto en tiempo de ejecución que debes conocer al configurar los campos de contexto:
- Manejo de relaciones polimórficas. Los campos de búsqueda con varios objetos de destino posibles (por ejemplo,
Task.WhoId,Task.WhatId) incluyen el Id de la búsqueda en el contexto, pero omiten la expansión automática del Nombre que sí obtienen las búsquedas de un solo destino. Consulta Relaciones polimórficas. - Modo estricto frente a modo degradado. De forma predeterminada, si algún campo de contexto configurado se vuelve inaccesible (eliminado, renombrado o bloqueado por la seguridad a nivel de campo (FLS) para el usuario en ejecución), la ejecución del agente se cancela. La marca a nivel de agente Permitir contexto de registro degradado (Allow Degraded Record Context) cambia esto a un comportamiento tolerante a fallos: la plataforma registra una advertencia y continúa con los campos que sí pudo cargar. Elige el modo estricto para agentes internos que necesitan el contexto completo; elige el modo degradado para agentes de cara al cliente o impulsados por API que deban tolerar sin problemas los campos faltantes.
Próximos pasos
Usa el Optimizador de campos de contexto para obtener recomendaciones impulsadas por IA, descubre cómo el motor de ejecución maneja las relaciones polimórficas o explora las sugerencias de contexto para botones de acción rápida.