Braintrust
Conecta Braintrust con Webflow para supervisar las funciones de IA de tu sitio y sincronizar los datos de evaluación en tu CMS.
Webflow gestiona muy bien el diseño, la gestión de contenidos y el alojamiento. Lo que no hace es decirte si tu chatbot de IA dio una respuesta correcta, avisarte cuando la calidad del contenido generado por tu LLM disminuye o detectar tasas de alucinación antes de que los usuarios se den cuenta. La supervisión de errores tradicional solo detecta fallos.
Al conectar Braintrust y Webflow, tu sitio gana superpoderes de observabilidad para IA. Los resultados de evaluación aterrizan directo en colecciones de Webflow CMS para tus paneles públicos, las alertas vía webhook actualizan la web si la calidad flaquea y los formularios nutren al instante los conjuntos de datos para no parar de hacer pruebas.
Esta integración es especialmente útil para equipos de ingeniería que lanzan funciones de IA en sitios alojados en Webflow, agencias que desarrollan proyectos de IA para clientes y equipos de producto que necesitan realizar un seguimiento de la calidad de los LLM junto a sus sitios de marketing o producto.
Cómo integrar Braintrust con Webflow
¿Qué es Braintrust? Braintrust es la plataforma de evaluación y observabilidad de IA pensada para equipos de ingeniería y producto que lanzan funciones con LLM sin perder el ritmo. Ofrece trazas en producción, comparación de prompts cara a cara, puntuación automática y humana, y detección de regresiones en CI/CD, todo con SDK listos para usar en Python, TypeScript, Go, Ruby, C#, Java y Kotlin.

Los equipos de ingeniería utilizan Braintrust y Webflow juntos cuando necesitan algo más que supervisión de tiempo de actividad; específicamente, cuando quieren registrar cada interacción con la IA, calificar los resultados según criterios de calidad y detectar regresiones antes de que los usuarios las noten.
La integración entre Braintrust y Webflow admite cuatro enfoques:
- El código personalizado te permite enlazar objetos de Braintrust, insertar entornos de pruebas públicos y llamar al Proxy de IA desde elementos de Code Embed o código personalizado a nivel de sitio.
- Las plataformas de automatización (Zapier, Make o viaSocket) sincronizan eventos de Braintrust con elementos de Webflow CMS sin necesidad de escribir código backend.
- Las API de Webflow y Braintrust te dan control total sobre la sincronización de datos, los disparadores de evaluación y los flujos de trabajo de publicación automatizados, pero requieren desarrollo del lado del servidor.
- Webflow Cloud te permite desplegar aplicaciones Next.js o Astro con el SDK de Braintrust montado directamente en tu dominio de Webflow para la instrumentación del lado del servidor.
La mayoría de las configuraciones de producción combinan dos o más de estos enfoques: plataformas de automatización para el enrutamiento de eventos e integración de API para flujos de trabajo complejos, como controles de calidad que bloquean la publicación del sitio hasta que se superen las evaluaciones.
Añade enlaces e incrustaciones de Braintrust con código personalizado
Braintrust genera URL permanentes y compartibles para experimentos y conjuntos de datos que puedes enlazar directamente en cualquier página de Webflow. El formato del enlace permanente es:
https://www.braintrust.dev/app/braintrustdata.com/object?object_type=experiment&object_id=YOUR_ID
Solo experiment y dataset son compatibles como valores de object_type. También se pueden compartir seguimientos individuales desde el visor de registros, y los entornos de pruebas pueden compartirse en modo de solo lectura; verifica la disponibilidad actual de estas opciones en tu cuenta de Braintrust antes de desarrollar basándote en ellas. Añade cualquiera de estas URL como destinos de enlace en botones, texto o imágenes en Webflow sin necesidad de código personalizado.
Para incrustar contenido de Braintrust directamente en una página, añade un elemento Code Embed con un iframe que apunte a una URL pública de Braintrust. Los elementos Code Embed requieren un plan de sitio de pago, admiten hasta 50 000 caracteres por incrustación y solo se renderizan en el sitio publicado o previsualizado, no en el lienzo de Webflow. Antes de crear una incrustación iframe, comprueba si los encabezados X-Frame-Options o Content-Security-Policy: frame-ancestors de Braintrust lo permiten inspeccionando los encabezados de respuesta en las herramientas de desarrollo del navegador.
Para contenido dinámico, coloca un elemento de código embebido dentro de una Collection List y aprovecha el embed dinámico de Webflow para inyectar campos del CMS en cada elemento. Crea una colección llamada «Experimentos de IA» con un campo de texto «ID del experimento», ¡y el embed generará un enlace permanente único de Braintrust para cada ítem como por arte de magia, sin tocar nada a mano!
Usa una página de Webflow como iframe de span de Braintrust
Braintrust admite un patrón de incrustación invertido donde tu página de Webflow se muestra dentro de la interfaz de evaluación de Braintrust. La función de iframes de Span en la configuración del proyecto de Braintrust (Settings > Project > Span iframes) carga cualquier URL pública dentro del visor de seguimientos. Crea una página de visualización personalizada en Webflow —usando un Code Embed que escuche eventos postMessage— publícala e introduce la URL en vivo en la configuración del proyecto de Braintrust. Los anotadores verán entonces la superficie de visualización diseñada en Webflow directamente dentro de Braintrust al revisar los spans.
Notion ha documentado el uso de un patrón similar para el etiquetado de datos y la revisión de seguimientos. Este enfoque no requiere integración de API y utiliza las herramientas de diseño de Webflow para crear interfaces fáciles de anotar que se renderizan dentro de Braintrust.
Llama al proxy de IA de Braintrust desde código del lado del cliente
El proxy de IA de Braintrust ofrece un endpoint compatible con OpenAI en /v1/proxy que enruta las solicitudes entre proveedores de LLM con almacenamiento en caché, seguimiento y puntuación automáticos. Puedes llamar al proxy de IA desde JavaScript del lado del cliente en un elemento de incrustación de código o en código personalizado añadido al encabezado o al cuerpo de tu sitio. El endpoint del proxy acepta solicitudes en formato estándar de OpenAI y registra automáticamente cada llamada en Braintrust para facilitar la observabilidad.
Nunca incrustes una BRAINTRUST_API_KEY permanente en el código de Webflow del lado del cliente, ya que es visible para cualquiera que inspeccione el código fuente de la página. El proxy de IA requiere el sistema de credenciales temporales de Braintrust, donde un backend emite tokens de corta duración para el frontend. Para sitios sin backend, combina este método con una función serverless que emita credenciales temporales bajo demanda.
Conéctate con Zapier, Make o viaSocket
Hay tres plataformas estrella de automatización que enlazan Braintrust y Webflow para sincronizar eventos sin picar código de backend. Zapier cuenta con una integración dedicada con disparadores de Braintrust y acciones de Webflow, como Create Live Item, Update Item y Update Live Item. Make ofrece un conector con Braintrust para seguir proyectos y gestionar conjuntos de datos sin despeinarte. Por su parte, viaSocket dispone de integración directa para conectar disparadores de Braintrust con Webflow.
Las tres plataformas almacenan tu clave de API de Braintrust en el lado del servidor, por lo que las credenciales nunca aparecen en el frontend de Webflow. Los flujos de trabajo de automatización comunes incluyen:
- Cuando se ejecuta una evaluación de Braintrust, actualiza un elemento de CMS de Webflow para marcar el contenido generado por IA como revisado o escribe una puntuación de calidad en un campo del CMS
- Cuando se crea un nuevo proyecto en Braintrust, crea una entrada de CMS correspondiente para una hoja de ruta de IA pública o una página de estado
- Enruta los envíos de formularios de Webflow a través de Make hacia los conjuntos de datos de Braintrust, convirtiendo los comentarios de los usuarios sobre las respuestas de la IA en casos de prueba de evaluación
- Envía contenido del CMS a través de Make a Braintrust para la evaluación de prompts y la puntuación de calidad antes de publicarlo
Para quienes no son desarrolladores y necesitan sincronización con el CMS o enrutamiento de eventos, las plataformas de automatización son la vía más rápida para lograr una integración funcional. Zapier también permite combinar disparadores de Braintrust con lógica condicional y flujos de trabajo de varios pasos para un enrutamiento más complejo.
Desarrolla con las API de Webflow y Braintrust
La integración directa mediante la API de Webflow y la API REST de Braintrust (https://api.braintrust.dev) te permite crear una sincronización de datos bidireccional, publicaciones condicionadas a evaluaciones y flujos de trabajo personalizados que van más allá de lo que ofrecen las plataformas de automatización. Este enfoque requiere desarrollo en el lado del servidor, pero te otorga control total sobre cómo ambas plataformas intercambian datos.
Una función serverless (AWS Lambda, Cloudflare Workers, Vercel o Netlify) actúa como capa de middleware, almacenando ambas claves de API como variables de entorno y coordinando las llamadas entre las dos plataformas. Ambas API están bien documentadas y se mantienen activamente, por lo que la superficie de integración es estable.
Los patrones a continuación utilizan estos endpoints:
- Braintrust:
POST /v1/project_logs/{project_id}/insertpara registrar seguimientos,POST /btqlpara consultar datos,POST /v1/functionpara invocar prompts fijados en producción,POST /v1/evalpara lanzar evaluaciones - Webflow:
PATCH /v2/collections/{collection_id}/items/{item_id}/livepara actualizaciones de elementos en vivo,POST /v2/collections/{collection_id}/items/bulkpara creación por lotes (hasta 100 elementos por solicitud),POST /v2/sites/{site_id}/webhookspara registrar oyentes de webhooks
Todas las llamadas requieren tokens de Authorization: Bearer. Braintrust utiliza claves de API creadas en Configuración > Claves de API; Webflow utiliza tokens de sitio o tokens de OAuth, dependiendo del endpoint.
Sincroniza los datos de evaluación de Braintrust con el CMS de Webflow
Escribir los resultados de las evaluaciones en colecciones del CMS de Webflow permite crear paneles públicos, registros de auditoría o rastreadores de calidad de IA. Consulta los seguimientos de Braintrust usando el endpoint BTQL, transforma la respuesta al formato fieldData de Webflow y crea o actualiza elementos del CMS a través de la API de Webflow.
Esta consulta BTQL recupera los seguimientos recientes con puntuación alta:
POST /btql
{
"query": "SELECT id, input, output, scores FROM project_logs('tu-id-de-proyecto', shape => 'traces') WHERE scores.accuracy > 0.8 LIMIT 100",
"fmt": "json"
}
Los sitios con plan CMS admiten 2000 elementos; los sitios con plan Business admiten hasta 10 000 elementos. Planifica el tamaño de tu colección en consecuencia si tienes la intención de conservar un historial público de evaluaciones en lugar de solo los resúmenes más recientes.
Dispara evaluaciones de Braintrust desde eventos de Webflow
Registra un webhook de Webflow para eventos de form_submission o collection_item_created usando POST /v2/sites/{site_id}/webhooks. Cuando se dispara el evento, tu función serverless recibe la carga útil, obtiene los datos completos del elemento si es necesario y llama a POST /v1/eval para iniciar una evaluación de Braintrust. Una vez completada la evaluación, recupera las puntuaciones y compáralas con tu umbral de calidad. Si el contenido pasa la prueba, publícalo mediante POST /v2/collections/{collection_id}/items/publish. Si falla, déjalo como borrador o escribe la puntuación en un campo de metadatos para su revisión.
Las cargas útiles de los webhooks de Webflow incluyen los encabezados x-webflow-timestamp y x-webflow-signature para verificar su autenticidad. Verifica estas firmas en el lado del servidor antes de procesar cualquier evento, especialmente cuando el webhook pueda activar acciones de publicación.
Recibe webhooks de Braintrust y actualiza el contenido de Webflow
El sistema de alertas de Braintrust dispara webhooks a tu servidor cuando los registros cumplen ciertas condiciones o cambia el entorno de un prompt. Configura todo a tu gusto en Settings > Project > Alerts. Tienes dos tipos de eventos listos para la acción:
- El evento
logsse activa cuando las entradas de registro coinciden con un filtro BTQL/SQL dentro de un periodo configurable (de 5 minutos a 24 horas). - El evento
environment_updatese activa inmediatamente cuando se asigna o elimina un entorno de prompt; esto es útil para equipos que fijan prompts en producción y quieren que el contenido de Webflow refleje los cambios de versión.
Este ejemplo de filtro SQL se activa cuando las puntuaciones de veracidad en producción caen por debajo de un umbral:
scores.factuality < 0.8 AND metadata.environment = 'production'
Las cargas útiles de los webhooks de Braintrust contienen un recuento agregado y una details.related_logs_url que apunta a los registros coincidentes; no se incluyen los registros individuales. Para obtener los datos reales y escribirlos en el CMS de Webflow, tu servidor debe realizar una consulta POST /btql. Utiliza los webhooks de Braintrust como disparadores y deja que tu backend se encargue de la recuperación de datos y la actualización del CMS de Webflow.
Desarrolla en Webflow Cloud con el SDK de Braintrust
Webflow Cloud te permite desplegar aplicaciones de Next.js o Astro directamente en una ruta de tu dominio Webflow, sumando ejecución en el servidor bajo el mismo origen. Añade el SDK de TypeScript de Braintrust a tu código de servidor y monitoriza llamadas de IA desde tus rutas API, manteniendo frontend y backend en perfecta sintonía bajo el mismo techo y sin servicios extra.
Webflow Cloud se ejecuta en un entorno de ejecución Edge. Ten en cuenta estas limitaciones al integrar el SDK de Braintrust:
- Todas las llamadas externas deben usar la API
fetchnativa;axiosy otros clientes HTTP no son compatibles. - Las variables de entorno solo están disponibles en tiempo de ejecución, no durante la compilación.
La inicialización deBRAINTRUST_API_KEY debe realizarse en el momento de la solicitud, no al cargar el módulo.
Añade BRAINTRUST_API_KEY como una variable de entorno secreta en Webflow Cloud; las variables secretas están cifradas y no se exponen en la salida de la compilación. El paquete @braintrust/browser proporciona un polyfill de AsyncLocalStorage si necesitas seguimiento del lado del cliente junto con la instrumentación del lado del servidor. Prueba el comportamiento del SDK en un entorno de pruebas de Webflow Cloud antes de implementarlo en producción.
Lo que puedes construir con la integración de Braintrust y Webflow
Integrar Braintrust con Webflow te permite supervisar y actuar sobre los datos de calidad de la IA directamente desde tu sitio, sin necesidad de crear un panel de control de supervisión independiente.
Aquí tiene algunas cosas que puede crear con esta integración:
- Panel de calidad de chatbot de IA: Crea una página basada en Webflow CMS que muestre la precisión del chatbot y las puntuaciones de sentimiento, actualizadas automáticamente mediante Zapier o una función serverless; campos como el porcentaje de precisión, la duración y el recuento de tokens se asignan directamente a los campos de la colección del CMS.
- Publicación de contenido sujeta a evaluación: Mantén las publicaciones de blog o descripciones de productos generadas por IA en borrador hasta que una evaluación de Braintrust las califique por encima de un umbral de calidad, utilizando un webhook
collection_item_createdpara activar la evaluación y publicar solo si se obtiene una puntuación aprobatoria. - Registro de cambios del proyecto de IA: Crea un nuevo elemento en el CMS de Webflow cada vez que se cree un proyecto o experimento en Braintrust mediante Zapier, construyendo un registro de cambios público que se mantenga al día con la actividad de evaluación de tu equipo de IA sin actualizaciones manuales.
- Canalización de comentarios a evaluación: Recopila comentarios de los usuarios sobre las respuestas generadas por IA a través de un formulario de Webflow, dirige los envíos a través de Make hacia los conjuntos de datos de Braintrust y convierte los fallos de producción en casos de prueba de regresión para una mejora continua de la calidad.
Para patrones más avanzados, como pruebas A/B con múltiples modelos y gestión de versiones de prompts impulsada por cambios en el CMS, explora directamente el endpoint de consultas BTQL y la API de invocación de funciones de Braintrust.
Preguntas frecuentes
No. Braintrust no aparece en el Marketplace de aplicaciones de Webflow. La integración requiere plataformas de automatización (Zapier, Make o viaSocket), código personalizado o llamadas directas a la API. La página de integración de Zapier entre Webflow y Braintrust es lo más parecido a una conexión de un solo clic entre ambas plataformas.
No para el seguimiento del lado del servidor. El código personalizado de Webflow se ejecuta solo en el lado del cliente, en el navegador del visitante; no se admiten lenguajes del lado del servidor. El paquete npm principal es compatible con entornos de navegador desde la versión 1.0.3, y el paquete proporciona un polyfill. El uso del lado del cliente sigue requiriendo un proxy de backend para la autenticación de la clave API. Para sitios en Webflow Cloud, puedes añadir el SDK directamente a tus rutas de API de Next.js o Astro.
braintrust@braintrust/browserAsyncLocalStorageDepende de la magia que quieras hacer. Enlazar a permalinks de Braintrust funciona con cualquier plan de Webflow. Si prefieres insertar elementos de código embebido o añadir código personalizado, necesitarás un plan de pago (Basic o superior). Para integraciones que guarden datos de evaluación en colecciones del CMS, te hará falta al menos un plan CMS (hasta 2000 elementos). El plan Business sube la apuesta a 10 000 elementos y suma publicación masiva.
Nunca pongas una clave de API de Braintrust en el código del lado del cliente de Webflow. Es visible para cualquiera que inspeccione el código fuente de la página o el tráfico de red. Despliega una función serverless que almacene
BRAINTRUST_API_KEYcomo variable de entorno y haz que el frontend de Webflow llame a la URL del proxy. Para despliegues en Webflow Cloud, añade la clave de API como una variable de entorno secreta; las variables secretas están cifradas y no se exponen en la salida de la compilación.
Descripción
Braintrust es una plataforma de evaluación y observabilidad de IA que registra seguimientos, califica resultados y detecta regresiones en funciones basadas en LLM. Conéctala con Webflow para sincronizar datos de evaluación en colecciones de CMS, activar controles de calidad antes de publicar contenido generado por IA y dirigir los envíos de formularios a conjuntos de datos de evaluación.
Esta página de integración se ofrece únicamente con fines informativos y de conveniencia.
Optibase
Conecta Optibase con Webflow para realizar pruebas A/B, personalizar páginas y hacer un seguimiento de las conversiones sin salir de tu sitio.

Optily Webflow Image Optimizer
Conecta Optily, una herramienta de compresión y conversión de imágenes para CMS, con Webflow para reducir el tamaño de tus archivos de imagen y convertir JPG y PNG a WebP.

BulkSEO
BulkSEO exporta los títulos SEO y las meta descripciones de tus páginas de Webflow a un archivo CSV, para que puedas editarlos en una hoja de cálculo e importar los cambios de una sola vez.

NoBreakWeb
Conecta NoBreakWeb, una herramienta de auditoría automatizada de Lighthouse, con Webflow para realizar escaneos diarios de rendimiento, SEO y accesibilidad en tu sitio publicado sin necesidad de pruebas manuales.
Microsoft Clarity
Conecta Microsoft Clarity, una herramienta gratuita de análisis del comportamiento del usuario, con Webflow para capturar grabaciones de sesiones, mapas de calor y señales de frustración como clics de rabia y clics muertos en todo tu sitio.
Humblytics
Conecta Humblytics con Webflow para realizar un seguimiento de visitantes sin cookies, atribuir ingresos y hacer pruebas A/B.

AssetBoost
Conecta AssetBoost con Webflow para generar texto alternativo mediante IA para las imágenes de tu sitio de forma masiva, directamente desde la interfaz de Webflow.

Detector de bloqueadores de anuncios
Conectar Adblock Detector con Webflow te permite identificar a los visitantes que usan bloqueadores de anuncios, medir las tasas de adopción y mostrar contenido alternativo.

Void Analytics
Conecta Void Analytics, una herramienta de análisis centrada en la privacidad, con Webflow para realizar un seguimiento de las visitas a las páginas y el comportamiento de los usuarios sin necesidad de cookies ni de recopilar datos personales.


