Clase 3 · 18 min
Una tool de WebMCP es un objeto con nombre, descripción, esquema de entrada y una función execute. La página la registra; el agente las lista con getTools y la llama con executeTool. En esta clase lees la tool de búsqueda del kit, la llamas como la llamaría un agente y registras la tuya.
Empezar la lección
Objetivo: registrar una tool con nombre, descripción, inputSchema y execute, y llamarla como la llamaría un agente, viendo el resultado y la pantalla.
Haz clic en cada paso.
Spec del 16/10/2026 y Chromium 156.0.8078.4. Si cambia, la clase 1 avisa: confirma la fecha antes.
Fragmento de kit/pagina/ferramentas.mjs. La misma agenda.buscar atiende el formulario y la tool.
{
name: 'buscar_oficinas',
title: 'Buscar oficinas',
description: 'Lista as oficinas da agenda por tema. Só lê: não reserva nada. Use apenasComVaga=true para ver só as que ainda têm vaga.',
inputSchema: {
type: 'object',
properties: {
tema: { type: 'string', enum: TEMAS, description: 'Tema da oficina.' },
apenasComVaga: { type: 'boolean', description: 'true = só oficinas com vaga.' }
},
additionalProperties: false
},
annotations: { readOnlyHint: true },
execute: comErroUtil(async input => {
const lista = agenda.buscar(input);
ui.mostrarResultados(lista, input); // a pessoa vê o mesmo que o agente recebeu
return { total: lista.length, oficinas: lista };
})
}const mc = document.modelContext; // nombre actual (16/10/2026)
if (!mc || typeof mc.registerTool !== 'function') {
aviso?.('Este navegador não expõe WebMCP. Tudo funciona pelo formulário.');
return { modo: 'sem', registradas: 0 };
}
const pagina = new AbortController();
addEventListener('pagehide', () => pagina.abort(), { once: true });
await registrar(mc, defs, pagina.signal);listar.mjs hace getTools; executar.mjs hace executeTool con el objeto que le pasas y muestra la pantalla después.
cd ~/projetos/formacao-webmcp-site-v72/kit
node scripts/listar.mjs nativo
node scripts/executar.mjs nativo buscar_oficinas '{"tema":"webmcp","apenasComVaga":true}'; echo "saída: $?"== Chromium 156.0.8078.4 (Playwright) · modo: nativo
buscar_oficinas readOnlyHint
listar_comentarios readOnlyHint, untrustedContentHint
minhas_reservas readOnlyHint
reservar_vaga consequentialHint
4 ferramentas registradas
== Chromium 156.0.8078.4 (Playwright) · modo: nativo
resultado (string): {"total":1,"oficinas":[{"id":"of-301","titulo":"Primeira ferramenta WebMCP","tema":"webmcp","data":"2026-11-18","vagas":4}]}
tela · resultados: 1 · reservas: Nenhuma reserva.
saída: 0"resultado (string)": el navegador devuelve texto JSON, como manda la spec. La lista de la pantalla también quedó con 1 taller.
== Chromium 156.0.8078.4 (Playwright) · modo: nativo navigator.modelContext (nome antigo): undefined entrada em texto JSON em vez de objeto: TypeError execute que lança: UnknownError: Tool was executed but the invocation failed. For example, the script function threw an error == Chromium 156.0.8078.4 (Playwright) · modo: polyfill navigator.modelContext (nome antigo): undefined entrada em texto JSON em vez de objeto: TypeError execute que lança: UnknownError: Tool execution failed
Los ejemplos antiguos pasaban JSON.stringify(input) para esquivar una implementación de septiembre: hoy da TypeError en los dos. Y el motivo de un throw no le llega al agente (UnknownError genérico). Por eso el kit devuelve { erro } como dato (clase 7).
El bloque copia la página a un ensayo, escribe un extras.mjs con contar_vagas y lo verifica. Para que valga en el kit, pega la misma lista en kit/pagina/extras.mjs.
cd ~/projetos/formacao-webmcp-site-v72/kit
E=${TMPDIR:-/tmp}/ensaio-webmcp-site/a3; rm -rf $E; mkdir -p $E; cp -r pagina/. $E/
cat > $E/extras.mjs <<'FIM'
export function extras(agenda) {
return [{
name: 'contar_vagas',
description: 'Soma as vagas livres das oficinas de um tema. Só lê: não reserva nada.',
inputSchema: {
type: 'object',
properties: { tema: { type: 'string', enum: ['html', 'javascript', 'webmcp', 'mcp'], description: 'Tema da oficina.' } },
required: ['tema'],
additionalProperties: false
},
annotations: { readOnlyHint: true },
async execute({ tema }) {
const lista = agenda.buscar({ tema });
return { tema, vagas: lista.reduce((soma, o) => soma + o.vagas, 0) };
}
}];
}
FIM
PAGINA=$E node scripts/listar.mjs nativo | tail -1
PAGINA=$E node scripts/executar.mjs nativo contar_vagas '{"tema":"html"}'; echo "saída: $?"5 ferramentas registradas
== Chromium 156.0.8078.4 (Playwright) · modo: nativo
resultado (string): {"tema":"html","vagas":3}
tela · resultados: 6 · reservas: Nenhuma reserva.
saída: 0Antes del extras.mjs, la cuenta era 4. La suma de HTML: 3 cupos en of-101 y 0 en of-102.
Modo nativo; cámbialo por polyfill si quieres comparar. Cada ejercicio termina con un listo cuando.
Ejecuta listar y executar. Cambia el tema a html y luego a cobol, y compara.
Listo cuando: node scripts/executar.mjs nativo buscar_oficinas '{"tema":"webmcp","apenasComVaga":true}' → resultado (string): {"total":1, y saída: 0; con cobol → {"erro":"tema inválido: cobol"}.
Pega la lista de contar_vagas en kit/pagina/extras.mjs (dentro del return [ ]).
Listo cuando: node scripts/listar.mjs nativo | tail -1 → 5 ferramentas registradas (antes: 4).
Escribe otra herramienta de solo lectura en extras.mjs, por ejemplo proxima_oficina (la de fecha más cercana). Nombre con _, descripción que diga lo que no hace, schema cerrado.
Listo cuando: node scripts/executar.mjs nativo [nome] '{}' → resultado (string): con el JSON esperado y saída: 0.
La explicación aparece después de la respuesta.
Pregunta 1 de 4
¿Qué devuelve executeTool en la spec del 16/10/2026?
Pregunta 2 de 4
¿Qué nombre de herramienta rechaza registerTool?
Pregunta 3 de 4
¿Por qué la búsqueda del kit llama a ui.mostrarResultados dentro del execute?
Pregunta 4 de 4
Un tutorial manda llamar executeTool(t, JSON.stringify(entrada)). ¿Qué pasa en Chromium 156?
Elige una alternativa. La explicación aparece después de tu intento.