tool_choice ja työkalujen hallinta
Tällä sivulla
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
| Skenaario | tool_choice | parallel | max_turns |
|---|---|---|---|
| Uutishaku | required | true | 3 |
| Tarkka laskenta | {"type": "function", "name": "calc"} | false | 1 |
| Vapaa keskustelu | auto | true | 5 |
| Vastaus ilman työkalua | none | - | - |
Keskeiset asiat
tool_choiceohjaa sitä, käyttääkö malli työkaluja ja mitkä:auto,required,nonetai tietty funktioparallel_tool_calls(oletustrue) mahdollistaa työkalujen samanaikaiset kutsutmax_turnsrajoittaa 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