Preguntas frecuentes sobre agentes
Este artículo responde a preguntas frecuentes sobre Braze Agents.
General
¿Cuál es la diferencia entre un Braze Agent y un agente de decisión?
Un Braze Agent razona sobre el contexto de un usuario concreto en un paso en Canvas o en un campo de catálogo. Un agente de decisión de Decisioning Studio aprende de los resultados medidos en toda tu población. Para más información, consulta Braze Agent frente a agente de decisión.
¿Cuál es la diferencia entre Braze Agents y BrazeAI Operator?
Operator trabaja contigo en el panel mientras creas. Braze Agents se ejecutan en el momento del envío y producen un resultado distinto para cada usuario. Para más información, consulta Generar contenido.
¿Cuál es la diferencia entre los agentes de paso en Canvas y los agentes de catálogo?
Al crear un agente, especificas si quieres crear un agente de paso en Canvas o un agente de catálogo. Esto determina los tipos de instrucciones y opciones que admite el agente. Los agentes de paso en Canvas procesan usuarios en tiempo real dentro de los recorridos, mientras que los agentes de catálogo enriquecen los datos del catálogo añadiendo o actualizando columnas con información procesada.
¿Qué ventajas tiene usar el modelo Auto frente a traer tu propio modelo (BYO)?
Entre las ventajas de usar el modelo Auto de Braze se incluyen:
- No necesitas obtener ni introducir claves de API ni configurar ninguna integración
- Cada invocación se dirige automáticamente al modelo más eficaz para la tarea
¿Dónde puedo ver el uso actual de mis agentes?
Ve a Configuración > Facturación > Uso de créditos > Consola de agentes para ver el consumo de créditos, el número de invocaciones y la proporción de créditos por agente. Para más detalles, consulta Límites diarios de invocaciones y créditos.
¿Puedo usar instrucciones condicionales de Liquid en las instrucciones de un agente?
No, intentar escribir bloques de Liquid como las instrucciones {% if %} puede provocar un error de validación. En su lugar, los agentes pueden gestionar distintos escenarios mediante descripciones en lenguaje natural en el prompt.
¿Pueden los agentes acceder a datos de usuario más allá de los atributos de Liquid o del contexto de Canvas concretos que les paso?
No. Los agentes solo reciben los puntos de datos de usuario concretos que se pasan mediante Liquid en las instrucciones, las selecciones de + Contexto del agente, los pasos de Contexto anteriores en Canvas o el contexto adicional del paso Agente. Los agentes no pueden buscar en los perfiles de usuario atributos que no hayas configurado para que reciban.
Los agentes tampoco pueden avisarte cuando faltan datos necesarios: continúan con lo que haya en el prompt. Plantea la configuración del agente como un diseño deliberado de entradas y salidas: pasa todos los campos que necesite el agente y verifica las entradas en la pestaña Registros del agente. Para obtener orientación, consulta Qué datos reciben los agentes.
Solución de problemas
¿Por qué mi agente no siguió mis instrucciones o reglas?
Siempre que puedas, escribe instrucciones positivas y explícitas. Dile al agente qué debe hacer y expresa cualquier restricción en términos concretos. Por ejemplo: «Si {{product_name}} está vacío, trátalo como si nunca se hubiera proporcionado».
Usa Operator para revisar tu prompt. Operator recorre tus instrucciones y te explica dónde es probable que el agente se haya desviado.
¿Por qué mi agente de catálogo omitió algunas filas?
Los agentes de catálogo omiten una fila cuando una columna que marcaste como obligatoria para ejecutar está en blanco o falta; por ejemplo, un campo gender que no se ha rellenado. Después de seleccionar las columnas de entrada, habilita el control de entrada obligatoria para el campo del catálogo y elige qué columnas deben contener valores antes de que se ejecute el agente. Las columnas seleccionadas son obligatorias de forma predeterminada, pero puedes quitar las columnas que pueden quedar vacías sin bloquear la invocación. Así evitas gastar tokens en datos incompletos.
El agente también respeta las dependencias entre columnas. Si una columna de salida depende de otras columnas (por ejemplo, la columna D necesita valores en las columnas B y C), el agente no se ejecuta hasta que esas columnas anteriores tengan datos en esa fila.
Para más información, consulta Prácticas recomendadas para agentes de catálogo.
¿Las invocaciones fallidas de agentes consumen créditos?
Depende del tipo de error:
| Error | ¿Consume créditos? |
|---|---|
| Error de límite de velocidad | No |
| Modelo no disponible | No |
| Límite diario de invocaciones alcanzado | No |
| Tiempo de espera agotado | Sí |
Consulta Cuándo se consumen créditos para más información.
Mi agente tiene dificultades con una tarea compleja. ¿Cómo puedo mejorar su rendimiento?
Si ves que el agente tiene dificultades con las tareas que le pides, plantéate un enfoque con subagentes. Por ejemplo, podrías usar tres agentes para lo siguiente:
- El agente 1 estandariza y transforma los datos de contexto de Canvas no estructurados que llegan.
- El agente 2 consulta un catálogo con detalles de artículos e identifica qué artículos podrían ser relevantes.
- El agente 3 consulta otro catálogo con diversas descripciones posibles para cada artículo e identifica la descripción más relevante para el usuario para incluirla en un correo electrónico.
¿Qué puede hacer que un agente personalizado agote el tiempo de espera con frecuencia?
Un agente personalizado puede agotar el tiempo de espera si:
- Las instrucciones del agente son incompletas o contradictorias
- Las instrucciones del agente no cubren todos los escenarios ni incluyen una condición alternativa (por ejemplo, «Si todas las entradas están vacías, devuelve ‘No se pudo personalizar’»)
- Las instrucciones del agente le piden un formato de salida distinto al especificado en la pestaña Salida (por ejemplo, si las instrucciones piden una cadena, pero en la pestaña Salida la salida está definida como un número)
- La tarea del agente es demasiado compleja y se beneficiaría de un enfoque con subagentes
Cómo reducir los tiempos de espera agotados
Si tu agente agota el tiempo de espera a menudo, prueba lo siguiente antes de contactar con tu director de cuentas para solicitar un límite de tiempo de espera mayor:
- Elige un modelo más sencillo o de menor coste: Los modelos más rápidos suelen completarse dentro del intervalo de tiempo de espera predeterminado. Consulta Determinar qué modelo usar.
- Reduce el nivel de razonamiento (solo modelos propios): Empieza por Mínimo y súbelo solo si la calidad de la salida se resiente. Consulta Niveles de razonamiento.
- Simplifica el prompt: Elimina instrucciones redundantes, acorta los ejemplos y reduce el esquema de salida. Usa Operator para revisar y ajustar tus instrucciones.
- Divide los flujos de trabajo complejos en varios agentes: Si el caso de uso tiene varios subpasos (por ejemplo, clasificar la intención y luego generar el texto), usa agentes separados en secuencia en Canvas o en el catálogo en lugar de un solo agente que lo haga todo. Consulta el enfoque con subagentes.

Los tiempos de espera agotados consumen créditos de Braze aunque el agente no devuelva ninguna salida útil. Consulta Cuándo se consumen créditos.
Para los agentes de paso en Canvas, configura valores alternativos en la consola de agentes para que los usuarios sigan recibiendo una salida cuando falle una invocación.
¿Por qué mi agente funcionó bien en las pruebas, pero no recibe datos específicos del usuario cuando lo lanzo en un Canvas?
Si tu agente funciona correctamente durante las pruebas, pero no recibe datos específicos del usuario en un Canvas en vivo, prueba estos pasos de solución de problemas:
- Asegúrate de que los datos específicos del usuario que quieres que reciba el agente estén incluidos como variables de Liquid en las instrucciones del agente.
- Si tienes datos importantes en el contexto del Canvas, usa la opción Añadir todo el contexto del Canvas en la configuración del agente para que reciba todo el contexto del Canvas.
- Asegúrate de que cualquier contexto del Canvas al que quieras que acceda el agente esté almacenado como contexto del Canvas. Usa un paso de contexto antes del paso del agente para almacenar estos datos.
Cumplimiento normativo
¿Agent Console cumple con el RGPD y la CCPA?
Sí. Cuando un cliente utiliza el modelo Braze Auto (con tecnología de Gemini), Google actúa como subencargado del tratamiento de Braze, conforme a los términos del Anexo de Tratamiento de Datos (DPA) entre el cliente y Braze.
¿Agent Console cumple con la HIPAA?
Sí. Cuando se usa el modelo Braze Auto, tenemos un acuerdo específico de HIPAA, el Anexo de Socio Comercial (BAA), con Google que cubre Gemini, el modelo que impulsa nuestro modelo Auto.
Nuestro BAA solo se aplica a los clientes que usan el modelo Braze Auto. Si los clientes usan su propia clave de LLM, Braze no envía en su nombre información de salud protegida (PHI) sujeta a la HIPAA a un LLM, sino que son los clientes quienes la envían directamente. En este caso, el BAA entre Braze y Google no se aplica. El tratamiento de datos mediante su propia clave de LLM se rige por el contrato del cliente y por cualquier BAA que tenga directamente con su proveedor de LLM.
¿Qué ocurre con los registros de los agentes cuando se elimina un usuario?
Cuando eliminas un perfil de usuario, Braze suprime el contenido de ese usuario de los Registros de tus agentes. Esto se aplica cuando eliminas un único usuario, un Segment de usuarios o un espacio de trabajo.
En cada una de las entradas de registro de ese usuario, Braze sustituye o borra:
- La entrada del agente, incluido el Liquid renderizado y el contexto de Canvas
- Los datos de perfil que Braze añadió a la entrada
- La salida del agente y cualquier valor alternativo
- Los argumentos y las salidas de las llamadas a herramientas
Braze también elimina el ID de usuario, por lo que al buscar a ese usuario en Registros ya no se devuelven esas entradas. Las instrucciones de tu agente no cambian.
Las entradas de registro en sí se conservan, por lo que los recuentos de invocaciones del agente y el uso de créditos las siguen incluyendo. Los registros exportados antes de la eliminación no cambian.