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 comenzar, necesitarás lo siguiente:

• Permiso para acceder a la Consola de agentes en tu espacio de trabajo. Consulta con tus 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: Generar líneas del asunto, encabezados, texto del producto u otro contenido.
  • Enrutamiento de usuarios: Enrutar usuarios en Canvas según su comportamiento, preferencias o atributos personalizados.
  • Gestión de datos: Calcular valores, enriquecer entradas de catálogo o actualizar campos de perfil.

Cómo funciona

Cuando creas un agente, defines su propósito y estableces las directrices sobre cómo debe comportarse. Una vez en vivo, el agente puede desplegarse en Braze para generar textos personalizados, tomar decisiones en tiempo real o actualizar campos de catálogo. A medida que construyes tu agente, puedes guardarlo como borrador y actualizarlo en cualquier momento desde el panel. Cada vez que lo guardas, se 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.

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 crear un agente

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

• Custom agent para crear un agente desde cero
• Una opción en Create an agent with Operator para usar BrazeAI Operator y aplicar una plantilla inicial

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

Paso 3: Configura los detalles

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

1. Introduce un nombre y una descripción para ayudar a tu equipo a comprender 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 pensamiento del modelo. Puedes elegir entre mínimo, bajo, medio o alto. Recomendamos empezar 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 se establece en 250 000, pero puede aumentarse a 1 000 000. Si deseas 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 provoca fallos por límite diario (que no consumen créditos pero aplican valores de alternativa 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 (de 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 costos, reduce el límite diario de invocaciones. Para modelos de tipo trae tu propia clave (BYO), también puedes cambiar a un modelo de menor costo o reducir el nivel de pensamiento. Braze Auto no admite ajustar el nivel de pensamiento. Rastrea el uso real en Settings > Billing > Credits Usage > Agent Console.

Paso 4: Escribe las instrucciones

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

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

Consulta Escribir instrucciones para conocer las mejores prácticas y Ejemplos para inspirarte sobre cómo configurar tu agente.

Añadir contexto

Importante

Los agentes solo reciben los datos que les pasas explícitamente; no buscan en perfiles de usuario ni te avisan cuando faltan datos necesarios. Usa Liquid en tus instrucciones, selecciona + Agent context, añade pasos de Context anteriores en Canvas, o pasa contexto adicional en el paso del agente. Para una lista completa de orígenes de datos y orientación de diseño, consulta Qué datos reciben los agentes.

Selecciona + Agent context para elegir lo que tu agente puede consultar. Esto incluye:

• Fuentes de conocimiento: Dale al agente acceso a datos de catálogo. Crea una fuente de conocimiento a partir de un catálogo y luego añádela como contexto del agente para que pueda consultar y recuperar las filas y campos que necesite.
• Membresía en Segments: Permite al agente personalizar las respuestas en función de a qué Segments pertenece un usuario. Puedes seleccionar hasta cinco Segments.
• Directrices de marca: Proporciona una referencia de las directrices de voz y estilo de marca que el agente debe seguir. Por ejemplo, si quieres que tu agente genere un texto de SMS para animar a los usuarios a suscribirse a una membresía de gimnasio, puedes usar este campo para hacer referencia a tu directriz audaz y motivacional predefinida.
• Archivos de contexto: Sube documentos de referencia (PDF, TXT, MD, CSV) que el agente consultará en cada invocación. Selecciona + Agent context > Upload files, añade uno o más archivos y luego guarda el agente para subirlos.
• 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.

Consejo

Para agentes de Canvas, puedes usar Liquid en tus instrucciones para hacer referencia a atributos de usuario, como su nombre y apellido, o atributos personalizados. Cualquier variable de Liquid en las instrucciones del agente se pasa automáticamente al paso del agente cuando un usuario entra en el paso. Consulta Qué datos reciben los agentes para saber cómo pasar contexto de Canvas y datos de perfil de forma deliberada.

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 precompletado 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 introdujiste 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 del agente no se alinean con la salida especificada, el agente puede confundirse, agotar el tiempo de espera o generar salidas no deseadas.

Consejo

Cuando uses un esquema de salida avanzado, añade un campo de cadena llamado explanation si deseas que el agente devuelva su razonamiento además de las demás salidas. Indica al agente en tus instrucciones que complete explanation cuando eso te ayude a revisar o depurar las respuestas.

Configurar valores de alternativa

Los valores de alternativa solo están disponibles para Canvas Step Agents. En la sección Output de un Canvas Step Agent, puedes definir valores que Braze usa cuando una invocación del agente falla, por ejemplo, cuando el LLM agota el tiempo de espera o devuelve un error de clave de API no válida. Los valores de alternativa funcionan como valores predeterminados de personalización. Podrías establecer 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.

Catalog Agents no admiten la configuración de valores de alternativa en Agent Console.

Para agentes de Canvas, los valores de alternativa admiten plantillas de Liquid para que puedas hacer referencia a atributos de usuario o variables de contexto en el texto de alternativa.

Los campos de alternativa se adaptan al formato de salida de tu Canvas Step Agent:

Cuando un Canvas Step Agent con valores de alternativa se ejecuta en un paso del agente, Braze renderiza la alternativa por usuario y la almacena en la variable de salida en lugar de null. Si no configuras valores de alternativa, las invocaciones fallidas dejan la salida de Canvas sin establecer (null).

Para conocer el comportamiento en tiempo de ejecución, consulta Gestión de errores y comportamiento de alternativa.

Paso 6: Prueba el agente

El panel Preview es una instancia del agente que aparece como un panel lateral junto a la experiencia de configuración. Puedes usar esta sección para probar el agente mientras lo creas o le haces actualizaciones, y experimentarlo de manera similar a como lo harían los usuarios finales. Este paso te ayuda a confirmar que se está comportando como esperas y te da la oportunidad de ajustar antes de ponerlo en vivo.

1. En el campo Test your agent, introduce datos de ejemplo del cliente o respuestas del cliente, 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.

Nota

Las ejecuciones de prueba cuentan para tu límite diario de invocaciones.

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

• ¿El texto se siente alineado con la marca?
• ¿La lógica de decisión dirige a los clientes según lo previsto?
• ¿Los valores calculados son precisos?

Si algo no parece correcto, actualiza la configuración del agente y prueba de nuevo. Ejecuta varias entradas diferentes para ver cómo el agente se adapta en distintos escenarios, especialmente en casos extremos como datos ausentes o respuestas no válidas.

Consejo

Indica lo que el agente debe hacer. Listar contenido no deseado puede dirigir al modelo hacia generarlo. Para más orientación, consulta ¿Por qué mi agente no siguió mis instrucciones o reglas?.

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

Plantillas de agentes de catálogo

Recursos relacionados

• Referencia para agentes
• Preguntas frecuentes
• Webinar de Braze sobre IA en acción: 3 nuevos ejemplos de personalización 1:1