Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

tool_choice ja työkalujen hallinta

Oppitunti 10 / 16 Päivitetty 30. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Ohjaa malli oikeiden työkalujen käyttöön
  2. tool_choice -tilat
  3. parallel_tool_calls
  4. max_turns
  5. Hallintastrategiat
  6. Keskeiset asiat

Ohjaa malli oikeiden työkalujen käyttöön

Oletusarvoisesti malli päättää itse, mitä työkaluja se käyttää (tai käyttääkö niitä lainkaan). tool_choice-parametri antaa sinulle tarkemman kontrollin tähän toimintaan.

tool_choice -tilat

auto (oletus)

Malli päättää vapaasti. Se voi käyttää yhtä työkalua, useita tai ei yhtäkään:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What is the capital of France?",
  "tools": [{"type": "web_search"}],
  "tool_choice": "auto"
}

Tämänkaltaiseen yksinkertaiseen faktakysymykseen malli vastaa todennäköisesti ilman verkkohakua. Ajankohtaisia tapahtumia koskevaan kysymykseen se käynnistää haun.

required

Pakottaa mallin käyttämään vähintään yhtä työkalua:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Give me today's stock market prices.",
  "tools": [{"type": "web_search"}],
  "tool_choice": "required"
}

Hyödyllinen tilanne, jossa tiedät vastauksen vaativan tuoreita tietoja, eikä mallin pitäisi vastata muistinsa varassa.

none

Kieltää työkalujen käytön, vaikka niitä olisi määritelty:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Explain the concept of recursion.",
  "tools": [{"type": "web_search"}, {"type": "code_interpreter"}],
  "tool_choice": "none"
}

Käytännöllinen tapa pakottaa puhtaasti tekstipohjainen vastaus kontekstissa, jossa työkalut ovat normaalisti käytettävissä.

Tietty funktio

Pakottaa tietyn funktion käytön:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Paris",
  "tools": [{
    "type": "function",
    "name": "get_weather",
    "description": "Retrieves the weather",
    "parameters": {
      "type": "object",
      "properties": {
        "city": {"type": "string"}
      },
      "required": ["city"]
    }
  }],
  "tool_choice": {"type": "function", "name": "get_weather"}
}

Malli pakotetaan kutsumaan get_weather-funktiota asianmukaisilla argumenteilla.

parallel_tool_calls

Oletusarvoisesti parallel_tool_calls on asetettu arvoon true. Malli voi käynnistää useita työkaluja rinnakkain yhden vuoron aikana:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Compare the weather in Paris and London.",
  "tools": [{
    "type": "function",
    "name": "get_weather",
    "description": "Retrieves the weather for a city",
    "parameters": {
      "type": "object",
      "properties": {
        "city": {"type": "string"}
      },
      "required": ["city"]
    }
  }],
  "parallel_tool_calls": true
}

Malli saattaa kutsua samanaikaisesti get_weather("Paris") ja get_weather("Londres"), mikä nopeuttaa käsittelyä.

Poistaaksesi tämän toiminnon käytöstä:

{
  "parallel_tool_calls": false
}

Poista rinnakkaiskutsut käytöstä, jos funktioillasi on sivuvaikutuksia tai ne riippuvat toisistaan (esimerkiksi jos toinen funktio tarvitsee ensimmäisen tuloksen).

max_turns

max_turns-parametri rajoittaa mallin ja työkalujen välisten vuorovaikutuskierrosten määrää palvelinpuolella:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Perform an in-depth analysis of the AI market in 2026.",
  "tools": [{"type": "web_search"}, {"type": "code_interpreter"}],
  "max_turns": 5
}

“Vuoro” vastaa yhtä täydellistä sykliä: malli kutsuu työkalua, vastaanottaa tuloksen ja päättää sitten, tarvitseeko se tehdä uuden kutsun. Asetuksella max_turns: 5 malli voi suorittaa enintään viisi palvelinpuoleista työkalukutsusykliä ennen lopullisen vastauksen tuottamista.

Käyttäytyminen asiakaspuolen työkalujen kanssa

max_turns koskee vain palvelinpuolen työkaluja. Kun malli kutsuu asiakaspuolen funktiota, laskuri nollautuu seuraavassa pyynnössä. Tämä tarkoittaa, että jokainen asiakas-palvelin-vuorovaikutus luo uuden vuorojen kiintiön.

Hallintastrategiat

Skenaariotool_choiceparallelmax_turns
Uutishakurequiredtrue3
Tarkka laskenta{"type": "function", "name": "calc"}false1
Vapaa keskusteluautotrue5
Vastaus ilman työkaluanone--

Keskeiset asiat

  • tool_choice ohjaa sitä, käyttääkö malli työkaluja ja mitkä: auto, required, none tai tietty funktio
  • parallel_tool_calls (oletus true) mahdollistaa työkalujen samanaikaiset kutsut
  • max_turns rajoittaa palvelinpuoleisia työkalusyklejä – asiakaspuolen kutsut nollauttavat laskurin
  • Käytä arvoa required, kun tuoreet tiedot ovat välttämättömiä
  • Poista rinnakkaisuus käytöstä, jos funktiosi riippuvat toisistaan