Skip to content

Agente Paso

El paso en Canvas te permite añadir la toma de decisiones y la generación de contenidos con IA directamente a tu flujo de trabajo en Canvas. Para más información general, consulta Agentes Braze.

!Un paso en Canvas para un usuario.

Cómo funciona

Cuando un usuario llega a un paso en Canvas, Braze envía los datos de entrada que hayas configurado (contexto completo o campos seleccionados) al agente que hayas elegido. A continuación, el agente procesa la entrada utilizando su modelo e instrucciones, y devuelve una salida. Esa salida se almacena en la variable de salida que definiste en el paso.

A continuación, puedes utilizar esta variable de dos formas principales:

  • Toma de decisiones: Dirige a los usuarios por diferentes rutas Canvas en función de la respuesta del agente. Por ejemplo, un agente de puntuación de clientes potenciales podría devolver un número entre 1 y 10. Puedes utilizar esta puntuación para decidir si continúas enviando mensajes a un usuario o lo abandonas del viaje.
  • Personalización: Inserta la respuesta del agente directamente en un mensaje. Por ejemplo, un agente podría analizar la opinión de un cliente y generar un correo electrónico de seguimiento empático que haga referencia al comentario del cliente y sugiera una solución.

Crear un paso de Agente

Paso 1: Añade un paso

Arrastra y suelta el componente Agente desde la barra lateral, o selecciona el botón más en la parte inferior de un paso y selecciona Agente.

Paso 2: Selecciona tu agente

Selecciona el agente que procesará los datos en este paso. Elige un agente existente, o crea uno nuevo directamente desde este paso. Para obtener instrucciones de configuración, consulta Crear agentes personalizados.

Paso 3: Define la variable de salida

Las salidas de los agentes se denominan “variables de salida” y se almacenan en una variable de contexto para facilitar su acceso. Para definir la variable de salida:

  1. Dale un nombre a la variable.
  2. Selecciona un tipo de datos.

Las salidas del agente pueden guardarse como cadenas, números o booleanos. Esto los hace flexibles tanto para la personalización del texto como para la lógica condicional en tu Canvas. He aquí algunos usos comunes de cada tipo:

Una vez definida, puedes utilizar una variable de salida en todo el Canvas utilizando la misma sintaxis de plantilla que con una variable de contexto. Utiliza el filtro de segmentos de la Variable de Contexto o plantilla las respuestas de los agentes directamente con Liquid: {{context.${response_variable_name}}} .

Paso 4: Decide qué contexto proporcionar al agente

Debes decidir qué datos debe recibir el agente en tiempo de ejecución. Están disponibles las siguientes opciones:

  • Incluye todo el contexto Canvas: Pasa todas las variables de contexto de Canvas disponibles (como las propiedades de entrada de Canvas) y cualquier otro contexto que se le haya dado a través de los pasos de Contexto.
  • Proporciona valores: Pasa sólo las propiedades seleccionadas, como el nombre o el color favorito de un usuario. Elige esta opción para que el agente sólo tenga acceso a los valores que asignes aquí. Para cada Clave, introduce la etiqueta de Liquid que define el campo específico del perfil de usuario o la variable de contexto.

Tratamiento de errores

  • Si el modelo conectado devuelve un error de límite de velocidad, Braze reintenta hasta cinco veces con retirada exponencial.
  • Si el agente falla por cualquier otro motivo (como una clave de API no válida), la variable de salida se establece en null.
  • Las respuestas se almacenan en caché para entradas idénticas, con el fin de reducir las invocaciones repetidas.

Análisis

Consulta las métricas siguientes para hacer un seguimiento del rendimiento de tus pasos de Agente:

Artículos relacionados
Github   Editar esta página en GitHub
New Stuff!