Comhráite Ilchasta le Uirlisí
Ar an leathanach seo
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_turnsteorainn le casaidh uirlisí taobh an fhreastalaí—athshocraíonn uirlisí an chliaint an comhaireamh - Cuir lúb i bhfeidhm le
max_iterationschun lúba gan teorainn a chosc - Slabhraíonn
previous_response_idcomhráite gan an stair a athsheoladh - Tarmligíonn
store_messages=Truestóráil an chomhthéacs chuig xAI - Cosnaíonn
use_encrypted_content=Truesonraí i mbéal aistrithe - Bainistigh cuimhne i gcomhráite fada (achoimriú, fuinneog shleamhnáin)