Responses API a function_call_output
Na tejto strane
Responses API: nový koncový bod
Responses API je hlavný nový koncový bod od xAI, ktorý sa líši od koncového bodu Chat Completions kompatibilného s OpenAI. Zavádza odlišný formát pre volanie funkcií, kde sa na vrátenie výsledkov nástrojov používa typ function_call_output.
Rozdiely oproti Chat Completions
Koncový bod Chat Completions (kompatibilný s OpenAI) používa na vrátenie výsledkov správy s rolou tool. Responses API používa iný formát štruktúrovaný okolo typov udalostí.
Chat Completions (starší formát)
# Vrátite výsledok prostredníctvom správy s rolou "tool"
messages.append({
"role": "tool",
"tool_call_id": "call_abc123",
"content": {temp: 22, city: Paris}
})
Responses API (nový formát)
# Vrátite výsledok prostredníctvom objektu function_call_output
{
"type": "function_call_output",
"call_id": "call_abc123",
"output": {temp: 22, city: Paris}
}
Kľúčové rozdiely:
type: "function_call_output"nahrádzarole: "tool"call_idnahrádzatool_call_idoutputnahrádzacontent
Používanie Responses API s OpenAI SDK
Na volanie Responses API od xAI môžeš použiť OpenAI SDK:
from openai import OpenAI
client = OpenAI(
api_key="votre-cle-api",
base_url="https://api.x.ai/v1"
)
# Vytvorenie odpovede s nástrojmi
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žíva input namiesto messages a štruktúra nástrojov sa mierne líši (chýba vnorený objekt function).
Spracovanie odpovede
Odpoveď z Responses API obsahuje pole output s udalosťami:
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}")
# Vykonanie funkcie
result = get_weather(city="Paris")
# Pokračovanie v konverzácii s výsledkom
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ádza mechanizmus reťazenia konverzácií prostredníctvom previous_response_id. Namiesto opätovného odoslania celej histórie správ jednoducho odkážeš na predchádzajúcu odpoveď:
# Prvá požiadavka
response1 = client.responses.create(
model="grok-4.5",
input="Look up the weather in Paris"
)
# Druhá požiadavka (reťazená)
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
)
Toto zjednodušuje správu kontextu a znižuje veľkosť požiadaviek.
Ukladanie správ na strane servera
Pomocou store_messages=True ukladá xAI správy na svojich serveroch:
response = client.responses.create(
model="grok-4.5",
input="User question",
tools=tools,
store_messages=True
)
V kombinácii s previous_response_id ti to umožňuje udržiavať dlhé konverzácie bez potreby odosielať pri každej požiadavke celú históriu.
Kedy používať Responses API?
Pre nový projekt postavený špecificky na xAI je Responses API predvolenou voľbou z niekoľkých dôvodov. Inovácie prichádzajú ako prvé sem – nové funkcie sa pridávajú do Responses API skôr než kamkoľvek inde, niekedy výlučne. Určité vstavané serverové nástroje sú dostupné len cez tento kanál. A pre dlhé konverzácie je reťazenie cez previous_response_id štrukturálne efektívnejšie než opätovné odosielanie celej histórie v každom kole: prenáša sa menej tokenov a ty máš menej kódu na správu stavu.
Chat Completions si zachováva dva silné prípady použitia: existujúci kód napísaný pre API OpenAI, ktorý funguje tak, ako je, po zmene base URL, a projekty s viacerými poskytovateľmi, kde má prioritu prenositeľnosť – v týchto situáciách preváža kompatibilita nad exkluzívnymi funkciami.
Kľúčové poznatky
- Responses API používa
function_call_outputnamiesto rolytool - Polia sa menia:
call_idnamiestotool_call_id,outputnamiestocontent previous_response_idti umožňuje reťaziť konverzácie bez opätovného odoslania históriestore_messages=Truepovoľuje ukladanie na strane servera- Responses API je odporúčaný koncový bod pre nové projekty na xAI
- Chat Completions zostáva dostupný pre spätnú kompatibilitu s OpenAI