Inzicht in function calling
Op deze pagina
Wat is function calling?
Function calling is een van de krachtigste functies van de Grok API. Hiermee kan het model de uitvoering van functies aanvragen die u hebt gedefinieerd, om gegevens op te halen of acties in de echte wereld uit te voeren.
Belangrijk om te begrijpen: Grok voert de functies nooit zelf uit. Het model analyseert uw verzoek, stelt vast dat het externe informatie nodig heeft, en stuurt een gestructureerde aanroep (functienaam + argumenten) naar u terug. Uw client-side code voert de functie daadwerkelijk uit en stuurt het resultaat vervolgens terug naar het model.
De 6-stappen cyclus
Elke interactie met function calling volgt een nauwkeurige cyclus van zes stappen. Deze stroom is fundamenteel; hij structureert uw volledige architectuur.
Tools definiëren
U beschrijft uw functies met JSON-schema's: naam, beschrijving en verwachte parameters.
Verzoek verzenden
U stuurt het gebruikersbericht samen met de tool-definities naar de API.
tool_call ontvangen
Het model retourneert een tool_call-object met de functienaam en JSON-argumenten.
Functie uitvoeren
Uw client-side code voert de daadwerkelijke functie uit (API-aanroep, databasequery, berekening...).
Resultaat retourneren
U stuurt het uitvoeringsresultaat terug naar het model in een bericht met de rol 'tool'.
Definitief antwoord
Het model integreert het resultaat en genereert een natuurlijk taalantwoord voor de gebruiker.
Waarom is function calling zo belangrijk?
Zonder function calling is een taalmodel beperkt tot de kennis uit zijn training. Het kan geen database raadplegen, geen externe API’s bevragen of real-time berekeningen uitvoeren. Function calling lost dit fundamentele probleem op door het model de mogelijkheid te geven om op een gestructureerde en gecontroleerde manier interactie met de buitenwereld aan te gaan.
Hier zijn enkele concrete gebruiksscenario’s:
- Real-time gegevens: weer, beurskoersen, bestelstatussen
- Bedrijfsacties: een ticket aanmaken, een e-mail verzenden, een tijdslot boeken
- Nauwkeurige berekeningen: wiskundige bewerkingen, conversies, aggregaties
- Databases: productzoekopdrachten, klantgeschiedenis, voorraadbeheer
Het verschil met een standaard prompt
Bij een standaard uitwisseling stelt u een vraag en antwoordt het model direct. Bij function calling kan het model zijn antwoord pauzeren om via een functieaanroep aanvullende informatie op te vragen. Dit vermogen om de generatiestroom te onderbreken, maakt het mechanisme zo krachtig.
Het model redeneert als volgt: “Om deze vraag te beantwoorden, heb ik het huidige weer in Parijs nodig. Ik roep de functie get_weather aan met de parameter city: Paris.”
Beperkingen om rekening mee te houden
De Grok API accepteert maximaal 200 tools per verzoek. Dit is voor de meeste gebruiksscenario’s meer dan voldoende, maar houd er rekening mee dat elke tool-definitie input-tokens verbruikt. Hoe meer tools u declareert, hoe duurder het verzoek wordt en hoe langer het model erover doet om de juiste tool te kiezen.
Belangrijkste punten
- Met function calling kan het model de uitvoering van functies aanvragen, maar voert het ze niet zelf uit
- De stroom volgt altijd 6 stappen: definiëren, verzenden, ontvangen, uitvoeren, retourneren, antwoorden
- Functies worden client-side uitgevoerd, in uw code
- Maximaal 200 tools per verzoek
- Elke tool-definitie verbruikt tokens; wees selectief