Een agent die MCP-tools gebruikt

MCP biedt mogelijkheden met expliciete contracten.

Wat je gaat leren

  • Leg uit: het model doet voorstellen, de tool voert uit
  • Pas het idee toe in een voorbeeld: een agent die MCP-tools gebruikt
  • Herken beperkingen en verifieer het resultaat van de oefening

MCP biedt mogelijkheden met expliciete contracten. Selecteer alleen gereedschappen die nodig zijn voor de taak.

Deze stappen verwijzen naar de functies die in de applicatiecode zijn geïdentificeerd. Dit materiaal is niet gevalideerd op een live exemplaar; controleer de documentatie en de opties in uw versie.

Hoe het werkt, stap voor stap

Het model doet voorstellen, de tool voert uit

Tool calling produceert een oproepverzoek met een naam en argumenten. De applicatie valideert het schema, de machtigingen en de limieten vóór uitvoering. Het resultaat keert terug naar de context voor de volgende stap. get_product_stock neemt bijvoorbeeld een SKU en retourneert een hoeveelheid; in de beschrijving moet worden uitgelegd dat er geen producten worden gereserveerd. Onderscheid lege resultaten, validatiefouten, ontbrekende toegang en time-outs. Geldige JSON bewijst niet dat de argumenten correct zijn of dat de actie is geautoriseerd. Houd bij externe effecten ook rekening met dubbele uitvoering.

Host, client en server

MCP is een protocol dat AI-applicaties verbindt met externe mogelijkheden. De host zorgt voor de ervaring, de client beheert de verbinding en de server stelt tools, bronnen of aanwijzingen beschikbaar op basis van ondersteuning. Tools voeren bewerkingen uit; bronnen bieden adresseerbare inhoud; prompts bieden sjablonen. Niet elke server implementeert ze alle drie. Transport vervoert berichten, authenticatie identificeert bellers en autorisatie controleert de toegang. Controleer de protocolrevisie en ondersteunde extensies aan beide kanten. Compatibiliteit kan niet worden afgeleid uit alleen een “MCP”-label.

Controleer de toegang vóór gebruik

Machtigingen moeten worden afgedwongen door servers en de gegevenslaag. Laat het model niet beslissen of een gebruiker een document mag zien. Filter bronnen voordat ze in de context terechtkomen, niet nadat het antwoord is gegenereerd. Gebruik inloggegevens voor minimale toegang, houd deze buiten prompts, schermafbeeldingen en browsercode en draai blootgestelde sleutels. Een toelatingslijst voor widgetdomeinen vervangt API-authenticatie niet. Authenticatie identificeert u; autorisatie bepaalt welke handelingen en gegevens u kunt gebruiken. Test ook toegang geweigerd.

Het verklarende schema

Een agent die MCP-tools gebruikt Volg de ononderbroken pijlen voor de hoofdstroom. Gestippelde blauwe pijlen leveren gegevens of context; roze pijlen geven feedback of geretourneerde resultaten weer. Kleuren en vormen onderscheiden modellen, winkels, beslissingen en resultaten. Verbindingen: Gebruikersverzoek → Agent / LLM; Agent / LLM → MCP-client; MCP-client → Ontdek gereedschapsschema's; Ontdek gereedschapsschema's → Valideer argumenten en machtigingen; Valideer argumenten en machtigingen → MCP-server; MCP-server → Externe API/database; Gereedschapsresultaten → Laatste antwoord; Identiteit en instructies van de agent → Agent / LLM; Transport en authenticatie → MCP-client; Toegangsrechten → Valideer argumenten en machtigingen; Externe API/database → Gereedschapsresultaten; Gereedschapsresultaten → Agent / LLM. A04 · Relatie kaart Een agent die MCP-tools gebruikt Invoer Gebruikersverzoek Gegevens Identiteit en instructies van de agent Beslissing / controle Transport en authenticatie AI-model / agent Agent / LLM Verwerking MCP-client Verwerking Ontdek gereedschapsschema's Beslissing / controle Valideer argumenten en machtigingen Gereedschap / dienst MCP-server Winkel / index Externe API/database Uitvoer Laatste antwoord Gegevens Gereedschapsresultaten Beslissing / controle Toegangsrechten Hoofdstroom Gegevens en context Feedback en retour

Volg de ononderbroken pijlen voor de hoofdstroom. Gestippelde blauwe pijlen leveren gegevens of context; roze pijlen geven feedback of geretourneerde resultaten weer. Kleuren en vormen onderscheiden modellen, winkels, beslissingen en resultaten. Scrol op kleine schermen horizontaal om het hele schema te volgen.

Een compleet voorbeeld

Sluit een demonstratieserver aan, ontdek tools en selecteer get_product_stock voor de agent. Een ontbrekende SKU zorgt voor verduidelijking in plaats van willekeurige toegang tot alle bestellingen.

Probeer het zelf

  1. Schakel een alleen-lezen tool in en test een geldige SKU, ontbrekende SKU en geweigerde toegang.
  2. Leg de input, bron en verwachte uitkomst vast voordat u het experiment uitvoert. Gebruik alleen de fictieve gegevens in het voorbeeld.
  3. Volg de diagramfasen. Registreer bij elke stap welke informatie wordt ontvangen en geproduceerd; verwar de tussentijdse output niet met het uiteindelijke resultaat.
  4. Herhaal dit nadat de noodzakelijke informatie is verwijderd of de invoer dubbelzinnig is gemaakt. Controleer of het systeem een ​​antwoord verduidelijkt, stopt of verzint.
  5. Vergelijk met de uitgelegde oplossing. Bewaar de configuratie, datum, resultaat en een verklaring voor verschillen. Verander één ding en test opnieuw.

Een uitgelegde oplossing

De aanroep leest de toegestane SKU-voorraad en behandelt toegangsweigering als een fout in plaats van als nulvoorraad. Met een succesvolle oefening kun je het verband tussen input, fasen en uitkomst laten zien. Als er informatie ontbreekt, is een voorzichtig antwoord nuttiger dan verzonnen details. Vergelijk meer dan stijl: controleer ook voorwaarden, bronnen en bewerkingen.

Wanneer deze aanpak helpt en wat de beperkingen zijn

Een gereedschapsbeschrijving is geen veiligheidscontrole. Kies deze aanpak wanneer deze een gemeten behoefte verbetert. Houd een eenvoudige basislijn aan en vergelijk de resultaten met behulp van identieke inputs. Eén succesvol voorbeeld garandeert niet in elke situatie betrouwbaarheid.

Controleer wat je hebt geleerd

Wie voert een door het model voorgestelde oproep uit?

De applicatie of hostservice na validatie. Het model krijgt niet automatisch onbeperkte toegang.

Biedt een server met tools automatisch bronnen en aanwijzingen?

Nee. Mogelijkheden zijn optioneel en moeten worden ontdekt en gecontroleerd.

Welk resultaat moet deze oefening opleveren?

De aanroep leest de toegestane SKU-voorraad en behandelt toegangsweigering als een fout in plaats van als nulvoorraad.

Begrippen om te onthouden

  • Gereedschap bellen: Een gestructureerd verzoek om een ​​externe mogelijkheid te gebruiken.
  • MCP-server: een service die mogelijkheden blootlegt via Model Context Protocol.
  • Autorisatie / Autorisatie: het recht op toegang tot een bewerking of bron controleren.

Bronnen en uw volgende stap

Ter voorbereiding: A03 — Een agent verbonden met kennis