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

Comhráite Ilchasta le Uirlisí

Ceacht 11 as 14 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Comhráite ilchasta le glaonna feidhme
  2. An paraiméadar max_turns
  3. Lúb ilchasta taobh an chliaint
  4. Comhthéacs ilchasta leis an API Freagraí
  5. Patrúin chomhrá ilchasta
  6. Bainistiú cuimhne
  7. Príomhphointí

Comhráite ilchasta le glaonna feidhme

I gcomhrá fíor, b’fhéidir go mbeidh ar an tsamhail uirlisí a ghlaodh níos mó ná uair amháin le linn an mhalartaithe. Is féidir le gach casadh glaonna nua a bheith i gceist, torthaí a spreagann glaonna eile, nó iarratais ar shoiléiriú ón úsáideoir sula n-úsáidtear uirlis.

An paraiméadar max_turns

Cuireann an paraiméadar max_turns teorainn le líon na gcasadh cúntóra/uirlise taobh freastalaí in aon iarratas amháin. Ní bhaineann sé ach le huirlisí ionsuite (web_search, code_interpreter, srl.).

response = client.responses.create(
    model="grok-4.5",
    input="Analyze 2026 tech trends",
    tools=[{"type": "web_search"}],
    max_turns=5  # Maximum 5 web searches before responding
)

Pointe tábhachtach: athshocraíonn glaonna uirlisí taobh an chliaint an comhaireamh. Nuair a sheolann tú function_call_output ar ais, tosaíonn leithdháileadh nua max_turns.

Lúb ilchasta taobh an chliaint

Chun comhráite a bhainistiú ina nglaonn an tsamhail uirlisí go minic, cuir lúb i bhfeidhm:

import json

def multi_turn_chat(user_message, tools, max_iterations=10):
    messages = [{"role": "user", "content": user_message}]

    for i in range(max_iterations):
        response = client.chat.completions.create(
            model="grok-4.5",
            messages=messages,
            tools=tools
        )

        message = response.choices[0].message
        messages.append(message)

        # Mura bhfuil tool_call ann, tá an comhrá thart
        if not message.tool_calls:
            return message.content

        # Feidhmigh gach uirlis a iarradh
        for tool_call in message.tool_calls:
            args = json.loads(tool_call.function.arguments)
            result = execute_function(tool_call.function.name, args)
            messages.append({
                "role": "tool",
                "tool_call_id": tool_call.id,
                "content": json.dumps(result)
            })

    return "Maximum number of iterations reached"

Is cosaint riachtanach é an athróg max_iterations chun lúba gan teorainn a chosc. I dtáirgeadh, socraigh teorainn réasúnach (5–10 gcasadh).

Comhthéacs ilchasta leis an API Freagraí

Tairgeann an API Freagraí dhá mheicníocht chun comhthéacs a choinneáil:

1. Stóráil i gcéin

# An chéad teachtaireacht
r1 = client.responses.create(
    model="grok-4.5",
    input="What's the weather like in Paris?",
    tools=tools,
    store_messages=True
)

# Toradh na huirlise
r2 = client.responses.create(
    model="grok-4.5",
    input=[{
        "type": "function_call_output",
        "call_id": r1.output[0].call_id,
        "output": {temp: 18}
    }],
    previous_response_id=r1.id,
    store_messages=True
)

# Ceist leantach (coinnítear an comhthéacs)
r3 = client.responses.create(
    model="grok-4.5",
    input="What about tomorrow?",
    previous_response_id=r2.id,
    tools=tools,
    store_messages=True
)

An buntáiste: ní gá duit stair na dteachtaireachtaí a bhainistiú. Déanann xAI í a stóráil agus a aisghabháil go huathoibríoch trí previous_response_id.

2. Ábhar criptithe taobh an chliaint

response = client.responses.create(
    model="grok-4.5",
    input="Search for flight prices to Nice",
    tools=tools,
    use_encrypted_content=True
)

Le use_encrypted_content=True, faigheann tú réasúnaíocht agus aschuir uirlisí i bhfoirm chriptithe. Seolann tú ar ais iad mar atá siad in iarratais ina dhiaidh sin, gan bheith in ann iad a léamh. Tá sé seo úsáideach nuair nach dteastaíonn uait go dtéadh sonraí i nglántéacs trí do fhreastalaí.

Patrúin chomhrá ilchasta

Patrún: Cuardach ansin gníomh

Casadh 1 : Úsáideoir → "Faigh eitilt saor ó Pháras go Nice"
           Samhail → tool_call: search_flights(from="CDG", to="NCE")
           Cliant → toradh : [{flight1}, {flight2}, {flight3}]
Casadh 2 : Samhail → "Fuair mé 3 eitilt. Is é €89 an ceann is saoire. Ar mhaith leat é a chur in áirithe?"
           Úsáideoir → "Sea, cuir in áirithe an eitilt €89"
Casadh 3 : Samhail → tool_call: book_flight(flight_id="FL123", passengers=1)

Patrún: Comhiomlánú sonraí

Casadh 1 : Samhail → tool_call: get_sales(month="march")
Casadh 2 : Samhail → tool_call: get_expenses(month="march")
Casadh 3 : Samhail → tool_call: get_headcount(month="march")
Casadh 4 : Samhail → "Seo an tuarascáil mhíosúil: díolacháin +12%, caiteachas -3%, líon foirne cobhsaí."

Patrún: Scagadh céim ar chéim

Casadh 1 : Samhail → tool_call: search_products(query="running shoes")
           Toradh → 150 táirge
Casadh 2 : Samhail → "Fuair mé 150 táirge. Cén méid agus cén buiséad?"
           Úsáideoir → "42, max €120"
Casadh 3 : Samhail → tool_call: search_products(query="running shoes", size=42, max_price=120)
           Toradh → 8 dtáirge

Bainistiú cuimhne

I gcomhráite fada, fásann an stair—lena n-áirítear gach tool_call agus gach toradh uirlise—go tapa, agus leis sin costais gach casaidh. Tá trí straitéis ar fáil duit, ó láimhe go hiomlán tarmligthe. Déanann achoimriú tréimhsiúil comhdhlúthú ar sheanchasanna níos sine ina mír a instealltar sa chóras-leide: coinníonn tú substaint na malartuithe roimhe seo ar chodán dá meáchan tocain, ar chostas roinnt mionsonraí a chailleadh. Tá an fhuinneog shleamhnáin níos garbha ach níos simplí: ná coinnigh ach na N casadh deireanach, ag glacadh leis go ndéanfaidh an tsamhail dearmad ar thús an chomhrá—oiriúnach nuair nach bhfuil tábhacht oibríochtúil ag baint le malartuithe níos sine. Deireadh thiar, tarmligíonn stóráil i gcéin an fhadhb chuig xAI le store_messages=True: maireann an stair taobh freastalaí, agus ní iompraíonn d’iarratas ach tagairt. Braitheann an rogha cheart ar an méid a theastaíonn ó d’iarratas a mheabhrú, agus ar feadh cá fhad.

Príomhphointí

  • Cuireann max_turns teorainn le casaidh uirlisí taobh an fhreastalaí—athshocraíonn uirlisí an chliaint an comhaireamh
  • Cuir lúb i bhfeidhm le max_iterations chun lúba gan teorainn a chosc
  • Slabhraíonn previous_response_id comhráite gan an stair a athsheoladh
  • Tarmligíonn store_messages=True stóráil an chomhthéacs chuig xAI
  • Cosnaíonn use_encrypted_content=True sonraí i mbéal aistrithe
  • Bainistigh cuimhne i gcomhráite fada (achoimriú, fuinneog shleamhnáin)