Skip to content

Crear agentes personalizados

Aprende a crear agentes personalizados, qué preparar antes de empezar y cómo ponerlos a trabajar en mensajería, toma de decisiones y gestión de datos. Para obtener más información general, consulta Agentes de Braze.

Requisitos previos

Antes de empezar, necesitarás lo siguiente:

  • Permiso para acceder a la Consola de agentes en tu espacio de trabajo. Consulta con los administradores de Braze si no ves esta opción.
  • Permiso para crear y editar agentes de IA personalizados.
  • Una idea de lo que quieres que el agente logre. Los agentes de Braze pueden realizar las siguientes acciones:
    • Mensajería personalizada: genera líneas del asunto, encabezados, textos dentro del producto u otro contenido.
    • Enrutamiento de usuarios: enruta a los usuarios en Canvas según su comportamiento, preferencias o atributos personalizados.
    • Gestión de datos: calcula valores, enriquece entradas de catálogo o actualiza campos de perfil.

Cómo funciona

Cuando creas un agente, defines su propósito y estableces las directrices para su comportamiento. Una vez en vivo, el agente puede desplegarse en Braze para generar textos personalizados, tomar decisiones en tiempo real o actualizar campos del catálogo. Mientras construyes tu agente, puedes guardarlo como borrador y actualizarlo en cualquier momento desde el panel. Cada guardado crea una nueva versión que puedes revisar en la pestaña Historial de versiones.

Los siguientes ejemplos muestran algunas formas de aprovechar los agentes personalizados.

Ejemplo Descripción
Gestión de comentarios de clientes Envía los comentarios de los usuarios a un agente para analizar el sentimiento y generar mensajes de seguimiento empáticos. Para usuarios de alto valor, el agente puede escalar la respuesta o incluir beneficios.
Localizar contenido Traduce texto del catálogo a otro idioma para campañas globales, o ajusta el tono y la extensión 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 campañas de SMS.
Resumir reseñas o comentarios Resume el sentimiento o los comentarios en un nuevo campo, como asignar puntuaciones de sentimiento tales como Positivo, Neutral o Negativo, o crear un breve resumen de texto como “La mayoría de los clientes mencionan un gran ajuste, pero señalan envíos lentos.”

Crear un agente

Paso 1: Elige un tipo de agente

Para crear un agente, primero elige tu tipo de agente:

  1. Ve a Agent Console.
  2. Elige Canvas Step Agents o Catalog Agents.

Paso 2: Elige cómo construir un agente

Selecciona Create agent y luego elige una de las siguientes opciones:

Si usas Operator, revisa y aprueba sus cambios en el chat antes de continuar con el siguiente paso.

Paso 3: Configura los detalles

A continuación, configura los detalles de tu agente:

  1. Ingresa un nombre y una descripción para ayudar a tu equipo a entender su propósito.
  2. (opcional) Añade etiquetas para filtrar tu agente.
  3. Elige el modelo que usará tu agente.
  4. Si no estás usando el modelo Braze Auto, selecciona el nivel de razonamiento del modelo. Puedes elegir entre mínimo, bajo, medio o alto. Recomendamos comenzar con Minimal y probar las respuestas de tu agente, ajustando según sea necesario.
  5. Establece un límite diario de invocaciones. De forma predeterminada, este valor está establecido en 250.000, pero puede elevarse a 1.000.000. Si te interesa aumentar el límite por encima de 1.000.000, contacta a tu administrador de éxito de cliente para obtener más información. Establece el límite lo suficientemente alto para el tamaño de audiencia planificado después de las pruebas. Un límite demasiado bajo causa fallos por límite diario (que no consumen créditos pero sí aplican valores alternativos o dejan la salida como null).

El campo Daily action credit cost limit especifica el número máximo de créditos que este agente puede consumir por día. Braze lo calcula a partir de la proporción de créditos por invocación de tu espacio de trabajo para el modelo seleccionado (según tu contrato, que se muestra en la página Credit Ratios) multiplicado por el límite diario de invocaciones. La estimación se actualiza cuando cambias el modelo o el límite de invocaciones.

Para gestionar el costo, reduce el límite diario de invocaciones. Para los modelos bring-your-own (BYO), también puedes cambiar a un modelo de menor costo o reducir el nivel de razonamiento. Braze Auto no permite ajustar el nivel de razonamiento. Realiza el seguimiento del uso real en Settings > Billing > Credits Usage > Agent Console.

Interfaz de Agent Console para crear un agente personalizado en Braze. La pantalla muestra campos para ingresar el nombre y la descripción del agente, seleccionar un modelo y establecer un límite diario de invocaciones.

Paso 4: Escribe las instrucciones

Dale instrucciones al agente. Si usaste una plantilla de Operator, revisa las instrucciones precargadas y edítalas según sea necesario.

Incluye instrucciones sobre lo que el agente debe hacer en escenarios inesperados o ambiguos. Esto minimiza el riesgo de que la confusión del agente genere errores. Por ejemplo, en lugar de pedirle al agente solo valores de sentimiento “positivo” o “negativo”, pídele que devuelva “unsure” si no puede decidir.

Consulta las instrucciones de escritura para conocer las mejores prácticas y los ejemplos para inspirarte sobre cómo formular las indicaciones de tu agente.

Agregar contexto

Selecciona + Agent context para elegir qué puede referenciar tu agente. Esto incluye:

  • Campos de catálogo: Dale al agente acceso a los datos de tu catálogo para obtener respuestas más precisas.
  • Fuentes de conocimiento: Dale al agente acceso a los datos del catálogo a través de una fuente de conocimiento para una recuperación más precisa que adjuntar un catálogo directamente.
  • Pertenencia a Segments: Permite que el agente personalice las respuestas según a qué Segments pertenece un usuario. Puedes seleccionar hasta cinco Segments.
  • Directrices de marca: Referencia la voz y las directrices de estilo de la marca que el agente debe seguir. Por ejemplo, si quieres que tu agente genere texto de SMS para animar a los usuarios a suscribirse a una membresía de gimnasio, puedes usar este campo para referenciar tu directriz predefinida de tono motivacional y audaz.
  • Todo el contexto de Canvas: Analiza todos los datos de contexto de Canvas para un usuario cuando se invoca este agente, incluyendo cualquier variable que no esté referenciada en la sección Instructions.
  • Datos de interacción del usuario: Proporciona al agente los datos recientes de aperturas, clics y conversiones de Campaigns y Canvas de cada usuario.

Paso 5: Selecciona la salida

En la sección Output, puedes organizar y definir la salida del agente mediante esquemas básicos o esquemas avanzados. Si usaste una plantilla de Operator, revisa el esquema de salida precargado y edítalo según sea necesario.

Para obtener los mejores resultados, asegúrate de que lo que especificas en la sección Output coincida con las instrucciones del agente que ingresaste en el Paso 4. Por ejemplo, si mencionaste en las instrucciones del agente que deseas un objeto con dos cadenas, asegúrate de especificar un objeto con dos cadenas en la sección Output. Si las instrucciones de tu agente no se alinean con la salida especificada, el agente puede confundirse, agotar el tiempo de espera o generar salidas no deseadas.

Configurar valores alternativos

Los valores alternativos solo están disponibles para los agentes de paso en Canvas. En la sección Output de un agente de paso en Canvas, puedes definir valores que Braze utiliza cuando falla una invocación del agente, por ejemplo, cuando el LLM agota el tiempo de espera o devuelve un error de clave de API no válida. Los valores alternativos funcionan como valores predeterminados de personalización. Podrías configurar una línea del asunto estática o un mensaje corto que aún proporcione a los usuarios una salida útil cuando el agente no pueda ejecutarse.

Los agentes de catálogo no permiten configurar valores alternativos en Agent Console.

Configuración de salida de Agent Console que muestra el campo de salida alternativa para un esquema de tipo numérico.

Para los agentes de Canvas, los valores alternativos son compatibles con plantillas de Liquid para que puedas referenciar atributos de usuario o variables de contexto en el texto alternativo.

Los campos alternativos se adaptan al formato de salida de tu agente de paso en Canvas:

Formato de salida Configuración alternativa
Cadena, número o booleano Ingresa un solo valor alternativo (compatible con Liquid).
Campos (esquema avanzado) Ingresa un valor alternativo para cada campo definido en la salida del agente.
Esquema JSON (esquema avanzado) Braze lee tu esquema JSON y genera un campo de entrada para cada propiedad, para que puedas definir un valor alternativo por clave.

Cuando un agente de paso en Canvas con valores alternativos se ejecuta en un paso de agente, Braze renderiza el valor alternativo por usuario y lo almacena en la variable de salida en lugar de null. Si no configuras valores alternativos, las invocaciones fallidas dejan la salida de Canvas sin establecer (null).

Para el comportamiento en tiempo de ejecución, consulta Manejo de errores y comportamiento alternativo.

Paso 6: Prueba el agente

El panel Preview es una instancia del agente que aparece como un panel lateral dentro de la experiencia de configuración. Puedes usar esta sección para probar el agente mientras lo creas o actualizas, experimentándolo de una forma similar a los usuarios finales. Este paso te ayuda a confirmar que se está comportando como esperas y te da la oportunidad de afinar antes de que entre en vivo.

  1. En el campo Test your agent, ingresa datos de clientes de ejemplo o respuestas de clientes, cualquier cosa que refleje escenarios reales que tu agente manejará.
  2. Previsualiza la respuesta del agente para un usuario aleatorio, un usuario existente o un usuario personalizado.
  3. Selecciona Simulate response. El agente se ejecutará según tu configuración y mostrará su respuesta.

Agent Console mostrando el panel de vista previa para probar un agente personalizado. La interfaz muestra un campo de entradas de muestra con datos de clientes de ejemplo, un botón para ejecutar la prueba y un área de respuesta donde aparece la salida del agente.

Revisa la salida con ojo crítico. Considera las siguientes preguntas:

  • ¿El texto se siente acorde con la marca?
  • ¿La lógica de decisión dirige a los clientes como se pretende?
  • ¿Los valores calculados son precisos?

Si algo no se siente bien, actualiza la configuración del agente y prueba de nuevo. Ejecuta algunas entradas diferentes para ver cómo se adapta el agente en distintos escenarios, especialmente en casos límite como la ausencia de datos o respuestas no válidas.

Paso 7: Usa tu agente

¡Tu agente ya está listo para usar! Para más detalles, consulta Desplegar agentes.

Plantillas de agentes creadas con Operator

Operator puede preconfigurar instrucciones, campos de salida y contexto para las siguientes plantillas iniciales de la Agent Console. Elige una plantilla en Operator o pídele a Operator que aplique una por nombre.

Plantillas de agentes de paso en Canvas

Plantilla Descripción Ejemplo de salida
Redactor personalizado Genera textos de mensajes específicos para cada canal a partir de atributos de usuario, contexto de Canvas y directrices de marca Línea del asunto y preencabezado del correo electrónico; título y cuerpo del push
Analista de comentarios Analiza comentarios abiertos de cuestionarios o soporte y los convierte en campos estructurados para la ramificación en Canvas Sentimiento, tema, siguiente acción recomendada
Enrutador de recorridos Dirige a cada usuario a la ruta de Canvas más relevante en función de su perfil y el contexto del recorrido Nombre de la ruta o booleano para pasos de división de decisiones

Plantillas de agentes de catálogo

Plantilla Descripción Ejemplo de salida
Redactor de descripciones Escribe descripciones de marketing breves a partir de columnas existentes del catálogo Descripción de producto o destino
Categorizador de elementos Asigna categorías o etiquetas a partir de los datos de las filas Etiquetas de categoría para filtrado y recomendaciones
Traductor de localización Traduce cadenas del catálogo a los idiomas de destino dentro de los límites de caracteres Texto localizado por idioma
New Stuff!