Solucionar problemas del Generador de solicitudes

Mi vista previa o prueba falla con un error.

Si hace clic en Vista previa y aparece un error, como Internal Server Error, compruebe estos elementos antes de ponerse en contacto con el Servicio de atención al cliente de Salesforce.

• Confirme que Generador de solicitudes está incluido con su edición y complementos de Salesforce. Las ediciones compatibles aparecen en la parte superior de esta página.
• Confirme que Einstein está activado. Desde Configuración, en el cuadro Búsqueda rápida, introduzca Configuración Einstein y luego seleccione Configuración Einstein. Obtenga más información acerca de la activación Generador de solicitudes.
• Confirme que tiene asignado el conjunto de permisos Gestor de plantillas o Usuario de plantilla de solicitud y que el conjunto de permisos incluye Ejecutar plantillas de solicitud. Obtenga más información acerca de la activación Generador de solicitudes.
• Si verificó Einstein, licencias y permisos y el error continúa, espere unos minutos e inténtelo de nuevo. El problema es a menudo una interrupción temporal del servicio. Compruebe Salesforce Trust antes de crear un caso de asistencia.

Mi plantilla de solicitud funciona en Vista previa pero falla cuando se utiliza en un agente.

Una plantilla de solicitud puede generar una respuesta en Generador de solicitudes y seguir fallando cuando se llama a la misma plantilla desde Agentforce Builder o se ejecuta en una conversación de agente. El agente puede pasar valores de entrada diferentes a los que seleccionó en Vista previa.

• Si la plantilla utiliza un recuperador, confirme que el origen de datos del recuperador está activo y que el recuperador devuelve resultados por sí solo. Obtenga más información acerca de recuperadores individuales.
• Si fundamenta la plantilla con una Biblioteca de datos Agentforce o archivos no estructurados, confirme que el indexado está completo. Obtenga más información acerca de la solución de problemas de la Biblioteca de datos Agentforce.
• Realice una vista previa de la plantilla de nuevo con los mismos valores de entrada que el agente pasa en tiempo de ejecución. Obtenga más información acerca de la vista previa de una respuesta generada.

Mi respuesta estructurada tiene campos que faltan o están en blanco cuando Einstein Trust Layer está activada.

Cuando la Capa Einstein Trust está activada y utiliza Salidas estructuradas para generar una respuesta JSON, algunos campos pueden volver vacíos o null. La Capa Einstein Trust enmascara información personal, como nombres o direcciones de correo electrónico, antes de enviar la solicitud al modelo de IA. Si un campo no se restaura después de devolver la respuesta, puede aparecer en blanco.

En la sección Respuesta, abra Detalles de enmascaramiento y anote qué campos se enmascararon y si contienen información de identificación personal. La información personal enmascarada es la causa más común. Obtenga más información acerca de Salidas estructuradas. Para revisar la configuración de enmascaramiento, consulte Configuración Einstein Trust Layer.

Mi plantilla de solicitud no utiliza el acceso de datos del usuario que ejecuta.

Si una plantilla devuelve datos que un usuario no debe ver, u omite datos que debe ver, agregue una acción de Apex o flujo que filtre registros antes de que esos datos se fundamenten en la plantilla de solicitud. Obtenga más información acerca de agregar una acción.

Mi archivo es demasiado grande para utilizarlo como base.

Los archivos utilizados para la fundamentación están limitados a 15 MB por solicitud, y la mayoría de los modelos admiten al menos un tipo de archivo. Si su archivo supera el límite, divídalo en archivos más pequeños o resuma el contenido antes de cargarlo como un origen de fundamentación. Los archivos no compatibles se excluyen de la solicitud y se enumeran en el panel Resolución. Más información acerca de los límites del Generador de solicitudes. Obtenga más información acerca de la fundamentación con entradas de archivo.

Falta el campo Objeto.

Si ve el campo Objeto depende del tipo de plantilla de solicitud.

• Para una plantilla de generación de campos, seleccione un Objeto y un Campo de objeto cuando cree la plantilla, antes de abrir el espacio de trabajo. Obtenga más información acerca de la creación de una plantilla de solicitud de generación de campos.
• Para una plantilla Flex, los recursos de objeto son opcionales. Agréguelos más adelante desde la ficha Recursos. El campo Objeto no aparece en la pantalla de configuración inicial. Obtenga más información acerca de la creación de una plantilla de solicitud Flex.

Si esperaba ver Objeto inmediatamente y no lo hace, confirme qué tipo de plantilla está creando.

Obtengo resultados incoherentes de la misma plantilla de solicitud.

Las plantillas de solicitud utilizan un modelo de idioma grande (LLM). Los modelos de IA no siempre devuelven la misma respuesta para las mismas entradas, de modo que los resultados pueden variar entre ejecuciones. Las plantillas que utilizan recuperadores para tareas de tipo clasificación también pueden no analizar una respuesta como JSON válido.

• Realice una vista previa de las mismas entradas más de una vez para ver si el problema es intermitente. Obtenga más información acerca de la vista previa de una respuesta generada.
• Haga que las instrucciones sean específicas y agregue una gestión explícita para valores vacíos o inesperados. Obtenga más información acerca del perfeccionamiento de una plantilla de solicitud.
• No repita el mismo campo de combinación varias veces. Los campos de combinación repetidos pueden llevar a resultados incoherentes. Obtenga más información acerca de la organización de solicitudes complejas.
• Si los fallos son frecuentes, por ejemplo, aproximadamente una de cada dos ejecuciones, cree un caso de asistencia e incluya entradas de ejemplo.

Recibo un error al resolver proveedores de datos.

Si ve un error como Error occurred while resolving data providers; cannot describe data provider, una acción en la ficha Recursos falta, está mal configurada o no está disponible. En Generador de solicitudes, estos recursos se denominan acciones. Incluyen acciones de flujo, Apex y retriever.

• Abra la ficha Recursos y revise cada acción. Confirme que el flujo de referencia, la clase Apex o el recuperador aún existen y que tiene acceso a ellos. Obtenga más información acerca de agregar una acción.
• Si cambió el nombre, eliminó o desactivó recientemente un flujo o una clase, actualice o sustituya la acción en la plantilla de solicitud y guarde y realice una vista previa de nuevo.

No puedo eliminar una entrada.

No puede eliminar una entrada a la que aún hace referencia una acción. En la ficha Recursos, elimine o actualice el flujo, Apex o acción de recuperador que utiliza la entrada. A continuación elimine la entrada. Obtenga más información acerca de agregar una entrada.

Faltan mis recursos o flujos después de guardar y activar.

Después de guardar y activar, confirme que está viendo la versión que contiene sus recursos. La activación de una versión de plantilla hace que esa versión sea inmutable, de modo que no se puede modificar.

• Actualice la página, luego utilice el menú desplegable de versión en la parte superior del espacio de trabajo Plantilla de solicitud para abrir la versión que acaba de activar. Obtenga más información acerca del uso de múltiples versiones.
• Confirme que los recursos se guardaron en la versión que ahora está activa. Si agregó un flujo o acción Apex después de la activación, guarde el trabajo como una nueva versión y active esa versión. Obtenga más información acerca de la activación y desactivación de plantillas de solicitudes.

Mi plantilla de solicitud no se guarda.

La validación de ahorro de tiempo falla cuando un campo de combinación, una acción o una entrada obligatoria no es válido.

• Compruebe la sintaxis del campo de combinación. Por ejemplo, utilice {!$Input:Account.Id} en vez de la {!$account.Id} de sintaxis Winter ’24. Obtenga más información acerca de la sintaxis de campos de combinación de recursos.
• Confirme que cada entrada requerida tiene un valor y que cada acción en Recursos aún se resuelve. Obtenga más información acerca de agregar una entrada.
• Si la plantilla utiliza un flujo o una clase Apex desde el piloto Generador de solicitudes, vuelva a crear esos recursos para la sintaxis actual. Obtenga más información acerca de los cambios de flujo después del piloto. Obtenga más información acerca de los cambios de clase Apex después del piloto.

Mi respuesta se enmascara, se marca para contenido dañino o se corta.

La Capa Einstein Trust explora respuestas de plantillas de solicitudes para lenguaje tóxico. Cuando se detecta lenguaje tóxico, la insignia de contenido dañino aparece en la sección Respuesta con un recuento de advertencias. Revise la plantilla de solicitud y realice una vista previa de nuevo hasta que el recuento de advertencias vuelva a 0. Obtenga más información acerca de notificaciones de contenido dañino.

Si se corta la respuesta, la solicitud resuelta puede superar lo que acepta el modelo de IA. Cuando una solicitud es demasiado grande, Generador de solicitudes puede generar un resumen en el panel Resolución. Utilice la solicitud resumida o acorte la plantilla. Obtenga más información acerca de trabajar con solicitudes de gran tamaño.

Los valores enmascarados en la respuesta se esperan cuando la Capa Einstein Trust sustituye datos confidenciales por marcadores de posición y luego los restaura. Abra Detalles de enmascaramiento en la sección Respuesta para inspeccionar la asignación. Obtenga más información acerca de Data Trust y el enmascaramiento.

Necesito documentar y depurar mis plantillas de solicitudes.

Generador de solicitudes no admite comentarios en línea en el cuerpo de la plantilla. Utilice versiones para comparar cambios y mantener un registro corto de lo que cambió en cada versión.

• Haga clic en Guardar como | Guardar como una nueva versión antes de una modificación significativa de modo que pueda comparar respuestas una junto a la otra. Obtenga más información acerca del uso de múltiples versiones.
• Realice una vista previa con el mismo registro de prueba cada vez y anote qué instrucción o recurso cambió.
• Para lógica compleja, pruebe el texto de instrucción en Vista previa por sí mismo, luego agregue recursos y realice una vista previa de nuevo. Obtenga más información acerca de la organización de solicitudes complejas.