Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

tool_choice agus Rialú Uirlisí

Ceacht 10 as 16 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Treoraigh an tsamhail i dtreo na n-uirlisí cearta
  2. Móid tool_choice
  3. parallel_tool_calls
  4. max_turns
  5. Straitéisí rialaithe
  6. Príomhphointí

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ástool_choiceparallelmax_turns
Cuardach nuachtarequiredtrue3
Ríomh cruinn{"type": "function", "name": "calc"}false1
Comhrá saorautotrue5
Freagra gan uirlisnone--

Príomhphointí

  • Rialaíonn tool_choice an bhfuil agus cé na huirlisí a úsáideann an tsamhail: auto, required, none, nó feidhm shonrach
  • Cumasaíonn parallel_tool_calls (réamhshocraithe true) glaonna uirlisí comhuaineacha
  • Cuireann max_turns teorainn le ciorclacha uirlisí freastalaí – athshocraíonn glaonna cliant an t-áireamh
  • Úsáid required nuair atá sonraí úra riachtanach
  • Díchumasaigh an comhthreomhaireacht má bhraitheann do fheidhmeanna ar a chéile