agentInvoked meten: welke formulierinzendingen komen via WebMCP?

Door E. Clein · Laatst bijgewerkt 5 september 2026 · 2 min lezen

Je wilt weten of agents een formulier gebruiken. Daarvoor heeft de declaratieve WebMCP-API een interessant aanknopingspunt: agentInvoked op het submit-event. De waarde wordt pas bruikbaar als je precies afbakent welke inzendingen je ermee kunt herkennen.

Wat het veld je vertelt

De Chrome-documentatie over declaratieve tools beschrijft SubmitEvent.agentInvoked als boolean voor een door een agent gestarte formulierinzending. Het hoort bij deze browserroute, niet bij alle manieren waarop software een website kan bedienen.

Een agent die via gewone browserautomatisering klikt, hoeft dus niet als zodanig in deze meting te verschijnen. En als de browser het veld niet ondersteunt, ontbreekt je signaal. Beide situaties als ‘mens’ tellen levert een overtuigend ogend, maar onjuist dashboard op.

Begin met een beperkte observatie

Dit eigen voorbeeld logt alleen het formulier-ID en het beschikbare signaal. Plaats het na je bestaande formulier met ID offerte. Het verstuurt geen analytics en verandert de normale submit-afhandeling niet. Gebruik voor productie je bestaande meetinrichting en privacykeuzes; neem niet zomaar de inhoud van formuliervelden over.

const form = document.getElementById("offerte");

if (form instanceof HTMLFormElement) {
  form.addEventListener("submit", (event) => {
    const signal = typeof event.agentInvoked === "boolean"
      ? (event.agentInvoked ? "webmcp" : "not-marked")
      : "unknown";

    console.info("form-submit-observation", {
      formId: form.id,
      signal,
    });
  });
}

De naam not-marked is bewust gekozen: geen positieve markering is niet hetzelfde als bewezen menselijk verkeer. Houd ook rekening met inzendingen waarbij de clientmeting ontbreekt, bijvoorbeeld doordat de pagina sluit. Een browserlog is geen sluitend register van ontvangen aanvragen.

Kies een noemer die bij het signaal past

Een fictief voorbeeld: je ziet honderd submit-events op één formulier in een testomgeving waar de eigenschap beschikbaar is. Twintig hebben de waarde true. Dan is twintig procent van die waargenomen events gemarkeerd. Je weet daarmee niet dat twintig procent van alle bezoekers, sessies of klanten een agent gebruikt.

Bewaar de onbekende groep zichtbaar naast het percentage. Vergelijk niet ongemerkt een periode met één ondersteunde browser met een periode waarin meer browsers meetellen. Ontdubbel aanvragen op een server-ID als je unieke resultaten wilt tellen; een herhaalde submit is niet automatisch een nieuwe klant.

JavaScript-tools vragen een eigen meetpunt

Voor imperatieve tools kun je in je eigen execute-functie een aanroep en uitkomst registreren. Dat is applicatietelemetrie, niet dezelfde submit-eventmeting. Het bewijst dat deze toolroute is gebruikt, niet de identiteit of bedoeling van de aanroeper.

Leg een beperkte correlatie-ID vast waarmee je de aanroep aan het serverresultaat koppelt. Vermijd persoonsgegevens en volledige prompts in logs. Houd mislukte validatie, succesvolle opslag en onbekende afloop uit elkaar; een timeout bewijst geen mislukking.

De belangrijkste vervolgvraag is uiteindelijk niet hoeveel agents je ziet, maar of hun aanvragen correct aankomen. Gebruik het signaal om dat verschil te onderzoeken, niet om een volledig beeld van agentverkeer te claimen.