Functies

We kunnen het AI-model "dwingen" om antwoord te geven in een van te voren vastgelegde structuur. Dit doen we door naast de prompt ook een functie mee te sturen richting het AI-model.  In deze functie beschrijven we welke informatie we in het antwoord willen zien en we geven ook aan in welke structuur we het antwoord willen ontvangen.

Functies kunnen we maken en behereren in het scherm "AI Tools > Template bouwstenen > Functies"

In het onderstaande voorbeeld kunnen we in de vraag aan het AI-Model volstaan met het opgeven van een een plantnaam. De functie zelf bevat alle informatie die het AI-model nodig heeft om een gestuctureerd antwoord te geven.

{
    "name": "CREATE_PLANT_RECORD",
    "description": "Create plant record with plant names, general and ecological description, height, color and blooming period.",
    "parameters": {
        "type": "object",
        "properties": {
            "name": {
                "type": "string",
                "description": "plant name in English"
            },
            "latin": {
                "type": "string",
                "description": "plant name in Latin"
            },
            "general_description": {
                "type": "string",
                "description": "a general description of the plant in about 200 words in English"
            },
            "ecological_description": {
                "type": "string",
                "description": "an ecological description of the plant in about 200 words in English"
            },
            "height": {
                "type": "integer",
                "description": "an estimation of the height of the full grown plant in centimeters"
            },
            "color_english": {
                "type": "string",
                "description": "the color of the flowers of the plant in English"
            },
            "season": {
                "type": "string",
                "description": "the period the plant is blooming in English"
            }
        },
        "required": ["name","latin","general_description","ecological_description","height"]
    }
}

De beschrijving van de functie geeft al aan waarnaar we op zoek zijn. De 'properties' specificeren verder hoe we de informatie willen ontvangen.

Functies kunnen we net als prompt-tekstblokken en datamodellen middels {tags} aan prompt-templates toevoegen. Het is mogelijk om meerdere functies aan een prompt toe te voegen. In de prompt-template kunnen aangeven of we een specifieke functie willen gebruiken, of dat we dit automatisch door het AI-model willen laten bepalen, of dat we geen functie willen laten gebruiken bij het beantwoorden van de vraag.

Hieronder zien we een voorbeeld template waarbij de bovenstaande functie gebruikt wordt:

[UI]Voer een plantnaam in:[/UI]
{vraag:input}
{function:CREATE_PLANT_RECORD}
{function_call:CREATE_PLANT_RECORD}

Als we deze template vervolgens gebruiken op de "Enkele prompt" pagina dan krijgen we een gestructureerd antwoord terug.

Figuur 1: Template met functie in "Enkele prompt" scherm

Het antwoord van het AI-model wordt gegeven in een JSON (JavaScript Object Notation) structuur. JSON is een wijdverspreide standaard voor gegevensuitwisseling die door vele programmeertalen wordt ondersteund. Dit maakt het gemakkelijk om gegevens te integreren en te gebruiken in verschillende systemen en applicaties.

Prompt-reeksen / chains

In de documenatie van de prompt-reeksen (chains) is te zien dat we een prompttemplate op basis van een functie combineren met speciale Tool- functies. Zo kunnen we bijvoorbeeld een Tool-functie gebruiken om de informatie in JSON-formaat, die een template produceert, direct in een database op te slaan via een API.