Chatbot
Construye un chatbot del sitio
Una pregunta se casa con páginas que ya están en este sitio. Un modelo pequeño responde con esos extractos y la respuesta enlaza de vuelta. Aceptar va primero. La pregunta no se guarda.
Entender el laboratorioCómo usarlo y por qué querrías hacerlo
Por qué querrías hacerlo
Quieres un asistente que responda con páginas que ya publicaste. Debe mostrar el origen y no guardar la pregunta.
Cómo usarlo
- Acepta la medición y luego pregunta con un inicio o escribe una pregunta.
- Mira las etapas y abre Rastrear para la lista de eventos.
- Lee los extractos y abre un enlace de origen.
- Abre Cómo lo hicimos para el código y el mapa de eventos.
RecorridoCómo lo hicimosMostrarOcultar
El ajuste de proveedor de ejemplo está marcado abajo. Los números de eVar y de event son ejemplos. Este laboratorio no llama a Adobe.
El laboratorio de chatbot pregunta a la misma ruta /api/chat que el asistente de la esquina. La búsqueda elige extractos de los laboratorios, las tablas de Cómo lo hicimos y las notas. Un modelo pequeño responde solo con esos extractos cuando AI_GATEWAY_API_KEY o el token OIDC de Vercel están definidos. Si no, la ruta cita la página más cercana. Después de Aceptar, las dos superficies hacen push de eventos de chat al dataLayer. La pregunta y la respuesta no son parámetros. Este laboratorio no llama a Adobe.
Cargar el asistente solo después de Aceptar
ChatGate no pinta nada hasta que se concede el consentimiento, y entonces importa el fragmento del chat. Rechazar y la falta de elección dejan la esquina vacía. El panel Probar de este laboratorio usa la misma compuerta y no llama a la ruta antes de Aceptar.
Buscar un índice construido desde el repositorio
chatIndex lee la prosa del recorrido, las filas de ejemplo de Adobe y GA4 y las notas del blog cuando se carga el módulo. retrieve puntúa la pregunta contra ese texto y devuelve los mejores fragmentos con sus URL. No llama al modelo.
Anclar el modelo a esos extractos
El prompt del sistema dice que use solo los extractos, que no invente números y que responda en español cuando la pregunta está en español. La ruta envía los extractos. No envía un secreto y no registra el prompt.
Rechazar una propiedad en vivo
asksAboutLiveAccount detiene las preguntas sobre una propiedad de Launch en vivo, una propiedad de GA4 en vivo o una cuenta antes de cualquier llamada al modelo. La columna de Adobe de ejemplo de esta página sigue permitida. El rechazo dice que las tablas son ejemplos.
Limitar la ruta y fallar a la vista
allowChat detiene la novena pregunta de una IP en diez minutos en esa instancia. Una regla de firewall delante es el límite durable. Si el modelo falla, se agota el tiempo o falta la clave, la ruta devuelve el comienzo de la página más cercana y los enlaces de origen.
Enviar el evento, no el mensaje
Después de Aceptar, trackChatEvent hace push de un objeto al dataLayer y vuelve sin enviar cuando el consentimiento está apagado. No llama a gtag para estos eventos. chat_open, starter_used, question_asked, answer_shown y source_clicked se disparan en la esquina y en este panel. chat_close se dispara cuando se cierra el panel de la esquina. La pregunta y la respuesta no son campos.
Del código
El asistente de la esquina se importa solo después de Aceptar.
export function ChatGate() {
const { consent } = useConsent()
const [Chat, setChat] = useState<ComponentType | null>(null)
useEffect(() => {
if (consent !== "granted") return
let cancel = false
void import("@/components/chat/site-chat").then((mod) => {
if (!cancel) setChat(() => mod.SiteChat)
})
return () => {
cancel = true
}
}, [consent])
if (consent !== "granted" || !Chat) return null
return <Chat />La longitud y la latencia se vuelven cubos. El texto de la pregunta y el conteo en milisegundos no se envían.
/** 1–80 characters is short, 81–200 is medium, 201 or more is long. */
export function questionLengthBucket(length: number): QuestionLength {
const size = Number.isFinite(length) ? Math.max(0, Math.floor(length)) : 0
if (size <= 80) return "short"
if (size <= 200) return "medium"
return "long"
}
/** Under 2 seconds, 2 through 5 seconds, or over 5 seconds. */
export function latencyBucket(ms: number): LatencyBucket {
if (!Number.isFinite(ms) || ms < 2000) return "under_2s"
if (ms <= 5000) return "2_5s"
return "over_5s"
}La llamada al Gateway. La clave se queda en el entorno. La telemetría está apagada para no exportar el prompt.
try {
const result = streamText({
model: gateway(chatModelName() as GatewayModelId),
system: systemPrompt(language),
prompt: userPrompt(question, chunks),
maxOutputTokens: 450,
maxRetries: 0,
abortSignal: AbortSignal.timeout(12_000),Google y Adobe
Google encola chat_open después de Aceptar. Adobe es un ejemplo de los mismos campos.
Después de Aceptar, el asistente de la esquina y este panel Probar hacen push de estos objetos con dataLayer.push. No llaman a gtag para estos eventos. chat_open, starter_used, question_asked, answer_shown y source_clicked se disparan en las dos superficies. chat_close se dispara cuando se cierra el panel de la esquina. El panel del laboratorio se queda en la página, así que no hace push de chat_close. Cada objeto incluye chat_surface y chat_locale. La pregunta, la respuesta y la IP no son parámetros. Registra chat_surface, chat_locale, chat_starter_id, chat_question_length, chat_status, chat_latency_bucket y chat_source_path como dimensiones personalizadas con alcance de evento, y chat_source_count como métrica personalizada con alcance de evento. Este sitio no llama a gtag('set') ni a Adobe.
Se envía cuando el panel está disponible después de Aceptar. Sin más campos.
dataLayer.push({
event: "chat_open",
chat_surface: "lab",
chat_locale: "en",
})Solo el id del inicio. No la frase del botón.
dataLayer.push({
event: "starter_used",
chat_surface: "lab",
chat_locale: "en",
chat_starter_id: "datalayer",
})short es de 1 a 80 caracteres, medium de 81 a 200, y long es 201 o más.
dataLayer.push({
event: "question_asked",
chat_surface: "lab",
chat_locale: "en",
chat_question_length: "short",
})ok, fallback o refused. El conteo es un entero. El cubo es under_2s, 2_5s o over_5s.
dataLayer.push({
event: "answer_shown",
chat_surface: "lab",
chat_locale: "en",
chat_status: "fallback",
chat_source_count: 2,
chat_latency_bucket: "under_2s",
})Solo la ruta. La cadena de consulta no se incluye.
dataLayer.push({
event: "source_clicked",
chat_surface: "lab",
chat_locale: "en",
chat_source_path: "/lab/datalayer",
})El panel de la esquina lo envía al cerrarse. El panel del laboratorio no.
dataLayer.push({
event: "chat_close",
chat_surface: "corner",
chat_locale: "en",
})Implementación de ejemplo. Este sitio no llama a Adobe. eVar118, prop118 y event118 son números de variable de ejemplo. En Launch, un elemento de datos lee el valor y una regla lo envía cuando el valor cambia. En el report suite, habilita eVar118 con asignación Most Recent y haz que expire en el hit. Una processing rule no hace falta si el elemento de datos se mapea directo a esa eVar.
Payload de alloy de ejemplo. _example es un esquema de relleno, no un inquilino real.
alloy("sendEvent", {
xdm: {
eventType: "web.webinteraction.linkClicks",
_example: {
chatSurface: "lab",
},
},
})Hit de ejemplo. eVar118 tiene alcance de hit en este ejemplo. prop118 muere en el mismo hit.
s.eVar118 = "lab"
s.prop118 = "lab"
s.events = "event118"
s.linkTrackVars = "eVar118,prop118,events"
s.linkTrackEvents = "event118"
s.tl(true, "o", "chat_open")Traducción
Cada campo del laboratorio, el nombre en GA4 y la variable de Adobe de ejemplo. El alcance es la parte que suele perderse en la traducción.
Chat abierto
GA4. Evento chat_open después de Aceptar. Los parámetros son chat_surface, corner o lab, y chat_locale, en o es.
Adobe. event118 de ejemplo. eVar118 de ejemplo podría llevar chat_surface. Este sitio no llama a Adobe.
Alcance. Evento. Una propiedad de usuario recordaría que el chat se abrió.
Inicio usado
GA4. Evento starter_used. chat_starter_id es datalayer, beacon, utm o adobe. También chat_surface y chat_locale. No la frase del inicio.
Adobe. eVar118 de ejemplo para el id del inicio, Most Recent, expira en el hit. Este sitio no llama a Adobe.
Alcance. Evento. El id basta. La frase ya está en la página.
Pregunta hecha
GA4. Evento question_asked. chat_question_length es short, medium o long. short es de 1 a 80 caracteres, medium de 81 a 200, y long es 201 o más. El texto de la pregunta no se envía.
Adobe. prop118 de ejemplo con short, medium o long. No pongas la pregunta en una prop. Este sitio no llama a Adobe.
Alcance. Evento. Una propiedad de usuario conservaría el último cubo de longitud después de la pregunta siguiente.
Respuesta mostrada
GA4. Evento answer_shown. chat_status es ok, fallback o refused. chat_source_count es un entero. chat_latency_bucket es under_2s, 2_5s o over_5s. El texto de la respuesta no se envía.
Adobe. prop118 de ejemplo para chat_status y event118 de ejemplo. Este sitio no llama a Adobe.
Alcance. Evento. Un estado con alcance de usuario se quedaría después de la respuesta siguiente.
Origen pulsado
GA4. Evento source_clicked. chat_source_path es una ruta como /lab/datalayer. También chat_surface y chat_locale. No la pregunta.
Adobe. eVar118 de ejemplo para la ruta, expira en el hit. Este sitio no llama a Adobe.
Alcance. Evento. La ruta es una página de este sitio, no un rasgo del perfil.
Chat cerrado
GA4. Evento chat_close cuando se cierra el panel de la esquina. Los parámetros son solo chat_surface y chat_locale. El panel del laboratorio no lo envía.
Adobe. event118 de ejemplo. Este sitio no llama a Adobe.
Alcance. Evento. Una propiedad de usuario recordaría que el panel se cerró.
Probar
Este panel llama a POST /api/chat, la misma ruta que el asistente de la esquina. Las etapas de abajo se encienden cuando llega la respuesta. Los extractos son las páginas recuperadas. El prompt y la clave se quedan en el servidor.
Acepta la medición para hacer una pregunta. Hasta entonces este panel no llama a la ruta.
- Pregunta
- Búsqueda
- Extractos
- Modelo
- Respuesta
Eventos enviados
0 en esta pestaña
Acepta la medición antes de que se envíen estos eventos. Rechazar y la falta de elección no envían nada.
Constrúyelo tú
- Instala el AI SDK y llama al AI Gateway con un modelo pequeño, como gpt-4o-mini.
- Define AI_GATEWAY_API_KEY en el host. La página nunca imprime la clave.
- Construye un índice de tus páginas cuando arranca el servidor, y guarda la URL de cada fragmento.
- Envía al modelo solo los mejores extractos, y dile que responda a partir de ellos.
- Rechaza una pregunta sobre una propiedad de Launch en vivo, una propiedad de GA4 en vivo o una cuenta.
- Limita la ruta y añade una regla de firewall. No registres la pregunta ni la respuesta.
- Carga el asistente solo después de que el visitante acepte la medición.
- Después de Aceptar, haz push de chat_open, starter_used, question_asked, answer_shown, source_clicked y chat_close al dataLayer. Envía chat_surface, chat_locale y los campos propios del evento. Nunca envíes la pregunta ni la respuesta, y no llames a gtag para estos eventos.
Recomendado a continuación
Por qué estas propuestasLeyendo las transiciones de recorrido…