L-API Responses u function_call_output
F'din il-paġna
L-API Responses: l-endpoint il-ġdid
L-API Responses hija l-endpoint primarju l-ġdid ta’ xAI, distint mill-endpoint Chat Completions kompatibbli ma’ OpenAI. Tintroduċi format differenti għas-sejħa tal-funzjonijiet, billi tuża t-tip function_call_output biex tirritorna r-riżultati tal-għodod.
Differenzi minn Chat Completions
L-endpoint Chat Completions (kompatibbli ma’ OpenAI) juża messaġġi bir-rwol tool biex jirritorna r-riżultati. L-API Responses tuża format differenti, strutturat madwar tipi ta’ avvenimenti.
Chat Completions (format antik)
# Irritorna r-riżultat permezz ta' messaġġ bir-rwol "tool"
messages.append({
"role": "tool",
"tool_call_id": "call_abc123",
"content": {temp: 22, city: Paris}
})
API Responses (format ġdid)
# Irritorna r-riżultat permezz ta' oġġett function_call_output
{
"type": "function_call_output",
"call_id": "call_abc123",
"output": {temp: 22, city: Paris}
}
Differenzi ewlenin:
type: "function_call_output"tissostitwixxirole: "tool"call_idtissostitwixxitool_call_idoutputtissostitwixxicontent
Kif tuża l-API Responses mas-SDK ta’ OpenAI
Tista’ tuża s-SDK ta’ OpenAI biex issejjaħ l-API Responses ta’ xAI:
from openai import OpenAI
client = OpenAI(
api_key="votre-cle-api",
base_url="https://api.x.ai/v1"
)
# Oħloq risposta b'għodod
response = client.responses.create(
model="grok-4.5",
input="What's the weather like in Paris?",
tools=[{
"type": "function",
"name": "get_weather",
"description": "Get the weather for a city",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string"}
},
"required": ["city"]
}
}]
)
Innota li l-API Responses tuża input minflok messages, u l-istruttura tal-għodod hija kemxejn differenti (l-ebda oġġett function imbejjen).
Kif timmaniġġja r-risposta
Ir-risposta tal-API Responses fiha array output b’avvenimenti:
for item in response.output:
if item.type == "function_call":
print(f"Function: {item.name}")
print(f"Arguments: {item.arguments}")
print(f"Call ID: {item.call_id}")
# Eżegwixxi l-funzjoni
result = get_weather(city="Paris")
# Kompli l-konversazzjoni bir-riżultat
follow_up = client.responses.create(
model="grok-4.5",
input=[
{"type": "function_call_output",
"call_id": item.call_id,
"output": json.dumps(result)}
],
tools=tools,
previous_response_id=response.id
)
Il-qasam previous_response_id
L-API Responses tintroduċi mekkaniżmu ta’ katina tal-konversazzjoni permezz ta’ previous_response_id. Minflok tibgħat mill-ġdid l-istorja sħiħa tal-messaġġi, sempliċiment tirreferenzja r-risposta preċedenti:
# L-ewwel talba
response1 = client.responses.create(
model="grok-4.5",
input="Look up the weather in Paris"
)
# It-tieni talba (magħquda)
response2 = client.responses.create(
model="grok-4.5",
input=[{
"type": "function_call_output",
"call_id": response1.output[0].call_id,
"output": {temp: 22}
}],
previous_response_id=response1.id
)
Dan jissimplifika l-ġestjoni tal-kuntest u jnaqqas id-daqs tat-talbiet.
Ħażna tal-messaġġi fuq is-server
B’store_messages=True, xAI taħżen il-messaġġi fuq is-servers tagħhom:
response = client.responses.create(
model="grok-4.5",
input="User question",
tools=tools,
store_messages=True
)
Meta tingħaqad ma’ previous_response_id, dan jippermettilek iżżomm konversazzjonijiet twal mingħajr ma terġa’ tibgħat l-istorja sħiħa ma’ kull talba.
Meta għandek tuża l-API Responses?
Għal proġett ġdid mibni speċifikament fuq xAI, l-API Responses hija l-għażla default, għal diversi raġunijiet kumulattivi. L-innovazzjonijiet jaslu hawn l-ewwel—karatteristiċi ġodda jiżdiedu mal-API Responses qabel kullimkien ieħor, xi kultant esklussivament. Ċerti għodod tas-server integrati huma disponibbli biss permezz ta’ dan il-kanal. U għal konversazzjonijiet twal, il-katina permezz ta’ previous_response_id hija strutturalment aktar effiċjenti milli terġa’ tibgħat l-istorja sħiħa f’kull dawra: inqas tokens trasferiti, inqas kodiċi ta’ ġestjoni tal-istat fuq in-naħa tiegħek.
Chat Completions iżżomm żewġ każijiet ta’ użu b’saħħithom: kodiċi eżistenti miktub għall-API ta’ OpenAI, li jaħdem kif inhu billi tbiddel l-URL bażi, u proġetti b’ħafna fornituri fejn il-portabbiltà tieħu preċedenza—f’dawn is-sitwazzjonijiet, il-kompatibbiltà tiżen aktar mill-karatteristiċi esklussivi.
Punti Ewlenin
- L-API Responses tuża
function_call_outputminflok ir-rwoltool - Il-qasam jinbidel:
call_idminfloktool_call_id,outputminflokcontent previous_response_idjippermettilek tgħaqqad il-konversazzjonijiet mingħajr ma terġa’ tibgħat l-istorjastore_messages=Truejippermetti l-ħażna fuq is-server- L-API Responses hija l-endpoint rakkomandat għal proġetti ġodda ta’ xAI
- Chat Completions tibqa’ disponibbli għall-kompatibbiltà lura ma’ OpenAI