Responses API és function_call_output
Ezen az oldalon
A Responses API: az új végpont
A Responses API az xAI új elsődleges végpontja, amely elkülönül az OpenAI-kompatibilis Chat Completions végponttól. Bevezet egy eltérő formátumot a függvényhívásokhoz, ahol az function_call_output típust használja az eszközök eredményeinek visszaadására.
Különbségek a Chat Completions-höz képest
A Chat Completions végpont (OpenAI-kompatibilis) a tool szerepkörű üzeneteket használja az eredmények visszaadására. A Responses API ettől eltérő, eseménytípusokra épülő formátumot alkalmaz.
Chat Completions (régi formátum)
# Az eredmény visszaadása "tool" szerepkörű üzenettel
messages.append({
"role": "tool",
"tool_call_id": "call_abc123",
"content": {temp: 22, city: Paris}
})
Responses API (új formátum)
# Az eredmény visszaadása function_call_output objektummal
{
"type": "function_call_output",
"call_id": "call_abc123",
"output": {temp: 22, city: Paris}
}
Fő különbségek:
- A
type: "function_call_output"helyettesíti arole: "tool"mezőt - A
call_idhelyettesíti atool_call_idmezőt - Az
outputhelyettesíti acontentmezőt
A Responses API használata az OpenAI SDK-val
Az OpenAI SDK-t használhatod az xAI Responses API-jának hívására:
from openai import OpenAI
client = OpenAI(
api_key="votre-cle-api",
base_url="https://api.x.ai/v1"
)
# Válasz létrehozása eszközökkel
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"]
}
}]
)
Vedd észre, hogy a Responses API az input mezőt használja a messages helyett, és az eszközök struktúrája is kissé eltér (nincs beágyazott function objektum).
A válasz kezelése
A Responses API válasza egy output tömböt tartalmaz eseményekkel:
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}")
# A függvény végrehajtása
result = get_weather(city="Paris")
# A beszélgetés folytatása az eredménnyel
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
)
A previous_response_id mező
A Responses API bevezet egy beszélgetés-láncolási mechanizmust a previous_response_id segítségével. A teljes üzenetelőzmények újbóli elküldése helyett egyszerűen hivatkozhatsz az előző válaszra:
# Első kérés
response1 = client.responses.create(
model="grok-4.5",
input="Look up the weather in Paris"
)
# Második kérés (láncolt)
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
)
Ez leegyszerűsíti a kontextuskezelést és csökkenti a kérések méretét.
Üzenetek szerveroldali tárolása
A store_messages=True beállítással az xAI a szerverein tárolja az üzeneteket:
response = client.responses.create(
model="grok-4.5",
input="User question",
tools=tools,
store_messages=True
)
A previous_response_id-vel kombinálva ez lehetővé teszi hosszú beszélgetések kezelését anélkül, hogy minden kéréssel elküldenéd a teljes előzményt.
Mikor használd a Responses API-t?
Ha egy kifejezetten az xAI-ra épülő új projektet indítasz, a Responses API az alapértelmezett választás, több egymást erősítő okból is. Az innovációk itt jelennek meg először – az új funkciókat először (néha kizárólag) a Responses API-ban adják hozzá. Bizonyos beépített szerveres eszközök csak ezen a csatornán érhetők el. Hosszú beszélgetések esetén a previous_response_id-n keresztüli láncolás szerkezetileg hatékonyabb, mint a teljes előzmények minden körbeni újbóli elküldése: kevesebb tokent kell átvinni, és neked is kevesebb állapotkezelő kódot kell írnod.
A Chat Completions továbbra is két erős felhasználási esetet szolgál ki: a meglévő, OpenAI API-hoz írt kódokat, amelyek az alapértelmezett URL megváltoztatásával változtatás nélkül működnek, valamint a több szolgáltatót használó projekteket, ahol a hordozhatóság elsőbbséget élvez – ezekben a helyzetekben a kompatibilitás fontosabb, mint a kizárólagos funkciók.
Főbb megállapítások
- A Responses API a
function_call_outputtípust használja atoolszerepkör helyett - A mezők megváltoznak:
call_idatool_call_idhelyett,outputacontenthelyett - A
previous_response_idlehetővé teszi a beszélgetések láncolását az előzmények újbóli elküldése nélkül - A
store_messages=Trueengedélyezi a szerveroldali tárolást - A Responses API az ajánlott végpont az új xAI-projektekhez
- A Chat Completions továbbra is elérhető az OpenAI visszafelé való kompatibilitás biztosítására