Ir al contenido

Operator Connect

Con Operator Connect, puedes tomar acción en Braze desde la herramienta de IA que ya utilizas (Claude, Cursor u otro cliente MCP) y BrazeAI OperatorTM lo ejecuta en tu panel de Braze.

Riesgos y seguridad

Operator Connect no admite tarjetas de acción para aprobar previamente cada acción

Cuando envías un prompt a través de tu cliente MCP para realizar una acción, Operator no se detiene a pedirte que apruebes cada paso, como sí hace cuando lo usas en el panel de Braze. Esto significa que las acciones que le pidas a Operator Connect mediante tu prompt se ejecutarán de inmediato, sin la oportunidad de solicitar aprobación. Si tu equipo tiene requisitos estrictos de control de cambios, crea un usuario del panel de Braze con permisos limitados y autentícate como ese usuario, o realiza esos flujos de trabajo con BrazeAI Operator en el panel.

Actualmente, Operator no puede lanzar campañas ni Canvas.

A través de Operator Connect, las herramientas de los servidores MCP que aprueba un administrador también se ejecutan sin que una persona apruebe cada acción, incluidas las herramientas que pueden modificar datos en otros productos.

Si necesitas ayuda para configurar un usuario del panel con permisos limitados, consulta Administrar usuarios de la empresa. Esto también facilita identificar los cambios de Operator en el panel.

Uso de un MCP de proveedor externo

Cuando usas Operator Connect, Braze recibe instrucciones de tu cliente MCP de proveedor externo, como Claude, ChatGPT, Copilot, Gemini CLI, Codex o Cursor, exactamente como las formula el modelo de IA subyacente de ese proveedor. Cuando escribes una solicitud en lenguaje natural, el modelo de IA interpreta tu solicitud y la convierte en un prompt para Operator cuando el modelo decide usar la herramienta send_operator_prompt. Braze no ve tu prompt original en lenguaje natural y no puede verificar que el prompt generado refleje de forma completa o precisa lo que querías solicitar.

Cuando BrazeAI Operator devuelve datos o un resultado, esa respuesta se envía de vuelta a tu cliente MCP de proveedor externo, que luego la interpreta, le da formato y te la presenta. Braze no controla cómo el modelo de IA presenta, resume o describe la información devuelta.

Braze no se hace responsable de las instrucciones generadas por ningún cliente MCP de proveedor externo ni de las respuestas transmitidas a través de él. Contrasta los resúmenes generados por IA con los datos de origen en tu panel de Braze. Te recomendamos que evites usar cualquier «modo automático» en tu cliente MCP y que revises cualquier acción propuesta por la IA antes de que se lleve a cabo.

Seguimiento de cambios e historial de ediciones

Las ediciones de Campaign y Canvas que hagas a través de Operator Connect aparecen en el historial de ediciones del panel con tu nombre de usuario. Braze hace el seguimiento de estos cambios del mismo modo que lo hace con las ediciones que realizas directamente en el panel.

Cuando editas una Campaign o un Canvas con la herramienta send_operator_prompt, el historial de ediciones muestra el cambio bajo tu cuenta de usuario del panel. Esto se aplica tanto a BrazeAI Operator en el panel como a Operator Connect a través del servidor MCP de Braze.

Las ediciones realizadas con otras herramientas del servidor MCP de Braze (como update_campaign_message_variation) no aparecen en el historial de ediciones de la Campaign. Si necesitas un registro de auditoría completo de todos los cambios en las campañas, usa Operator Connect en lugar de llamar directamente a herramientas de actualización de MCP individuales.

Requisitos previos

Antes de usar Operator Connect, confirma lo siguiente:

Requisito previo Descripción
Servidor MCP de Braze alojado Operator Connect solo está disponible a través del servidor MCP de Braze alojado y basado en OAuth. Los clientes que usan el servidor MCP local con clave de API deben migrar primero al servidor alojado de forma remota. Consulta Configurar el servidor MCP de Braze.
Cuenta de Braze de pago El servidor MCP de Braze no está disponible para cuentas de prueba gratuita.
Operator habilitado para tu espacio de trabajo BrazeAI Operator debe estar activo en tu espacio de trabajo.
Permiso “Use MCP Server” Tu usuario del panel necesita el permiso “Use MCP Server”.

Vuelve a autenticarte después de que se habilite el acceso

Cuando Braze habilita Operator Connect en tu cuenta, tu conexión MCP existente no adopta automáticamente el nuevo alcance. Después de que Braze confirme que tu acceso está habilitado, elimina y vuelve a añadir el servidor MCP de Braze en tu cliente. Si necesitas ayuda, consulta Solución de problemas.

Qué puedes hacer con Operator Connect

Operator Connect puede hacer todo lo que hace BrazeAI Operator en el panel, como por ejemplo:

  • Crear y editar Campaigns y Canvas
  • Crear y actualizar Segments
  • Redactar textos y plantillas para correo electrónico, SMS, push y mensajes dentro de la aplicación
  • Administrar Content Blocks
  • Generar informes y responder preguntas basadas en los datos de tu espacio de trabajo

Para ver la lista completa de capacidades, consulta Qué puedes hacer con Operator.

Las sesiones de Operator Connect también siguen las habilidades de tu espacio de trabajo, igual que Operator en el panel.

Cómo funciona Operator Connect

Escribe tu prompt en lenguaje natural. Normalmente, tu cliente MCP elige Operator Connect a partir de la descripción, sin que tengas que nombrar Operator ni sus herramientas.

Si el cliente no usa Operator Connect para una tarea que Operator puede completar, puedes añadir instrucciones más explícitas para que use Operator Connect.

Cuando envías un prompt, tu cliente lo envía a Operator y recupera el resultado automáticamente. De esto se encargan tres herramientas del servidor MCP de Braze alojado:

  • send_operator_prompt: envía un prompt en lenguaje natural y devuelve un ID de trabajo. Operator ejecuta el trabajo de forma asíncrona.
  • get_operator_result: recupera el resultado de un ID de trabajo determinado.
  • cancel_operator_job: detiene un trabajo en ejecución.

Por ejemplo, puedes pedirle a tu herramienta de IA que cree un Canvas de activación a partir de una descripción. Tu cliente llama a Operator Connect, que busca el espacio de trabajo y el Segment y, a continuación, crea el Canvas en Braze como borrador para que lo revises y lo lances.

Una sesión de chat con IA en la que Operator Connect encuentra el espacio de trabajo FinanceApp y el Segment Pyrite Unfunded Sign-ups 30 to 90 day y luego crea un Canvas. Al lado se muestra una vista previa de una versión de correo electrónico del Canvas.

Ejemplos de prompts

Empieza con una descripción en lenguaje natural. Aquí tienes algunos ejemplos:

Crea un Canvas de bienvenida de tres pasos para nuevos miembros del programa de fidelización: un correo electrónico el día 1, una notificación push el día 3 y un mensaje dentro de la aplicación el día 7. Guárdalo como borrador en el espacio de trabajo Production.

Revisa la línea del asunto y el preencabezado de la Campaign “Summer Sale Email” en el espacio de trabajo Production y sugiere mejoras para aumentar las tasas de apertura.

Crea un Segment de usuarios que hayan realizado una compra en los últimos 30 días, pero que no hayan abierto ninguna notificación push en los últimos 14 días.

¿Cuáles fueron nuestras cinco principales Campaigns de correo electrónico por tasa de clics el último trimestre? Resume las diferencias clave entre ellas.

Qué esperar

Operator Connect funciona de forma distinta a una llamada a la API síncrona. Esto es lo que debes tener en cuenta.

Respuestas asíncronas

Las respuestas pueden tardar unos minutos, no segundos. Operator Connect ejecuta cada tarea como una sesión agéntica completa, que dura aproximadamente lo mismo que hacer el trabajo equivalente en el panel. Ajusta las expectativas en consecuencia si compartes los resultados de Operator Connect con otras personas o con sistemas posteriores. Si estás creando un agente personalizado que llama directamente a estas herramientas, diséñalo para que consulte periódicamente get_operator_result en lugar de esperar una respuesta inmediata. Las respuestas se devuelven como texto, sin un formato de salida estructurado.

Sin memoria de sesión entre llamadas

Cada prompt se ejecuta en su propia sesión aislada. Operator no conserva el contexto de una llamada a la siguiente. Si tu siguiente prompt depende del resultado de uno anterior, incluye el contexto relevante en tu nuevo prompt.

Sin vista de observabilidad

En esta versión beta no hay una interfaz de usuario específica en el panel, un registro de sesiones ni una vista de observabilidad para el uso de Operator Connect. Las acciones que realiza Operator aparecen en el panel con la atribución habitual del usuario del panel que las ejecuta.

Autenticación y permisos

Operator Connect usa el mismo inicio de sesión que el servidor MCP de Braze: tus credenciales habituales de Braze, sin un inicio de sesión aparte. Operator Connect vincula el acceso a tu cuenta de usuario del panel, no a una clave de API compartida. Esto significa que:

  • Operator actúa con los permisos exactos del panel de ese usuario. No puede realizar acciones que el usuario no podría realizar directamente.
  • Operator Connect no usa una cuenta de servicio ni una credencial compartida.
  • El panel atribuye todos los cambios al usuario que inició sesión. Por ejemplo, si un usuario llamado “Alex” actualiza una campaña a través de Operator Connect, el panel muestra Última actualización por Alex, no Última actualización por Operator.
  • Cuando un usuario pierde el acceso en Braze, Braze revoca su acceso a Operator Connect en la siguiente solicitud.

Precios

El uso de Operator Connect se descuenta del mismo límite diario de costo de Operator para toda la empresa que el uso desde el panel. Como el uso programático suele consumir más que el uso interactivo, los participantes de la beta reciben un límite diario temporalmente ampliado mientras dure el programa.

  • El límite ampliado solo se aplica mientras dure el programa beta y está sujeto a cambios.
  • Braze no puede garantizar que te mantengas dentro del límite. Si lo alcanzas, ponte en contacto con tu administrador de éxito del cliente.

Se espera que Operator Connect sea una característica de pago cuando esté disponible de forma general. La participación en la beta es gratuita, pero no refleja los precios futuros.

Privacidad y seguridad de los datos

Operator Connect sigue el mismo modelo de privacidad y seguridad que BrazeAI OperatorTM, incluidas las mismas relaciones con los encargados del tratamiento de datos. Para obtener más información, consulta Privacidad y seguridad de los datos para BrazeAI Operator.

Solución de problemas

Las herramientas de Operator no aparecen después de habilitar el acceso

Cuando Braze habilita Operator Connect en tu cuenta, es posible que tu conexión de cliente MCP existente no detecte automáticamente los permisos de acceso actualizados. Si envías un prompt y recibes un error de autenticación, o si las herramientas de Operator no aparecen en tu cliente:

  1. En tu cliente MCP, elimina la conexión al servidor MCP de Braze.
  2. Vuelve a agregar el servidor MCP de Braze usando tu URL de endpoint (https://mcp.braze.com/mcp para EE. UU., https://mcp.braze.eu/mcp para la UE).
  3. Completa nuevamente el flujo de inicio de sesión con OAuth.

Después de volver a agregarlo, tu cliente se registra con los permisos de acceso actualizados, incluido Operator Connect. Si el problema persiste, contacta a tu administrador de éxito de cliente.

Próximos pasos

New Stuff!