tool_choice agus Rialú Uirlisí
Ar an leathanach seo
Treoraigh an tsamhail i dtreo na n-uirlisí cearta
Go réamhshocraithe, cinneann an tsamhail go saor cé na huirlisí a úsáidfidh sí (nó an úsáidfidh sí aon cheann ar bith). Tugann an paraiméadar tool_choice rialú níos mine duit ar an iompar seo.
Móid tool_choice
auto (réamhshocraithe)
Cinneann an tsamhail go saor. Is féidir léi uirlis amháin, roinnt uirlisí, nó gan aon uirlis a úsáid:
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the capital of France?",
"tools": [{"type": "web_search"}],
"tool_choice": "auto"
}
Don cheist fhíriciúil shimplí seo, is dócha go bhfreagróidh an tsamhail gan cuardach gréasáin. Do cheist faoi imeachtaí reatha, seolfaidh sí cuardach.
required
Cuirtear iallach ar an tsamhail uirlis amháin ar a laghad a úsáid:
{
"model": "grok-4.20-0309-reasoning",
"input": "Give me today's stock market prices.",
"tools": [{"type": "web_search"}],
"tool_choice": "required"
}
Úsáideach nuair a bhíonn a fhios agat go n-éilíonn an freagra sonraí úra agus nach chóir don tsamhail freagairt ón gcuimhne.
none
Toirmisceann sé úsáid uirlisí, fiú má tá uirlisí dearbhaithe:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain the concept of recursion.",
"tools": [{"type": "web_search"}, {"type": "code_interpreter"}],
"tool_choice": "none"
}
Práctúil chun freagra téacsúil íon a fhorsáil i gcomhthéacs ina bhfuil uirlisí ar fáil de ghnáth.
Feidhm shonrach
Cuirtear iallach ar úsáid feidhme sonraí:
{
"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"}
}
Tá an tsamhail teoranta do get_weather a ghlaocadh leis na hargóintí cuí.
parallel_tool_calls
Go réamhshocraithe, tá parallel_tool_calls socraithe ar true. Is féidir leis an tsamhail il-uirlisí a sheoladh go comhthreomhar laistigh de throinn amháin:
{
"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
}
D’fhéadfadh an tsamhail get_weather("Paris") agus get_weather("Londres") a ghlaocadh go comhuaineach, rud a luathaíonn an próiseáil.
Chun an t-iompar seo a dhíchumasú:
{
"parallel_tool_calls": false
}
Díchumasaigh glaonna comhthreomhara má tá éifeachtaí taobh ag do fheidhmeanna nó má bhraitheann siad ar a chéile (mar shampla, má bhraitheann an dara feidhm ar thoradh na chéad fheidhme).
max_turns
Cuireann an paraiméadar max_turns teorainn le líon na dtroinne idirghníomhaíochta idir an tsamhail agus na huirlisí ar thaobh an fhreastalaí:
{
"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
}
Is ciorcad iomlán é “troinn”: glaonn an tsamhail uirlis, faigheann sí an toradh, agus ansin cinneann sí an bhfuil glaoc eile de dhíth uirthi. Le max_turns: 5, is féidir leis an tsamhail suas le 5 chiorcad glaonna uirlisí ar an bhfreastalaí a dhéanamh sula dtáirgeann sí a freagra deiridh.
Iompar le huirlisí cliant
Baineann max_turns le huirlisí freastalaí amháin. Nuair a ghlaonn an tsamhail feidhm chliant, athshocraítear an t-áireamh ar an iarraidh seo chugainn. Ciallaíonn sé seo go gcruthaíonn gach turas cliant-freastalaí leithdháileadh nua troinne.
Straitéisí rialaithe
| Cás | tool_choice | parallel | max_turns |
|---|---|---|---|
| Cuardach nuachta | required | true | 3 |
| Ríomh cruinn | {"type": "function", "name": "calc"} | false | 1 |
| Comhrá saor | auto | true | 5 |
| Freagra gan uirlis | none | - | - |
Príomhphointí
- Rialaíonn
tool_choicean bhfuil agus cé na huirlisí a úsáideann an tsamhail:auto,required,none, nó feidhm shonrach - Cumasaíonn
parallel_tool_calls(réamhshocraithetrue) glaonna uirlisí comhuaineacha - Cuireann
max_turnsteorainn le ciorclacha uirlisí freastalaí – athshocraíonn glaonna cliant an t-áireamh - Úsáid
requirednuair atá sonraí úra riachtanach - Díchumasaigh an comhthreomhaireacht má bhraitheann do fheidhmeanna ar a chéile