Responses API in function_call_output
Na tej strani
Responses API: nova končna točka
Responses API je nova glavna končna točka xAI, ločena od končne točke Chat Completions, združljive z OpenAI. Uvaja drugačen format za klicanje funkcij, ki uporablja tip function_call_output za vračanje rezultatov orodij.
Razlike glede na Chat Completions
Končna točka Chat Completions (združljiva z OpenAI) uporablja sporočila z vlogo tool za vračanje rezultatov. Responses API uporablja drugačen format, strukturiran okoli vrst dogodkov.
Chat Completions (stari format)
# Vrni rezultat prek sporočila z vlogo "tool"
messages.append({
"role": "tool",
"tool_call_id": "call_abc123",
"content": {temp: 22, city: Paris}
})
Responses API (novi format)
# Vrni rezultat prek objekta function_call_output
{
"type": "function_call_output",
"call_id": "call_abc123",
"output": {temp: 22, city: Paris}
}
Ključne razlike:
type: "function_call_output"nadomestirole: "tool"call_idnadomestitool_call_idoutputnadomesticontent
Uporaba Responses API z OpenAI SDK
Za klicanje Responses API xAI lahko uporabiš OpenAI SDK:
from openai import OpenAI
client = OpenAI(
api_key="votre-cle-api",
base_url="https://api.x.ai/v1"
)
# Ustvari odziv z orodji
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"]
}
}]
)
Upoštevaj, da Responses API uporablja input namesto messages, struktura orodij pa je nekoliko drugačna (ni gnezdenega objekta function).
Obdelava odziva
Odziv Responses API vsebuje polje output z dogodki:
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}")
# Izvedi funkcijo
result = get_weather(city="Paris")
# Nadaljuj pogovor z rezultatom
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
)
Polje previous_response_id
Responses API uvaja mehanizem povezovanja pogovorov prek previous_response_id. Namesto ponovnega pošiljanja celotne zgodovine sporočil preprosto sklicuješ prejšnji odziv:
# Prva zahteva
response1 = client.responses.create(
model="grok-4.5",
input="Look up the weather in Paris"
)
# Druga zahteva (povezana)
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
)
To poenostavi upravljanje konteksta in zmanjša velikost zahtev.
Shranjevanje sporočil na strežniku
Z nastavitvijo store_messages=True xAI shrani sporočila na svojih strežnikih:
response = client.responses.create(
model="grok-4.5",
input="User question",
tools=tools,
store_messages=True
)
V kombinaciji z previous_response_id ti to omogoča vzdrževanje dolgih pogovorov, ne da bi moral pri vsaki zahtevi znova pošiljati celotno zgodovino.
Kdaj uporabiti Responses API?
Za nov projekt, zgrajen posebej na xAI, je Responses API privzeta izbira iz več medsebojno okrepljujočih razlogov. Inovacije se najprej pojavijo tukaj – nove funkcije so dodane v Responses API pred kjer koli drugje, včasih izključno. Določena vgrajena strežniška orodja so na voljo samo prek tega kanala. Pri dolgih pogovorih je povezovanje prek previous_response_id strukturno učinkovitejše od ponovnega pošiljanja celotne zgodovine ob vsakem koraku: prenese se manj žetonov, na tvoji strani pa je potrebnega manj kode za upravljanje stanja.
Chat Completions ohranja dva močna primera uporabe: obstoječa koda, napisana za API OpenAI, ki deluje brez sprememb zgolj z menjavo osnovnega URL-ja, ter projekti z več ponudniki, kjer ima prenosljivost prednost – v teh situacijah združljivost tehtneje od ekskluzivnih funkcij.
Ključne ugotovitve
- Responses API uporablja
function_call_outputnamesto vlogetool - Polja se spremenijo:
call_idnamestotool_call_id,outputnamestocontent previous_response_idti omogoča povezovanje pogovorov brez ponovnega pošiljanja zgodovinestore_messages=Trueomogoča shranjevanje na strežniku- Responses API je priporočena končna točka za nove projekte xAI
- Chat Completions ostaja na voljo za povratno združljivost z OpenAI