Herramientas del agente
Lee una página con Browser MCP
Un agente puede leer una página llamando a herramientas de navegador por el Model Context Protocol. Este laboratorio reproduce un recorrido grabado de esas llamadas. La pregunta se queda en la página.
Entender el laboratorioCómo usarlo y por qué querrías hacerlo
Por qué querrías hacerlo
Quieres un agente que pueda leer una página y mostrar la herramienta que llamó. La pregunta debe quedarse aquí, y el navegador debe quedarse en este sitio.
Cómo usarlo
- Acepta y pulsa Siguiente en el ejemplo.
- Mira las llamadas de ejemplo, la instantánea y la respuesta.
- Abre un enlace de origen. Es una página de este sitio.
- 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 Browser MCP reproduce un recorrido de herramientas grabado para una pregunta sobre este sitio. La navegación se queda en este origen, las herramientas son de solo lectura y la pregunta no se registra. Después de Aceptar encola mcp_question_asked, mcp_tool_called y mcp_answer_shown. El laboratorio no llama a Adobe.
Elegir un recorrido grabado
pickTrace casa palabras de dataLayer o de medición y devuelve un recorrido fijo. La pregunta no se copia en el recorrido y no se escribe en un registro.
Quedarse en este origen
isAllowedNavigation acepta solo el origen de este sitio, y solo una ruta de laboratorio o la portada. Un usuario, una contraseña u otro host devuelve false. traceIsReadOnly también rechaza un envío.
Limitar la ruta
allowMcp detiene la novena petición de una IP en diez minutos en esa instancia. La respuesta es rate_limited y no incluye la pregunta. Una regla de firewall delante es el límite durable.
Reproducir las llamadas y luego la respuesta
El panel revela cada llamada de herramienta, luego la instantánea de accesibilidad recortada, y luego la respuesta y sus enlaces de origen. El movimiento reducido muestra los pasos sin la espera. La página no lanza un navegador.
Encolar solo el nombre de la herramienta
Después de Aceptar, demonstrateEvent envía mcp_question_asked sin parámetros, mcp_tool_called con el nombre de la herramienta y mcp_answer_shown sin el texto de la respuesta. Con el consentimiento apagado se saltan la ruta y los eventos.
Del código
Solo este origen, y solo una ruta de laboratorio o la portada.
export function isAllowedNavigation(value: string) {
try {
const url = new URL(value)
if (url.origin !== SITE_ORIGIN) return false
if (url.username || url.password) return false
if (!url.pathname.startsWith("/")) return false
return url.pathname === "/" || url.pathname.startsWith("/lab") || url.pathname.startsWith("/es")
} catch {
return false
}
}El tope va primero. La pregunta elige un recorrido y no se devuelve.
export async function POST(request: NextRequest) {
if (!allowMcp(mcpClientIp(request.headers))) {
return json({ error: "rate_limited" }, 429)
}
let body: unknown
try {
body = await request.json()
} catch {
return json({ error: "invalid_json" }, 400)
}
const record = body && typeof body === "object" ? (body as Record<string, unknown>) : {}
const question = typeof record.question === "string" ? record.question.replace(/\s+/g, " ").trim().slice(0, 240) : ""
if (!question) return json({ error: "empty" }, 400)
const trace = pickTrace(question)
if (!traceIsReadOnly(trace)) return json({ error: "trace_rejected" }, 500)
return json(publicTrace(trace))Cada herramienta revelada encola su nombre. El evento de respuesta no lleva texto.
for (let index = 0; index < payload.tools.length; index += 1) {
await wait(700)
setShown(index + 1)
demonstrateEvent("mcp_tool_called", { tool: payload.tools[index]?.tool ?? "" })
}
await wait(400)
setAnswerOn(true)
demonstrateEvent("mcp_answer_shown", {})Google y Adobe
Google encola mcp_tool_called después de Aceptar. Adobe es un ejemplo de los mismos campos.
Después de Aceptar, este laboratorio encola mcp_question_asked sin parámetros, luego mcp_tool_called solo con el nombre de la herramienta, y luego mcp_answer_shown sin el texto de la respuesta. Los argumentos, la instantánea y la pregunta se quedan en la página. Registra tool como dimensión personalizada con alcance de evento. Este sitio no llama a gtag('set') ni a Adobe.
Forma simplificada del objeto encolado después de Aceptar. Registra cualquier parámetro nuevo como dimensión personalizada con alcance de evento. Este sitio no llama a gtag('set').
dataLayer.push({
event: "mcp_tool_called",
tool: "browser_snapshot",
})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: {
mcpTool: "browser_snapshot",
},
},
})Hit de ejemplo. eVar118 tiene alcance de hit en este ejemplo. prop118 muere en el mismo hit.
s.eVar118 = "browser_snapshot"
s.prop118 = "browser_snapshot"
s.events = "event118"
s.linkTrackVars = "eVar118,prop118,events"
s.linkTrackEvents = "event118"
s.tl(true, "o", "mcp_tool_called")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.
Pregunta hecha
GA4. Evento mcp_question_asked después de Aceptar. Sin parámetros. El texto de la pregunta no se envía.
Adobe. event118 de ejemplo. Este sitio no llama a Adobe. No pongas la pregunta en una eVar.
Alcance. Evento. Una propiedad de usuario recordaría que se hizo una pregunta.
Herramienta llamada
GA4. Evento mcp_tool_called. El parámetro tool es browser_navigate, browser_snapshot, browser_click o browser_evaluate. Los argumentos no se envían.
Adobe. eVar118 de ejemplo para el nombre de la herramienta, Most Recent, expira en el hit. Este sitio no llama a Adobe.
Alcance. Evento. Una propiedad de usuario conservaría la última herramienta después de la llamada siguiente.
Respuesta mostrada
GA4. Evento mcp_answer_shown cuando la respuesta de ejemplo está en la página. Sin el texto de la respuesta.
Adobe. event118 de ejemplo. Este sitio no llama a Adobe. No pongas la respuesta en una prop.
Alcance. Evento. Registra que se mostró una respuesta, no lo que decía.
URL de navegación
GA4. No es un parámetro. La URL de ejemplo se comprueba contra este origen y luego se muestra en la página.
Adobe. prop118 de ejemplo. No se envía. Este sitio no llama a Adobe.
Alcance. Texto de la página. No es un parámetro de evento ni una propiedad de usuario.
Recorrido de ejemplo
Acepta la medición para registrar el paso. El ejemplo igual avanza. No se envía nada antes de Aceptar.
Preguntar
Recorrido de ejemplo. La pregunta se queda en esta página. La llamada grabada es browser_navigate a /lab.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": { "name": "browser_navigate", "arguments": { "url": "https://www.blackboxpersonalization.com/lab" } }
}Respuesta
Avanza para ver este resultado.
Cliente, servidor, herramientas
- El cliente es el agente. Pregunta al servidor qué herramientas hay y luego llama a una herramienta cada vez.
- El servidor es el adaptador del navegador. Expone una lista de herramientas y ejecuta una llamada.
- Una llamada de herramienta es una petición JSON-RPC con un nombre y argumentos. El resultado es el mensaje siguiente.
Seguridad
- La navegación se queda en el origen de este sitio. Cualquier otro host se rechaza.
- La lista de herramientas es de solo lectura: navegar, instantánea, pulsar un enlace y evaluar una lectura. No hay envío de formulario.
- La ruta permite ocho peticiones de una IP en diez minutos en esa instancia. Una regla de firewall es el límite durable.
- Aceptar va primero. La pregunta no se registra y no es un parámetro de los eventos.
Dos formas de ejecutarlo
Esta página usa recorridos grabados. Un navegador en vivo es una elección posterior, no lo que ejecutan los visitantes aquí. Las cifras de abajo son una estimación de planificación, no una factura.
Recorrido grabado
Una función corta devuelve JSON. Sin Chromium, sin llamada a un modelo, y la lista de herramientas no puede salir de este origen. El coste se queda en una fracción de céntimo por pregunta, sobre todo la invocación de la función.
Playwright MCP en vivo
Un Sandbox de Vercel o una función grande arrancaría Chromium unos 15 a 30 segundos, a menudo cerca de 1 GB. Calcula de varios céntimos a unas decenas de céntimos por pregunta antes de cualquier token de modelo, más una cola para que una ráfaga no arranque un navegador por cada clic.
Deja el laboratorio público en recorridos grabados. Un navegador en vivo, si se añade después, va detrás de la misma lista de orígenes, las mismas herramientas de solo lectura y un tope duro.
Recomendado a continuación
Por qué estas propuestasLeyendo las transiciones de recorrido…