Vista previa de ejecució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.

Una vista con los ojos del agente La Vista previa de ejecución del agente te muestra exactamente qué cargará un agente en su próxima conversación — los prompts que enmarcarán el modelo, las herramientas y acciones que verá, los chips de sugerencias que recibirán los usuarios y cualquier conflicto de configuración que debas resolver primero. Usa el mismo filtrado que el tiempo de ejecución, así que lo que ves es lo que verá el agente.

Qué muestra la vista previa

La vista previa lee la definición del agente, aplica los mismos filtros de canal y de objeto de contexto que aplica el tiempo de ejecución, y arma cuatro paneles:

Panel	Qué enumera
Prompts	Los prompts personalizados activos — específicos del agente y compartidos — en el orden en que se armarán. Cada prompt muestra su tipo, orden de clasificación, una vista previa del contenido y una estimación de tokens, además de una marca si no cabe dentro del presupuesto de tokens del agente.
Herramientas	Las herramientas de solo lectura que verá el agente (integradas y personalizadas). Filtradas por el ámbito del canal y la relevancia respecto al objeto de contexto, con el nivel y la categoría de cada herramienta.
Acciones	Las herramientas de tipo Acción que verá el agente, con los requisitos de confirmación visibles de un vistazo.
Sugerencias	Los chips de sugerencias que aparecerán en el estado vacío del chat, filtrados para coincidir con el canal y el objeto de contexto.

Una barra de encabezado sobre los paneles muestra la identidad del agente, el canal resuelto (el que se está previsualizando), el objeto de contexto (si lo hay) y el presupuesto de tokens configurado.

Conflictos de configuración y puntuación de estado

Junto con los cuatro paneles, la vista previa ejecuta una pasada determinista de detección de conflictos sobre la configuración del agente. El resultado son dos cosas:

Una puntuación de estado de 0 a 100, que resume qué tan limpia está la configuración.
Una lista de conflictos individuales clasificados como Alto (probablemente rompan el agente) o Advertencia (conviene revisarlos).

La detección de conflictos es gratuita — no llama al modelo. La intención es detectar los errores evidentes — prompts faltantes, herramientas sin asignar que parecen huérfanas, discordancias de canal, instrucciones contradictorias — antes de que aparezcan en conversaciones reales.

Selector de canal y de objeto de contexto

La vista previa acepta dos parámetros que cambian lo que se carga:

Canal

De forma predeterminada usa el canal configurado del agente, pero puedes cambiarlo a cualquier otro canal en el que el agente pueda ejecutarse. La vista previa vuelve a filtrar las herramientas, los prompts y las sugerencias para que coincidan. Úsalo para confirmar que:

Las herramientas que destinaste al canal de API realmente estén acotadas de esa manera
Los prompts que escribiste para un widget externo no se estén filtrando por accidente hacia las conversaciones internas
Los chips de sugerencias que creaste para el canal de Comunidad aparezcan allí y no en el widget externo

Objeto de contexto

De forma predeterminada no hay contexto de registro. Indica el nombre de API de un objeto para previsualizar qué carga el agente cuando se ejecuta en una página de registro de ese objeto. La vista previa aplica la misma puntuación de relevancia respecto al objeto de contexto que usa el tiempo de ejecución, por lo que las herramientas acotadas a objetos específicos entran y salen de la lista visible a medida que cambias el valor.

En los agentes implementados en varios objetos, cambiar el objeto de contexto revela cómo se ve el agente “desde” cada uno — útil cuando una página de registro muestra menos herramientas que otra.

Seguimiento del presupuesto de tokens

El panel de Prompts mantiene un total acumulado de los tokens estimados a medida que te desplazas. Cada prompt se marca en verde o en rojo respecto al presupuesto de tokens configurado del agente; los prompts que hacen que el total acumulado supere el presupuesto quedan visiblemente fuera de los límites.

Esto es una estimación — el tokenizador del tiempo de ejecución es la fuente de verdad — pero suele ser lo bastante precisa para detectar el caso en que un prompt agregado recientemente se pasó del presupuesto. Combínalo con el Depurador de conversaciones después de una ejecución real para confirmarlo.

De solo lectura y económica

No cambia datos mientras navegas. Abrir la vista previa solo lee datos (sin DML, el término de Salesforce para insertar, actualizar o eliminar registros). La única excepción deliberada es Editar carga (Edit Loadout): desde la vista previa, un administrador puede excluir herramientas, prompts o chips de sugerencia específicos de la carga de este agente, y al guardar esas exclusiones se escriben en el registro de Definición de agente en una sola actualización atómica — necesitas permiso de edición sobre el agente para usarla.
Sin llamada al modelo. La vista previa no consume créditos. El detector de conflictos es Apex puramente determinista.
Se ejecuta como el usuario actual. La vista previa consulta los datos (mediante SOQL, el lenguaje de consulta de Salesforce) usando las reglas de colaboración y la seguridad a nivel de campo (FLS) del usuario que la ejecuta. Si un prompt o una herramienta no es visible para el usuario que la previsualiza, no aparecerá — reflejando lo que ese usuario obtendría realmente en el tiempo de ejecución.

Dónde encontrarla

Abre la vista previa desde cualquier registro de Definición de agente — el componente de vista previa de ejecución está integrado en el formato de administración del agente. También puedes abrirla directamente desde la pestaña de administración de REDA AI.

En qué se diferencia del Depurador de conversaciones

La Vista previa de ejecución muestra lo que el agente cargará en su próxima conversación; el Depurador de conversaciones muestra lo que el agente cargó en una conversación anterior específica, incluidas las llamadas a herramientas y las respuestas reales del modelo.

Usa la Vista previa de ejecución mientras construyes o afinas un agente — antes de que ocurra cualquier conversación.
Usa el Depurador de conversaciones cuando algo salió mal en una conversación real y quieres saber por qué.

Conjunto de recursos por agente (Editar conjunto de recursos)

Algunos agentes necesitan un subconjunto curado de las herramientas, acciones, prompts y sugerencias que ponen a disposición el paquete y tus personalizaciones. Un caso habitual: un agente de portal en el canal de Comunidad que usa herramientas personalizadas “elevadas” (que se ejecutan en modo without sharing) para llegar a datos a los que el usuario del portal no puede acceder directamente. En ese caso, las herramientas estándar en modo de usuario (por ejemplo, create_record, update_record, soql_query) se superponen con las equivalentes elevadas, y quieres que el LLM vea solo una de ellas. Surgen necesidades similares con los prompts (por ejemplo, excluir un prompt de personalidad extenso para un agente con un presupuesto de tokens ajustado) y con los chips de sugerencias (ocultar una sugerencia que no aplica a este agente).

La acción Editar conjunto de recursos de la Vista previa de ejecución se aplica a las cuatro categorías — Herramientas, Acciones, Prompts, Sugerencias — y permite a los administradores excluir elementos específicos de un agente determinado sin tocar los metadatos personalizados incluidos en el paquete ni los registros de prompts personalizados, y sin afectar a ningún otro agente de la organización. Los elementos incluidos por el ISV (universales) y los definidos por el cliente son igualmente excluibles.

Cómo funciona

Las exclusiones se almacenan en el registro de Definición de agente como tres listas separadas — una para las herramientas/acciones excluidas, una para los prompts excluidos y una para las sugerencias excluidas. Las Herramientas y las Acciones comparten la misma lista de exclusión porque, internamente, se administran juntas. En el tiempo de ejecución, REDA AI filtra cada lista antes de armar el prompt de sistema del agente, el catálogo de herramientas y el conjunto de chips de sugerencias — los elementos excluidos nunca llegan al LLM, pero permanecen visibles (atenuados, con una etiqueta Excluido) en la Vista previa de ejecución para que los administradores puedan verlos y volver a incluirlos.

Cómo usar Editar conjunto de recursos

Abre el registro de Definición de agente donde está colocado el componente de Vista previa de ejecución.
Cambia a cualquier pestaña — Prompts, Herramientas, Acciones o Sugerencias. El botón Editar conjunto de recursos aparece en la barra de herramientas en la parte superior de cada pestaña.
Haz clic en Editar conjunto de recursos. Aparece una casilla de verificación junto a cada elemento en las cuatro pestañas.
Desmarca cualquier elemento que quieras excluir para este agente. Los elementos excluidos aparecen atenuados y con una etiqueta Excluido. El resumen en la barra de herramientas se actualiza a medida que avanzas.
Muévete libremente entre las pestañas — tus cambios sin guardar se conservan entre pestañas mientras estás en modo de edición.
Haz clic en Guardar conjunto de recursos para conservar las cuatro listas en una sola transacción, o en Cancelar para descartar tus cambios.

Qué se ve afectado y qué no

Las exclusiones aplican únicamente al agente específico que estás editando. Los demás agentes de la organización — incluido un agente de Comunidad distinto o cualquier agente interno — siguen viendo todos los elementos que normalmente cargarían. Los elementos del paquete recién instalados siempre quedan activos de forma predeterminada en cada agente: los excluyes explícitamente, no los incluyes. Una actualización del paquete que incorpore una herramienta, un prompt o una sugerencia totalmente nuevos no desaparecerá de forma silenciosa para ningún agente.

No edites los campos de exclusión manualmente

Las listas de exclusión están pensadas para mantenerse mediante la acción Editar conjunto de recursos. Editarlas directamente en el registro funciona, pero omite la validación y la normalización (ordenamiento, eliminación de duplicados, recorte de espacios en blanco) que aplica Editar conjunto de recursos. Usa Editar conjunto de recursos en su lugar.

Cuándo excluir un elemento

Reemplazaste una herramienta estándar por una equivalente personalizada — por ejemplo, una create_record_elevated que se ejecuta en without sharing para los usuarios del portal. Excluye la create_record estándar en ese agente para que el LLM no la elija.
El agente nunca debería realizar una clase de acción — por ejemplo, un agente de investigación de solo lectura que nunca debería poder ejecutar delete_record ni update_record.
Un prompt universal no encaja en un agente específico — por ejemplo, un prompt extenso de “medidas de protección de seguridad” que es universal pero redundante para un agente exclusivamente interno que ya tiene reglas más estrictas en su personalidad. Exclúyelo para recuperar su presupuesto de tokens.
Un chip de sugerencia no aplica — por ejemplo, una sugerencia genérica de “Mostrar mis casos abiertos” que es irrelevante para un agente enfocado en ventas. Exclúyela para que los usuarios del portal no vean un chip que el agente no puede responder.
Quieres minimizar el tamaño del contexto del agente — menos elementos = un contexto del LLM más pequeño = menor consumo de créditos por turno. Para los agentes con un propósito acotado, eliminar los elementos que no se usan es una ganancia rápida.
Un elemento está produciendo un comportamiento no deseado — exclúyelo temporalmente mientras investigas y luego vuelve a incluirlo.

Prácticas recomendadas

Ábrela después de cada edición del agente. La vista previa es la forma más económica de verificar que un cambio tuvo el efecto que esperabas — sobre todo cuando estás configurando el ámbito de canal o de objeto de contexto por primera vez.

Recorre todos los canales que admite el agente. Un agente que enumera API e Interno como canales debe previsualizarse en ambos. Las herramientas y los prompts a menudo se ven bien en un canal y mal en otro.

Úsala durante las demostraciones. Mostrar la vista previa a una parte interesada es una forma rápida de comunicar lo que hace un agente sin tener que preparar una conversación en vivo.

Clasifica los conflictos antes de probar. La lista de conflictos de configuración detecta problemas que, de otro modo, malgastarían una conversación real. Resuelve los elementos de nivel Alto y revisa las Advertencias antes de pasar un solo mensaje por el agente.

Trata las estimaciones de tokens como una referencia. Una estimación no es una garantía — para las decisiones de costo en producción, ejecuta una conversación real y consulta los créditos realmente consumidos.

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

No. Es Apex puro — sin llamadas al modelo. Ábrela tantas veces como quieras.

Verifica tres cosas: el canal que estás previsualizando debe estar en la lista de canales de la herramienta; el nombre del agente en la herramienta debe coincidir (o estar en blanco); y el campo Activo debe estar habilitado. Cambiar de canal en la vista previa suele ser la forma más rápida de descubrir qué ámbito la está filtrando.

Las estimaciones de la vista previa son heurísticas basadas en caracteres. El tokenizador del tiempo de ejecución es la fuente de verdad. Las estimaciones son lo bastante precisas para detectar excesos evidentes del presupuesto, pero no coincidirán exactamente con el tiempo de ejecución.

Sí. La vista previa se ejecuta con las reglas de colaboración y la seguridad a nivel de campo del usuario que la ejecuta, por lo que un prompt o una herramienta que un usuario no puede ver no aparecerá en su vista previa. Esto refleja lo que el tiempo de ejecución entregaría realmente a ese usuario.

La puntuación de estado refleja los hallazgos del detector de conflictos. Las puntuaciones más bajas indican más conflictos o de mayor gravedad. Lee la lista de conflictos para conocer los detalles — la puntuación en sí es un resumen, no el diagnóstico.

Sí. Las exclusiones se almacenan en el registro individual de Definición de agente, por lo que solo afectan al agente que editaste. Los demás agentes — incluido un agente de Comunidad distinto o cualquier agente interno — siguen viendo el catálogo completo de herramientas, acciones, prompts y sugerencias. No existe una lista de bloqueo global.

Es intencional. La vista previa enumera todos los elementos (herramienta, acción, prompt, sugerencia) que podrían cargarse para el agente, para que puedas ver qué está excluido y volver a incluirlo más adelante. Los elementos excluidos aparecen atenuados y con una etiqueta Excluido. En el tiempo de ejecución, el LLM nunca los ve — REDA AI los elimina antes de enviar el prompt de sistema y el catálogo de herramientas.

La Vista previa de ejecución se centra en los prompts, las herramientas, las acciones, las sugerencias y los conflictos. Para conocer los detalles de los campos de contexto, consulta Descripción de los campos de contexto y el Optimizador de campos de contexto; para conocer el contexto real que el agente recibió en una conversación anterior, usa el Depurador de conversaciones.

Próximos pasos

Lee Crear un agente con IA para conocer las mejoras asistidas por IA en la configuración de un agente, o vuelve a Configuración del agente para revisar los campos subyacentes del agente que refleja la vista previa.

← Anterior: Invocar REDA AI desde Flujos

Siguiente: Procesamiento asíncrono de agentes →