Responses API a function_call_output
Na této stránce
Responses API: nový koncový bod
Responses API je hlavní nový koncový bod společnosti xAI, odlišný od koncového bodu Chat Completions kompatibilního s OpenAI. Zavádí odlišný formát pro volání funkcí, který využívá typ function_call_output k vrácení výsledků nástrojů.
Rozdíly oproti Chat Completions
Koncový bod Chat Completions (kompatibilní s OpenAI) používá zprávy s rolí tool k vrácení výsledků. Responses API využívá jiný formát strukturovaný kolem typů událostí.
Chat Completions (starší formát)
# Vrácení výsledku prostřednictvím zprávy s rolí "tool"
messages.append({
"role": "tool",
"tool_call_id": "call_abc123",
"content": {temp: 22, city: Paris}
})
Responses API (nový formát)
# Vrácení výsledku prostřednictvím objektu function_call_output
{
"type": "function_call_output",
"call_id": "call_abc123",
"output": {temp: 22, city: Paris}
}
Klíčové rozdíly:
type: "function_call_output"nahrazujerole: "tool"call_idnahrazujetool_call_idoutputnahrazujecontent
Používání Responses API se sadou OpenAI SDK
K volání Responses API od xAI můžeš použít sadu OpenAI SDK:
from openai import OpenAI
client = OpenAI(
api_key="votre-cle-api",
base_url="https://api.x.ai/v1"
)
# Vytvoření odpovědi s nástroji
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"]
}
}]
)
Všimni si, že Responses API používá input místo messages a struktura nástrojů se mírně liší (chybí vnořený objekt function).
Zpracování odpovědi
Odpověď z Responses API obsahuje pole output s událostmi:
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}")
# Provedení funkce
result = get_weather(city="Paris")
# Pokračování konverzace s výsledkem
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
)
Pole previous_response_id
Responses API zavádí mechanismus řetězení konverzací prostřednictvím previous_response_id. Místo opětovného odesílání celé historie zpráv jednoduše odkážeš na předchozí odpověď:
# První požadavek
response1 = client.responses.create(
model="grok-4.5",
input="Look up the weather in Paris"
)
# Druhý požadavek (řetězený)
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
)
Tím se zjednodušuje správa kontextu a snižuje velikost požadavků.
Ukládání zpráv na straně serveru
Pomocí store_messages=True ukládá xAI zprávy na svých serverech:
response = client.responses.create(
model="grok-4.5",
input="User question",
tools=tools,
store_messages=True
)
V kombinaci s previous_response_id ti to umožňuje udržovat dlouhé konverzace bez nutnosti odesílat při každém požadavku celou historii.
Kdy používat Responses API?
Pro nový projekt postavený specificky na xAI je Responses API výchozí volbou z několika kumulativních důvodů. Inovace se zde objevují jako první – nové funkce jsou přidávány do Responses API dříve než kamkoli jinam, někdy výhradně. Určité vestavěné serverové nástroje jsou dostupné pouze prostřednictvím tohoto kanálu. A pro dlouhé konverzace je řetězení přes previous_response_id strukturálně efektivnější než opakované odesílání celé historie v každém kole: přenáší se méně tokenů a ty musíš psát méně kódu pro správu stavu.
Chat Completions si zachovává dvě silná použití: existující kód napsaný pro API OpenAI, který funguje tak, jak je, po změně základní URL, a projekty s více poskytovateli, kde má prioritu přenositelnost – v těchto situacích převažuje kompatibilita nad exkluzivními funkcemi.
Klíčové poznatky
- Responses API používá
function_call_outputmísto roletool - Pole se mění:
call_idmístotool_call_id,outputmístocontent previous_response_idti umožňuje řetězit konverzace bez opětovného odesílání historiestore_messages=Trueumožňuje ukládání na straně serveru- Responses API je doporučený koncový bod pro nové projekty na xAI
- Chat Completions zůstává dostupný pro zpětnou kompatibilitu s OpenAI