Crear agentes personalizados

Aprende a crear agentes personalizados, qué preparar antes de empezar y cómo ponerlos en funcionamiento 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 del agente 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.
• Un proveedor de modelos de IA integrado con Braze.
• Una idea de lo que quieres que logre el agente. Los agentes de Braze pueden realizar las siguientes acciones:
  • Mensajería: Genera líneas del asunto, titulares, textos para productos u otro tipo de contenido.
  • Toma de decisiones: Dirige a los usuarios en Canvas en función de su comportamiento, preferencias o atributos personalizados.
  • Gestión de datos: Calcula valores, mejora las entradas del catálogo o actualiza los campos del perfil.

Cómo funciona

Cuando creas un agente, defines su propósito y estableces las pautas sobre cómo debe comportarse. Una vez que esté en vivo, el agente se puede implementar en Braze para generar textos personalizados, tomar decisiones en tiempo real o actualizar campos del catálogo. Puedes pausar o actualizar un agente en cualquier momento desde el dashboard.

Los siguientes casos de uso muestran algunas formas de aprovechar los agentes personalizados.

Crear un agente

Paso 1: Elige un tipo de agente

Para crear tu agente personalizado:

1. Ve a Consola del agente > Gestión de agentes en el dashboard de Braze.
2. Selecciona Crear agente.
3. Elige entre crear un agente Canvas o un agente de catálogo.

Paso 2: 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 finalidad.
2. (opcional) Añade etiquetas para filtrar tu agente.
3. Elige el modelo que utilizará tu agente.
4. Si no estás utilizando el modelo Braze Auto, selecciona el nivel de pensamiento del modelo. Puedes elegir entre mínimo, bajo, medio o alto. Te recomendamos que comiences con Minimal y pruebes las respuestas de tu agente, ajustándolas según sea necesario.
5. Establece un límite de ejecución diario. De forma predeterminada, este valor está establecido en 250 000, pero puede aumentarse hasta 1 000 000. Si te interesa aumentar el límite por encima de 1 000 000, ponte en contacto con tu administrador del éxito del cliente para obtener más información.

Paso 3: Escribe las instrucciones

Dale instrucciones al agente. Recomendamos incluir instrucciones sobre lo que debe hacer el agente en situaciones inesperadas o ambiguas. Esto minimiza el riesgo de que la confusión del agente provoque errores. Por ejemplo, en lugar de pedirle al agente solo valores de sentimiento “positivos” o “negativos”, pídele que devuelva “indeciso” si no puede decidir.

Consulta las instrucciones de redacción para conocer las mejores prácticas y los ejemplos para inspirarte sobre cómo dar instrucciones a tu agente.

Paso 3.1: Añadir recursos

Selecciona Añadir recursos para elegir lo que tu agente puede consultar. Esto incluye lo siguiente:

• Campos del catálogo: Permite que el agente acceda a los datos de tu catálogo para obtener respuestas más precisas.
• Pertenencia al segmento: Permite que el agente personalice las respuestas en función de los segmentos a los que pertenezca el usuario. Puedes seleccionar hasta cinco segmentos.
• Directrices de marca: Consulta las directrices sobre el tono y el estilo de la marca que debe seguir el agente. Por ejemplo, si deseas que tu agente genere un texto SMS para animar a los usuarios a inscribirse en un gimnasio, puedes utilizar este campo para hacer referencia a tu directriz motivacional predefinida en negrita.
• Todo el contexto de Canvas: Analiza todos los datos de contexto de Canvas de un usuario cuando se invoque este agente, incluidas las variables que no se mencionan en la sección Instrucciones.

Paso 3.2: Añadir configuración opcional

En la configuración opcional, puedes ajustar la temperatura del texto generado por el agente. Una temperatura más alta permite al agente utilizar la información proporcionada para ser más creativo.

Paso 4: Selecciona la salida

En la sección Salida, puedes organizar y definir la salida del agente mediante esquemas básicos o esquemas avanzados.

Para obtener los mejores resultados, asegúrate de que lo que especifiques en la sección Salida coincida con las instrucciones del agente que introdujiste en el paso 3. Por ejemplo, si en las instrucciones del agente mencionaste que deseas un objeto con dos cadenas, asegúrate de especificar un objeto con dos cadenas en la sección Salida. Si las instrucciones del agente no coinciden con la salida especificada, el agente puede confundirse, agotar el tiempo de espera o generar resultados no deseados.

Esquemas básicos

Los esquemas básicos son una salida simple que devuelve un agente. Puede ser una cadena, un número, un booleano, una matriz de cadenas o una matriz de números.

Por ejemplo, si deseas recopilar puntuaciones sobre la opinión de los usuarios a partir de un sencillo cuestionario de satisfacción para determinar el grado de satisfacción de tus clientes tras recibir un producto, puedes seleccionar Número como esquema básico para estructurar el formato de salida.

Esquemas avanzados

Las opciones de esquemas avanzados incluyen la estructuración manual de campos o el uso de JSON.

• Campos: Una forma sin código de aplicar una salida de agente que puedes utilizar de forma coherente.
• JSON: Un enfoque basado en código para crear un formato de salida preciso, en el que puedes anidar variables y objetos dentro del esquema JSON. Solo disponible para agentes de Canvas, no para agentes de catálogo.

Recomendamos utilizar esquemas avanzados cuando desees que el agente devuelva una estructura de datos con múltiples valores definidos de forma estructurada, en lugar de una salida de un solo valor. Esto permite que la salida se formatee mejor como una variable de contexto coherente.

Por ejemplo, puedes utilizar un formato de salida dentro de un agente destinado a crear un itinerario de viaje de muestra para un usuario basándose en un formulario que haya enviado. El formato de salida permite definir que cada respuesta del agente debe devolver valores para tripStartDate, tripEndDate y destination. Cada uno de estos valores se puede extraer de las variables de contexto y colocarse en un paso de mensaje para la personalización con Liquid.

• fields
• json schema

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "type": "object",
  "properties": {
    "sentiment": {
      "type": "string"
    },
    "reasoning": {
      "type": "string"
    }
  },
  "required": [
    "sentiment",
    "reasoning"
  ]
}

Paso 5: Prueba y crea el agente

El panel de vista previa es una instancia del agente que aparece como un panel lateral dentro de la experiencia de configuración. Puedes utilizarlo para probar el agente mientras lo creas o actualizas, con el fin de experimentarlo de forma similar a como lo harían los usuarios finales. Este paso te ayuda a confirmar que funciona como esperabas y te da la oportunidad de realizar ajustes antes de que entre en funcionamiento.

1. En el campo Prueba tu agente, introduce datos de clientes o respuestas de clientes de ejemplo, cualquier cosa que refleje situaciones reales que tu agente tendrá que gestionar.
2. Previsualiza la respuesta del agente para un usuario aleatorio, un usuario existente o un usuario personalizado.
3. Selecciona Simular respuesta. El agente se ejecutará según tu configuración y mostrará su respuesta.

Revisa el resultado con ojo crítico. Considera las siguientes preguntas:

• ¿El texto se ajusta a la imagen de marca?
• ¿La lógica de decisión dirige a los clientes según lo previsto?
• ¿Son precisos los valores calculados?

Si algo no funciona correctamente, actualiza la configuración del agente y vuelve a realizar la prueba. Ejecuta varias entradas diferentes para ver cómo se adapta el agente a distintos escenarios, especialmente en casos extremos como la ausencia de datos o respuestas no válidas.

Paso 6: Utiliza tu agente

¡Tu agente ya está listo para usar! Para obtener más información, consulta Implementar agentes.

Artículos relacionados

• Referencia para agentes