Implementar agentes personalizados
Aprende a utilizar los agentes personalizados en los pasos en Canvas o en los campos del catálogo después de crearlos. Para obtener una introducción, consulta Agentes de Braze.
Agentes en Canvas
Puedes utilizar agentes como pasos en un recorrido para personalizar mensajes u orientar la toma de decisiones en tiempo real. Para obtener información detallada sobre los pasos de configuración, consulta el paso Agente.
Casos de uso
| Caso de uso | Descripción |
|---|---|
| Puntuación y calificación de clientes potenciales | Utiliza un paso de agente para evaluar los clientes potenciales entrantes en una escala (por ejemplo, del 1 al 10). Dirige a los usuarios con una puntuación superior a un umbral a rutas de captación, mientras descartas a los clientes potenciales menos adecuados. |
| Personalización dinámica de mensajes | Haz que un agente genere líneas del asunto, recomendaciones de productos o textos de mensajes basados en los atributos de los usuarios o en sus comportamientos recientes. La respuesta se puede insertar directamente en un paso de mensaje. |
| Gestión de los comentarios de los clientes | Transmite los comentarios de los clientes a un agente para analizar el sentimiento y generar mensajes de seguimiento empáticos. Para los usuarios de alto valor, el agente podría escalar la respuesta o incluir ventajas adicionales. |
| Enrutamiento inteligente | Utiliza los resultados del agente (booleanos o numéricos) para dividir a los usuarios en diferentes rutas de Canvas. Por ejemplo, clasifica a los usuarios como «en riesgo» o «sanos» y ajusta la frecuencia de la mensajería en consecuencia. |
| Interpretación de cuestionarios o respuestas | Deja que un agente analice las respuestas abiertas de los cuestionarios o los campos de texto libre, y devuelva valores estructurados (por ejemplo, categorizando la intención o la necesidad) que impulsen las rutas posteriores. |
| Razonamiento en varios pasos | Configura un agente para combinar campos de contexto y tomar decisiones complejas, como recomendar la siguiente mejor acción (correo electrónico, SMS o contacto humano) en función de múltiples atributos del usuario. |
Agentes en catálogos
Puedes aplicar un agente a los campos del catálogo para que genere o calcule automáticamente los valores de cada fila. El agente también se ejecutará en las nuevas filas que se añadan al catálogo en el futuro.
Casos de uso
| Caso de uso | Descripción |
|---|---|
| Generar descripciones de productos | Crea automáticamente textos de marketing breves para las nuevas entradas del catálogo, por ejemplo, generando una descripción atractiva a partir de datos estructurados del producto, como el nombre, la categoría y las características. |
| Enriquecer atributos del producto | Rellena los valores que falten, como la familia de colores, el estilo o la temporada, basándote en el nombre y los detalles del producto. Por ejemplo, si el nombre de un producto es «Gafas de sol polarizadas Laguna», el agente podría asignar el estilo como «deportivo» y la familia de colores como «azul». |
| Calcular campos derivados | Utiliza los campos existentes para generar nuevos datos, como una «puntuación de adecuación» basada en atributos o una «etiqueta de popularidad» a partir de las ventas y el número de reseñas. |
| Clasificar o etiquetar elementos | Asigna etiquetas para la lógica de recomendación, de modo que los modelos de personalización puedan segmentar productos de forma más eficaz. Por ejemplo, etiqueta los productos como «para exterior», «para festivales» o «premium». |
| Localizar contenido | Traduce el texto del catálogo a otro idioma para Campaigns globales o ajusta el tono y la longitud para canales específicos de cada región. Por ejemplo, traduce «Classic Clubmaster Sunglasses» al español como «Gafas de sol Classic Clubmaster» o acorta las descripciones para las Campaigns de SMS. |
| Resumir reseñas o comentarios | Resume las opiniones o comentarios en un nuevo campo, por ejemplo, asignando puntuaciones de sentimiento como Positivo, Neutro o Negativo, o creando un breve resumen de texto como «La mayoría de los clientes mencionan que el producto se ajusta muy bien, pero señalan que el envío es lento». |
Pasos
Para añadir un agente al campo del catálogo:
- En tu catálogo, añade un nuevo campo.
- Selecciona Apply AI agent.
- Asigna un agente a este campo.
- Selecciona las columnas que deben pasarse como entrada. Si no se selecciona ninguna, el agente tendrá acceso a todas las columnas del catálogo.
- Decide si el agente debe volver a calcular los campos cuando se actualicen las filas del catálogo. Si no seleccionas esta opción, el agente solo se ejecutará una vez por fila.
- Selecciona Add fields para implementar el agente y revisar las estimaciones de costes. El modal Cost estimation muestra cuántas veces se ejecutará el agente en este catálogo, lo que equivale aproximadamente al número total de filas. Para continuar, selecciona Confirm.
Cómo funcionan los agentes de catálogo
Tras su inicio, el agente se ejecuta y evalúa cada fila, tomando las columnas seleccionadas en su contexto para generar un resultado. Los agentes se ejecutan en todas las filas nuevas añadidas después de implementar el agente. Si seleccionaste Recalculate when catalog rows update, todos los valores de este campo se actualizarán si cambian los campos de origen existentes.
Puedes actualizar y editar los campos de tu catálogo que utilizan agentes. Para eliminar un agente de una columna, desmarca Apply AI agent. Esto revierte la columna a una columna no agéntica, y los campos conservan los últimos valores que el agente aplicó la última vez que se ejecutó en el catálogo.
Las referencias circulares en los catálogos no son compatibles, lo que significa que no puede darse la siguiente situación:
- La columna agéntica 1 utiliza la columna agéntica 2 como entrada
- La columna agéntica 2 utiliza la columna agéntica 1 como entrada
Los agentes de catálogo solo pueden procesar valores de entrada de hasta 25 KB por fila.
Definir campos de respuesta
Si tu agente utiliza campos como formato de salida, puedes seleccionar el campo correspondiente del agente en Response Field para utilizarlo en el campo del catálogo.
Supongamos que tienes un agente que añade descripciones de productos a un catálogo con los siguientes campos para estructurar el formato de salida:
| Nombre del campo | Valor |
|---|---|
| description | Texto |
| confidence_score_out_of_ten | Número |
Puedes añadir un campo llamado product_description a un catálogo y seleccionar description como Response Field para rellenar la columna con las descripciones del agente.
También puedes anular manualmente la celda generada por el agente seleccionando Edit Item y actualizando la descripción generada por el agente con tus modificaciones. Para volver a la descripción generada por el agente, selecciona el símbolo de actualización en la celda.
Gestión de errores en catálogos
- Las invocaciones de catálogo fallidas no se reintentan.
- Si la llamada a la API del proveedor del modelo fundacional devuelve algún error, como un error de clave de API no válida o un error de límite de velocidad, el valor del campo no se actualiza.
- Puedes revisar los registros del agente para obtener detalles sobre las ejecuciones fallidas.
Supervisa tu agente
En la sección Usage de tu agente, puedes consultar y navegar hasta los lugares en los que el agente se utiliza activamente en catálogos y Canvas.
En la sección Logs de tu agente, puedes supervisar las llamadas reales de los agentes que se producen en tus Canvas y catálogos. Puedes filtrar por información como el intervalo de fechas, el resultado (correcto o fallido) o la ubicación de la llamada. También puedes seleccionar Export CSV para exportar solo los registros que se muestran en la página actual.
También puedes supervisar los errores de límite de invocaciones diarias en el Registro de actividad de mensajes.
Selecciona View para una llamada de agente específica y verás la entrada, la salida y el ID de usuario.
Usar Currents
También puedes utilizar estos eventos de Currents para acceder a los esquemas de registros de Kafka:
- Eventos ejecutados por el agente
- Eventos de invocación de herramientas
Consulta el glosario de eventos de interacción con mensajes para obtener más detalles.