Tools en functieaanroepen

Een functiecontract beschrijven

Een tool bevat een naam, een duidelijke beschrijving en een JSON Schema voor parameters. De beschrijving geeft aan wanneer de tool moet worden geselecteerd, terwijl het schema de argumenten begrenst.

Het model stelt een aanroep voor; het krijgt daardoor niet vanzelf toegang tot uw netwerk, database of bestanden.

{
  "model": "openai/gpt-5.6-sol",
  "messages": [{"role": "user", "content": "What is the weather in Tashkent?"}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "Read current weather for a city.",
      "parameters": {
        "type": "object",
        "properties": {"city": {"type": "string"}},
        "required": ["city"],
        "additionalProperties": false
      }
    }
  }],
  "tool_choice": "auto"
}

Aan uw kant uitvoeren

• Controleer de toolnaam aan de hand van een toelatingslijst.
• Valideer argumenten tegen het schema voordat u een interne dienst aanroept.
• Pas uw eigen autorisatie, time-outs en idempotentie toe op de toolactie.

Het resultaat retourneren

Voeg een tool-bericht toe met de tool_call_id en een compact geserialiseerd resultaat en vervolg daarna het gesprek met dezelfde context.

Houd een fout bij tooluitvoering gescheiden van een modelfout: geef een gestructureerde reden terug die het model aan de gebruiker kan uitleggen.