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

max_turns agus Uirlisí Freastalaí/Cliaint

Ceacht 8 as 12 Nuashonraithe 30 Iúil 2026 Ardleibhéal
Ar an leathanach seo
  1. Uirlisí Freastalaí agus Uirlisí Cliaint
  2. An Paraiméadar max_turns
  3. Athshocrú trí Uirlisí Cliaint
  4. Sreabhair Oibre Hibrideacha
  5. max_turns a Shocrú
  6. Príomhphointí

Uirlisí Freastalaí agus Uirlisí Cliaint

Déanann an t-ardán xAI idirdhealú idir dhá chineál uirlisí is féidir le Grok a úsáid i gcomhrá:

  • Uirlisí taobh an fhreastalaí: cuardach gréasáin, feidhmiú cód, cuardach X. Ritear na huirlisí seo go huathoibríoch ar fhreastalaithe xAI. Tugann Grok orthu, faigheann sé an toradh, agus leanann sé ar aghaidh gan aon idirghabháil uait.
  • Uirlisí taobh an chliaint: do fheidhmeanna saincheaptha (glao feidhme). Nuair a theastaíonn ó Grok ceann de do fheidhmeanna a ghlaowh, filleann an API glao feidhme ort. Feidhmíonn do chód é, agus ansin seolann tú an toradh ar ais chuig an API.

Tá an t-idirdhealú seo ríthábhachtach chun iompar max_turns a thuiscint.

An Paraiméadar max_turns

Rialaíonn max_turns líon na dtimthriallta segantóir/uirlisí is féidir le Grok a dhéanamh in aon iarratas API amháin. Caitheann gach úsáid d’uirlis freastalaí timthriall amháin.

response = await client.chat.completions.create(
    model="grok-4.5",
    messages=[{"role": "user", "content": "Search for the latest news on Python 3.13"}],
    tools=[...],
    max_turns=5  # Grok can use up to 5 server tools
)

Má theastaíonn ó Grok cuardach gréasáin a rith, ansin cód a fheidhmiú chun na torthaí a anailísiú, agus ansin dara cuardach a rith chun críche a chur leis, caitheann sé sin 3 thimthriall. Le max_turns=5, tá 2 thimthriall fágtha aige.

Athshocrú trí Uirlisí Cliaint

Seo an príomhiompar le cuimhneamh air: athshocraíonn glaonna ar uirlisí taobh an chliaint an t-áireamh max_turns. Nuair a láimhsíonn do chód glao feidhme agus nuair a fhillfidh tú an toradh in iarratas API nua, faigheann Grok a leithdháileadh iomlán timthriallta ar ais.

# First request: max_turns=3
response = await client.chat.completions.create(
    model="grok-4.5",
    messages=messages,
    tools=my_tools,
    max_turns=3
)

# Grok requests a client function call
if response.choices[0].message.tool_calls:
    # You execute the function locally
    tool_result = execute_tool(response.choices[0].message.tool_calls[0])

    # Second request: max_turns resets to 3
    messages.append(response.choices[0].message)
    messages.append({"role": "tool", "content": tool_result, ...})

    response = await client.chat.completions.create(
        model="grok-4.5",
        messages=messages,
        tools=my_tools,
        max_turns=3  # new counter
    )

Tá ciall leis an athshocrú seo: tá gach iarratas API neamhspleách. Ní bhaineann an t-áireamh max_turns ach le timthriallta a dhéantar laistigh den iarratas céanna.

Sreabhair Oibre Hibrideacha

Cuireann comhcheangal uirlisí freastalaí agus cliant ar chumas sreabhair oibre casta. Mar shampla, is féidir le Grok:

  1. Cuardach gréasáin a rith (uirlis freastalaí, 1 timthriall)
  2. Cód a fheidhmiú chun na torthaí a anailísiú (uirlis freastalaí, 1 timthriall)
  3. Iarradh ar do fheidhm shaincheaptha na torthaí a shábháil (uirlis cliant, athshocrú)
  4. Cuardach nua a rith bunaithe ar na torthaí a sábháladh (uirlis freastalaí, 1 timthriall le háireamh nua)
async def hybrid_workflow(question: str) -> str:
    messages = [{"role": "user", "content": question}]

    while True:
        response = await client.chat.completions.create(
            model="grok-4.5",
            messages=messages,
            tools=server_and_client_tools,
            max_turns=5
        )

        message = response.choices[0].message

        # If no client tool call, we have the final answer
        if not message.tool_calls:
            return message.content

        # Process client tool calls
        messages.append(message)
        for tool_call in message.tool_calls:
            result = await execute_local_tool(tool_call)
            messages.append({
                "role": "tool",
                "tool_call_id": tool_call.id,
                "content": result
            })

Láimhseálann an patrún lúibe seo go huathoibríoch an t-idirghníomhaíocht idir Grok agus do fheidhmeanna áitiúla. Leanann an lúb ar aghaidh fad is a theastaíonn ó Grok glao a chur ar do chuid uirlisí. Stopann sé nuair a sholáthraíonn sé freagra téacs deiridh.

max_turns a Shocrú

  • max_turns=1: Ní féidir le Grok ach uirlis freastalaí amháin a úsáid. Leor do chuardach gréasáin simplí.
  • max_turns=3-5: cothromaíocht mhaith don chuid is mó de chásanna. Is féidir le Grok slabhra cuardaigh + anailíse + fíoraithe a dhéanamh.
  • max_turns=10+: do thascanna casta a éilíonn go leor atriallacha. Bí ar an airdeall maidir le costais token.

Ní chosnaíonn luach max_turns atá ró-ard aon rud mura n-úsáidtear é, ach is féidir le luach max_turns atá ró-íseal réasúnaíocht Grok a ghearradh go tobann i lár an tasc.

Príomhphointí

  • Caitheann uirlisí freastalaí (cuardach gréasáin, feidhmiú cód) timthriallta max_turns
  • Athshocraíonn uirlisí cliant (do fheidhmeanna) an t-áireamh le gach iarratas nua
  • Láimhseálann an patrún lúibe while True an t-idirghníomhaíocht go dtí an freagra deiridh
  • Tosaigh le max_turns=5 agus coigeartaigh é bunaithe ar chastacht do thasc
  • Caitheann gach timthriall freastalaí token breise (comhthéacs carnach)