Hulpprogramma's toevoegen

De vorige pagina liet zien hoe het verpakken van een LLM in een agent u een permanente identiteit, instructies en sessiebeheer biedt. Maar zelfs met al dat, kan de agent alleen inhoud genereren (tekst, afbeeldingen, enzovoort) - de aandelenkoers van vandaag kan niet worden opgezocht, een e-mail wordt verzonden of een query op uw database wordt uitgevoerd. Het antwoordt op de kennis die tijdens de training is ingebakken en welke context u in de prompt opgeeft.

Tools overbruggen deze kloof. Ze geven de agent de mogelijkheid om te handelen , om de trainingsgegevens te overschrijden en te communiceren met de echte wereld. Het toevoegen van hulpprogramma's is de meest impactvolle stap die u kunt uitvoeren om een agent echt nuttig te maken.

Wanneer te gebruiken

Voeg hulpprogramma's toe aan uw agent wanneer:

• De agent moet toegang hebben tot real-time of externe gegevens — live prijzen, weer, databaserecords, zoekresultaten — die niet in de trainingsdata van het model zijn opgenomen.
• De agent moet acties ondernemen ( e-mailberichten verzenden, tickets maken, API's aanroepen, bestanden schrijven) in plaats van alleen inhoud te produceren.

Overwegingen

Waarom agents hulpprogramma's nodig hebben

Zoals beschreven in DE grondbeginselen van LLM, wordt een LLM getraind voor het genereren van tokens, inclusief een speciale gestructureerde indeling die een toolaanroep vertegenwoordigt. Maar het model zelf voert nooit iets uit. Het is uw toepassing (of Agent Framework) die de uitvoer van het model parseert, de werkelijke functie uitvoert en het resultaat weer invoert.

Dit betekent dat hulpprogramma's niet wijzigen wat het model is : ze wijzigen wat uw agent kan doen. Zonder hulpprogramma's is een agent een conversationalist. Met hulpprogramma's wordt het een operator.

Overweeg een reisboekingsagent. Zonder hulpprogramma's kan het vluchten bespreken en itineraries voorstellen op basis van algemene kennis. Met hulpprogramma's kan het volgende:

• Zoek naar een vlucht-API voor realtime beschikbaarheid en prijzen
• Een vlucht boeken namens de gebruiker

Voor elk van deze acties is een hulpprogramma vereist: een stukje code dat de agent kan aanroepen om te communiceren met de buitenwereld.

Hoe de tool-aanroep lus werkt

Wanneer u een agent hulpmiddelen geeft, beheert Agent Framework automatisch een lus voor het aanroepen van hulpmiddelen:

┌──────────────────────────────────────────────────────┐
│  User: "What's the weather in Seattle?"              │
└──────────────┬───────────────────────────────────────┘
               ▼
┌──────────────────────────────────────────────────────┐
│  Agent sends messages + tool definitions to LLM      │
└──────────────┬───────────────────────────────────────┘
               ▼
       ┌───────────────┐
       │ LLM responds  │
       └───┬───────┬───┘
           │       │
     Tool call?    No ──────────────────────────┐
           │                                    │
           ▼                                    ▼
┌─────────────────────────────┐   ┌─────────────────────────────┐
│  Agent Framework executes   │   │  Final response:            │
│  the tool (e.g.,            │   │  "It's cloudy in Seattle    │
│  get_weather("Seattle"))    │   │   with a high of 15°C."     │
└──────────────┬──────────────┘   └─────────────────────────────┘
               │
               ▼
┌─────────────────────────────┐
│  Agent sends tool result    │
│  back to the LLM            │
└──────────────┬──────────────┘
               │
               └──────► (back to "LLM responds")

Belangrijkste punten:

1. U hoeft de lus niet te schrijven. Agent Framework verwerkt het detecteren van hulpprogramma-aanroepen in het antwoord van het model, het uitvoeren van de hulpprogramma's en het teruggeven van resultaten. U definieert de hulpprogramma's; het framework organiseert de rest.
2. Meerdere gereedschapsoproepen per beurt. Het model kan verschillende hulpprogramma's aanroepen (mogelijk parallel) voordat er een definitief antwoord wordt geproduceerd, of ketenhulpprogramma's waarbij de uitvoer van het ene hulpprogramma de volgende informeert.
3. Het model bepaalt wanneer hulpprogramma's moeten worden aangeroepen. Op basis van de aanvraag van de gebruiker en de beschrijvingen van de hulpprogramma's die u opgeeft, beoordeelt het model of een hulpprogramma nodig is. Goede beschrijvingen van hulpprogramma's leiden tot betere selectie van hulpprogramma's.

Typen gereedschappen

Agent Framework ondersteunt verschillende categorieën hulpprogramma's. Het kiezen van de juiste is afhankelijk van wat je wilt dat de agent doet en waar de functionaliteit zich bevindt.

Functiehulpmiddelen

Functiehulpprogramma's zijn aangepaste functies die u schrijft en registreert bij de agent. Ze worden uitgevoerd in uw proces, waardoor u volledige controle hebt over de logica, beveiligingsgrenzen en foutafhandeling.

Functiehulpprogramma's gebruiken wanneer:

• U hebt aangepaste bedrijfslogica die de agent moet aanroepen (een query uitvoeren op een database, een interne API aanroepen, een berekening uitvoeren)
• U hebt het hulpprogramma nodig om in uw omgeving uit te voeren met toegang tot uw resources
• U wilt typeveiligheid tijdens compileertijd en testbaarheid

Functiehulpprogramma's zijn het meest voorkomende en flexibele hulpprogrammatype. De meeste agents beginnen hier.

MCP-hulpprogramma's (Model Context Protocol)

MCP is een open standaard die definieert hoe toepassingen hulpprogramma's voor LLM's bieden. In plaats van zelf hulpprogrammalogica te schrijven, maakt u verbinding met een MCP-server die een set hulpprogramma's beschikbaar maakt via een standaardprotocol, vergelijkbaar met de manier waarop een REST API eindpunten beschikbaar maakt.

Agent Framework ondersteunt twee varianten:

Gebruik MCP-hulpprogramma's wanneer:

• Een vooraf gebouwde MCP-server biedt al de mogelijkheid die u nodig hebt
• U wilt hulpprogramma's voor meerdere agents of toepassingen opnieuw gebruiken via een gedeelde server
• U integreert met een service van derden die een MCP-eindpunt beschikbaar maakt

Door provider gehoste hulpprogramma's

Sommige providers bieden ingebouwde hulpprogramma's die worden uitgevoerd op de infrastructuur van de provider. Er is geen lokale code vereist. Deze omvatten:

Gebruik door de provider gehoste hulpprogramma's wanneer:

• U hebt mogelijkheden nodig, zoals het uitvoeren van code of webzoekopdrachten zonder het hulpprogramma zelf te bouwen of te hosten
• De provider biedt al een beheerde versie die voldoet aan uw vereisten

Het juiste hulpprogrammatype kiezen

Beschrijvingen van hulpprogramma's zijn belangrijk

Het model selecteert hulpprogramma's op basis van hun namen en beschrijvingen. Een vage beschrijving leidt tot slechte selectie van hulpprogramma's: het model kan het verkeerde hulpmiddel aanroepen, een hulpprogramma overslaan dat moet worden gebruikt of onjuiste argumenten doorgeven.

Beschrijvingen van schrijfhulpprogramma's op dezelfde manier als u een API-document zou schrijven: zeg wat het hulpprogramma doet, wat elke parameter betekent en wat deze retourneert. Hoe duidelijker de beschrijving, hoe beter het oordeel van het model.

Goedkeuring van hulpprogramma' s: human-in-the-loop

Sommige acties zijn gevoelig: geld overdragen, records verwijderen, e-mailberichten verzenden. Mogelijk wilt u niet dat de agent deze hulpprogramma's autonoom uitvoert. Met goedkeuring van hulpprogramma's kunt u menselijke bevestiging vereisen voordat een hulpprogramma wordt uitgevoerd.

Wanneer een tool is gemarkeerd als vereist goedkeuring, wordt de agent onderbroken voordat de uitvoering plaatsvindt en wordt een antwoord geretourneerd dat aangeeft dat goedkeuring nodig is. Uw toepassing is verantwoordelijk voor het presenteren hiervan aan de gebruiker en het doorgeven van hun beslissing.

Dit patroon wordt vaak human-in-the-loop genoemd en is essentieel voor het bouwen van betrouwbare agents die gevolgacties verwerken.

Veelvoorkomende valkuilen

Speciale vermelding: Code Interpreter Tool

Zoals besproken in LLM Fundamentals, kunnen LLM's fouten maken in nauwkeurige berekeningen en formele logica. Dit komt doordat LLM's antwoordentoken per token genereren op basis van patroonkoppeling . Ze berekenen niet daadwerkelijk. Een LLM die wordt gevraagd om twee grote getallen te vermenigvuldigen, voert geen rekenkundige bewerkingen uit; het voorspelt hoe het antwoord eruitziet op basis van trainingsgegevens. Dit werkt verrassend vaak, maar mislukt onvoorspelbaar in edge-gevallen.

Code Interpreter lost dit op door de agent code te laten schrijven en uit te voeren in een sandboxomgeving. In plaats van het antwoord te raden, schrijft het model een Python script waarmee het precies wordt berekend, wordt uitgevoerd en wordt het geverifieerde resultaat in het antwoord gebruikt.

Geef uw agent de Code Interpreter wanneer dat nodig is.

• Voer nauwkeurige berekeningen uit : financiële modellering, statistische analyse, eenheidsconversies, waarbij een geschatte schatting niet acceptabel is.
• Gegevens transformeren of analyseren : CSV's parseren, rijen aggregeren, grafieken genereren of gestructureerde gegevens hervormen.
• Bestanden verwerken : geüploade documenten lezen, inhoud extraheren, indelingen converteren of nieuwe bestanden genereren.
• Valideer een eigen redenering : schrijf testcode om een logische claim te verifiëren voordat u deze aan de gebruiker presenteert.

Volgende stappen 

Zodra uw agent hulpprogramma's heeft, is de volgende stap het leren over vaardigheden : draagbare pakketten met instructies, referentiemateriaal en scripts die agents domeinexpertise geven die ze op aanvraag kunnen laden.

Ga dieper in:

• Overzicht van hulpprogramma's : alle hulpprogrammatypen en ondersteuningsmatrix voor providers
• Functiehulpprogramma's — gedetailleerde naslaginformatie over functiehulpmiddelen
• Hosted MCP Tools — Microsoft Foundry MCP-servers en andere providers
• Lokale MCP-hulpprogramma's — aangepaste MCP-servers
• Goedkeuring van hulpprogramma's - human-in-the-loop voor hulpprogramma's
• Stap 2: Hulpmiddelen toevoegen — praktische handleiding