Gestructureerde uitvoer en tooloproep

Gestructureerde gegevens helpen software een antwoord te lezen, maar zowel structuur als betekenis vereisen validatie.

Wat je gaat leren

  • Leg uit: het model doet voorstellen, de tool voert uit
  • Pas het idee toe in een voorbeeld: gestructureerde uitvoer en tooloproep
  • Herken beperkingen en verifieer het resultaat van de oefening

Gestructureerde gegevens helpen software een antwoord te lezen, maar zowel structuur als betekenis vereisen validatie.

Je kunt deze cursus volgen zonder account of programmering. Voorbeelden maken gebruik van synthetische gegevens en AI-resultaten moeten worden gecontroleerd.

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.

Een opdracht is een contract

Een goede prompt specificeert de taak, beschikbare gegevens, uitvoerformaat en succescriteria. Scheid de rol van de gegevens en voeg een voorbeeld toe voor onduidelijke gevallen. ‘Wees accuraat’ is zwakker dan ‘vermeld alleen de deadline in het aangeleverde beleid; als deze ontbreekt, vraag dan om opheldering’. Few-shot betekent een paar opgeloste voorbeelden, niet een eindeloze lijst. De inhoud van documenten blijft gegevens, zelfs als deze opdrachten bevat. Scheidingstekens helpen, maar software moet machtigingen en validatie afdwingen in plaats van te vertrouwen op de prompt.

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

Gestructureerde uitvoer en tooloproep 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 → Gestructureerde uitvoer; Gestructureerde uitvoer → Valideer argumenten en machtigingen; Valideer argumenten en machtigingen → MCP-tools / RAG; MCP-tools / RAG → Gereedschapsresultaten; Gereedschapsresultaten → Laatste antwoord; Invoer-/uitvoerschema → Valideer argumenten en machtigingen; Toegangsrechten → Valideer argumenten en machtigingen; Agent / LLM → Voorgestelde toolcall (Gereedschapsvoorstel); Voorgestelde toolcall → Valideer argumenten en machtigingen; Valideer argumenten en machtigingen → Afwijzen of stoppen (Ongeldig); Gereedschapsresultaten → Agent / LLM. P05 · Relatie kaart Gestructureerde uitvoer en tooloproep Invoer Gebruikersverzoek Gegevens Invoer-/uitvoerschema Beslissing / controle Toegangsrechten AI-model / agent Agent / LLM Gegevens Gestructureerde uitvoer Gegevens Voorgestelde toolcall Beslissing / controle Valideer argumenten en machtigingen Gereedschap / dienst MCP-tools / RAG Uitvoer Afwijzen of stoppen Gegevens Gereedschapsresultaten Uitvoer Laatste antwoord Gereedschapsvoorstel Ongeldig 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

Een classificator retourneert categorie en needs_review. JSON met categorie = "refund_now" is syntactisch geldig, maar schendt de toegestane categorieën en staat geen terugbetaling toe.

{"category":"returns","needs_review":false}

Probeer het zelf

  1. Definieer een schema en test een onbekende categorie en een ontbrekend veld.
  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 validator accepteert alleen levering, retourzendingen of producten en een booleaanse waarde; acties blijven gescheiden. 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

Syntactisch correct JSON is semantisch niet correct. 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.

Kan een prompt de toegangscontrole vervangen?

Nee. Een instructie is geen autorisatiegrens.

Welk resultaat moet deze oefening opleveren?

De validator accepteert alleen levering, retourzendingen of producten en een booleaanse waarde; acties blijven gescheiden.

Begrippen om te onthouden

  • Gereedschap bellen: Een gestructureerd verzoek om een ​​externe mogelijkheid te gebruiken.
  • Weinig schot: Opgeloste voorbeelden geleverd in context.
  • Autorisatie / Autorisatie: het recht op toegang tot een bewerking of bron controleren.

Bronnen en uw volgende stap

Ter voorbereiding: P04 — Hoe u een geschikt AI-model kiest