Bouw agentgebaseerde workflows voor uw gebruikers met WebMCP-tools.

André Cipriani Bandarra

Gepubliceerd: 26 augustus 2026

Uitleg Web Uitbreidingen Chrome-status Intentie
GitHub Oorsprongsproef Oorsprongsproef Weergave Voornemen om te experimenteren

WebMCP zorgt voor een consistente gebruikerservaring wanneer gebruikers via een agent op uw website communiceren. Of de agent nu in een browser, een extensie of ingebed in uw website actief is, uw tools moeten zo ontworpen zijn dat ze gebruikers ondersteunen bij het uitvoeren van de vereiste taken en het bereiken van bepaalde doelen.

Ontwikkelaars hebben gevraagd welke WebMCP-tools ze zouden moeten bouwen en beschikbaar stellen aan agents. Er is geen eenduidig ​​antwoord, omdat de gebruiksscenario's en vereisten voor WebMCP op het web sterk uiteenlopen.

Volg in plaats daarvan dit raamwerk om beter te begrijpen hoe u tools kunt definiëren en bouwen die nuttig zijn voor uw website of webapplicatie.

Definieer het doel van de gebruiker

Gebruikers communiceren met een agent met een specifiek doel voor ogen, variërend van eenvoudige vragen tot complexe workflows. Houd bij het definiëren van deze doelen rekening met het volgende:

  • Wat is het ideale resultaat? Definieer duidelijk wat "succes" voor de gebruiker inhoudt.
  • Welke context is vereist? Bepaal welke specifieke informatie of gegevens de agent nodig heeft om het doel te bereiken.
  • Wat zijn de grenzen? Definieer wat de agent niet mag doen of welke acties beperkt zijn.
  • Welke doelen moeten prioriteit krijgen? Begin met het identificeren van trajecten waar agentondersteuning de meeste toegevoegde waarde biedt. Zoek naar mogelijkheden waarbij een conversationele aanpak een natuurlijker, efficiënter of intuïtiever pad biedt voor de gebruiker om zijn of haar doel te bereiken, vergeleken met een UI-gestuurde ervaring.
De agent gebruikt één tool, findClient, om contactgegevens te verkrijgen.
Wanneer de gebruiker een agent vraagt ​​om contactgegevens op te zoeken, roept de agent één WebMCP-tool aan om de taak te voltooien: findClient .

Deze doelen moeten relevant zijn voor uw product en de bestaande functionaliteiten ondersteunen. Als uw product een CRM-systeem is, hoeft u geen tools te ontwikkelen voor het boeken van vluchten. Het doel van de gebruiker kan één enkele stap vereisen, zoals het vinden van contactgegevens van een klant. Of het kan complexer zijn, zoals het samenvatten van de notulen van een vergadering en het opstellen van een vervolg-e-mail.

Uw tools moeten alle acties vergemakkelijken die nodig zijn om het doel van de gebruiker te bereiken.

Het enige verzoek van de gebruiker heeft betrekking op drie mogelijke UI-componenten: de videovergadering, een notitiedocument en e-mail.
De gebruiker vraagt ​​de agent om na een vergadering een vervolg-e-mail te sturen. De agent gebruikt hiervoor drie WebMCP-tools: recordTranscript , summarizeNotes en draftEmail .

Definieer de begintoestand

Zodra je het doel van de gebruiker begrijpt, bepaal je de "startpositie". De beginsituatie definieert de omgeving en context voordat de agent in actie komt.

Houd rekening met de volgende dimensies:

  • Applicatiestatus : Waar bevindt de gebruiker zich in uw product? Welke gegevens zijn zichtbaar of actief? Bijvoorbeeld: Bekijkt de gebruiker een specifiek project, het dashboard of de instellingen?
  • Context van de agent : Wat is er al besproken? Welke informatie bezit de agent al en welke informatie mist hij nog?
  • Systeembeperkingen : Zijn er actieve filters, gebruikersrechten of systeemwijde instellingen die beperken wat de agent direct kan doen? Als het doel bijvoorbeeld vereist dat de gebruiker is ingelogd, start de workflow dan vóór of na de login?

Als dit eenmaal is vastgesteld, kunt u beter bepalen welke tools de agent vanaf het begin nodig heeft om effectief te zijn. Mogelijk zijn er later in de interactie nog aanvullende tools nodig, die u kunt ontdekken door het scenario na te spelen.

Oefen het gesprek door middel van rollenspel.

Rollenspellen simuleren het volledige gesprek tussen de gebruiker en de agent. Zo kun je bepalen welke tools de website nodig heeft om elke stap te ondersteunen en hoe de website moet reageren wanneer die tools worden opgeroepen.

Volg deze procedure om uw aannames te testen:

  1. Breng het gesprek in kaart : Stel je de volledige interactie voor, stap voor stap, van het initiële doel van de gebruiker tot de uiteindelijke oplossing. Het gesprek moet weerspiegelen hoe eindgebruikers je product gebruiken, en niet hoe interne teams het gebruiken.
  2. Analyseer de behoeften van de tool en de website : Stel bij elke stap de volgende vragen:
    • Welke informatie heeft de agent van uw product nodig om te kunnen reageren?
    • Welke handelingen moet het verrichten?
    • Welke instrumenten zijn nodig om die acties te ondersteunen?
    • Hoe moet uw website reageren wanneer deze tools worden aangeroepen?
  3. Herhalen en verfijnen : Als u tijdens deze simulatie een hiaat of een ontbrekend hulpmiddel constateert, herhaal dan stap 1 en 2 om uw plan te verfijnen. Hervat vervolgens de simulatie.

Breng het in de praktijk

Om dit in de praktijk te zien, doorlopen we een scenario voor het boeken van een vlucht voor een zakenreis. Stel je voor dat een gebruiker op het reisdashboard een vlucht naar New York wil boeken voor aanstaande dinsdag.

  1. Definieer het doel van de gebruiker : Een vlucht boeken die voldoet aan het bedrijfsbeleid.
  2. Definieer de beginsituatie : De gebruiker bevindt zich op het reisdashboard. De agent heeft toegang tot het bedrijfsprofiel van de gebruiker, inclusief opgeslagen voorkeuren (zoals luchtvaartmaatschappij en ticketklasse).
  3. Oefen de interactie : de gebruiker vraagt ​​naar de opties, voegt criteria toe en boekt een vlucht.

Speel de interactie na door middel van rollenspel.

Eerste verzoek :

  1. Gebruiker : "Ik heb een vlucht naar New York nodig voor aanstaande dinsdag."
  2. Agent : "Daar kan ik u mee helpen. Wanneer wilt u terugkomen?"
  3. Gebruiker : "Ik kom die vrijdag terug."
  4. De agent voert twee acties uit: get_user_profile() en return home_airport . Vervolgens search_flights(origin=home_airport, destination="JFK", date="2023-10-24", return_date="2023-10-27")
  5. De site toont vluchtresultaten van home_airport naar JFK voor 24-27 oktober.
  6. Agent : "Ik heb 50 vluchten gevonden. Hoe wilt u ze sorteren of filteren?"

Heroverweeg en verfijn :

  1. Gebruiker : "Dat zijn eigenlijk te veel opties. Ik wil alleen rechtstreekse vluchten in de economy class."
  2. De agent voert de volgende actie uit: filter_flights(criteria={"stops": 0, "class": "economy"}) .
  3. De site toont vluchtresultaten van home_airport naar JFK voor 24-27 oktober, gefilterd op rechtstreekse vluchten en economy class.
  4. Agent : "Hier zijn de 3 rechtstreekse vluchten in de economy class die aan uw verzoek voldoen."

De boeking afronden :

  1. Gebruiker : "De ochtendvlucht van Delta ziet er goed uit."
  2. De agent gebruikt de tool lookup_flight(airline='DL') om de relevante vlucht-ID te verkrijgen en boekt vervolgens de vlucht: book_flight(flight_id="delta_123") .
  3. De website toont de boekingsbevestiging voor vlucht delta_123 .
  4. Agent : "Ik heb dat voor u geboekt."

Volgordediagram

Open het volledige sequentiediagram .

Adresafwijking

Een gebruiker kan vaag zijn wanneer hij of zij een agent om hulp vraagt. Bijvoorbeeld: "Ik moet volgende week naar New York." Deze vraag geeft geen specifieke dag aan, dus je moet tools ontwikkelen die flexibel genoeg zijn zodat de agent naar ontbrekende parameters kan vragen ("Welke dag volgende week?"), in plaats van aannames te doen die tot een fout kunnen leiden.

Door op deze variaties in rollenspel te anticiperen, zorgt u ervoor dat uw hulpmiddelen de agent de nodige informatie verschaffen om onduidelijkheden effectief op te lossen.

Faal op een gecontroleerde manier en maak herstel mogelijk.

Wanneer een agent een tool probeert uit te voeren in een ongeldige staat, met onjuist geformuleerde parameters, of wanneer een tool onverwachte gegevens ontvangt van een onderliggend systeem, moet het antwoord als leidraad dienen in plaats van als een doodlopende weg. Geef altijd contextbewuste feedback om de agent te helpen herstellen; vermijd het retourneren van generieke foutmeldingen, onbewerkte API-fouten of het stilzwijgend falen.

Bijvoorbeeld:

  • Onjuiste status of ontbrekende voorwaarden : Als een agent filter_flights aanroept voordat search_flights is uitgevoerd, antwoord dan met: "Geen vluchtzoekresultaten gevonden. Zoek eerst naar vluchten."
  • Ongeldige parameters : Als een tool een datum in het formaat YYYY-MM-DD verwacht, maar een ander formaat ontvangt, retourneer dan: "Ongeldig datumformaat. Geef de datum op in het formaat JJJJ-MM-DD."
  • Onverwachte retourwaarden : Als een tool een externe service raadpleegt en een leeg of onjuist resultaat ontvangt, retourneer dan: "Geen vluchten gevonden die aan uw criteria voldoen. Probeer uw zoekparameters aan te passen."
  • Schendingen van de bedrijfslogica : Als een actie een specifieke bedrijfsregel schendt, zoals het aanroepen cancel_order op een artikel dat al verzonden is, retourneer dan: "Bestelling 123 is al verzonden. Leid de gebruiker door naar het retourbeleid."

Door expliciete, bruikbare feedback te geven, stelt u de agent in staat de gebruiker direct te informeren en het gesprek effectief bij te sturen, waardoor verwarring wordt voorkomen en een naadloze ervaring wordt gegarandeerd.

Evalueer uw gereedschap

Het documenteren van gebruikersdoelen, toestandsovergangen en gesprekspaden biedt een blauwdruk voor het bouwen van geautomatiseerde evaluaties (evals) . Bij het testen van systemen die gebruikmaken van generatieve AI, moet je rekening houden met probabilistische uitkomsten die niet overeenkomen met je verwachtingen. Evals kunnen je helpen bij het verifiëren van consistente toolselectie, parameterextractie en toestandsbeheer.

Implementeer naar productie

Rollenspellen zijn geweldig voor het eerste prototype van een tool. Om het in productie te nemen, moet je het aanvullen met telemetriegegevens uit de praktijk.

Nadat de tool is geïmplementeerd, analyseert u de interactielogboeken om te achterhalen waar agenten problemen ondervinden of afwijken van de verwachte procedures. Gebruik deze inzichten om uw evaluaties en tooldefinities continu bij te werken.

Betrek de deelnemers en deel je feedback.

Het ontwikkelen van tools voor AI-agenten is een continu, iteratief proces. Door je te richten op de doelen van de gebruiker, de beginsituatie zorgvuldig te definiëren en verschillende gespreksstijlen te oefenen, kun je tools ontwerpen die niet alleen taken uitvoeren, maar de AI-agent ook actief begeleiden naar succesvolle resultaten.

Houd tijdens het bouwen en evalueren van je website de interactie tussen gebruiker en medewerker centraal. Deze interactie moet de basis vormen voor de tools en het websiteontwerp, zodat de gebruiker de best mogelijke ervaring heeft.

WebMCP is onderwerp van actieve discussie en kan in de toekomst nog veranderen. Als u deze API uitprobeert en feedback heeft, horen we dat graag.