Responses API i function_call_output
Na ovoj stranici
Responses API: nova krajnja točka
Responses API je nova glavna krajnja točka tvrtke xAI, različita od krajnje točke Chat Completions kompatibilne s OpenAI-jem. Uvodi drugačiji format za pozivanje funkcija, koristeći tip function_call_output za vraćanje rezultata alata.
Razlike u odnosu na Chat Completions
Krajnja točka Chat Completions (kompatibilna s OpenAI-jem) koristi poruke s ulogom tool za vraćanje rezultata. Responses API koristi drugačiji format strukturiran oko vrsta događaja.
Chat Completions (stariji format)
# Vrati rezultat putem poruke s ulogom "tool"
messages.append({
"role": "tool",
"tool_call_id": "call_abc123",
"content": {temp: 22, city: Paris}
})
Responses API (novi format)
# Vrati rezultat putem objekta function_call_output
{
"type": "function_call_output",
"call_id": "call_abc123",
"output": {temp: 22, city: Paris}
}
Ključne razlike:
type: "function_call_output"zamjenjujerole: "tool"call_idzamjenjujetool_call_idoutputzamjenjujecontent
Korištenje Responses API-ja s OpenAI SDK-om
Možeš koristiti OpenAI SDK za pozivanje xAI-jevog Responses API-ja:
from openai import OpenAI
client = OpenAI(
api_key="votre-cle-api",
base_url="https://api.x.ai/v1"
)
# Stvori odgovor s alatima
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"]
}
}]
)
Imaj na umu da Responses API koristi input umjesto messages, a struktura alata je nešto drugačija (nema ugniježđenog objekta function).
Rukovanje odgovorom
Odgovor Responses API-ja sadrži polje output s nizom događaja:
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}")
# Izvrši funkciju
result = get_weather(city="Paris")
# Nastavi razgovor s 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 uvodi mehanizam lančanja razgovora putem previous_response_id. Umjesto ponovnog slanja cijele povijesti poruka, jednostavno referenciraš prethodni odgovor:
# Prvi zahtjev
response1 = client.responses.create(
model="grok-4.5",
input="Look up the weather in Paris"
)
# Drugi zahtjev (lančan)
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
)
Ovo pojednostavljuje upravljanje kontekstom i smanjuje veličinu zahtjeva.
Pohrana poruka na strani poslužitelja
S store_messages=True, xAI pohranjuje poruke na svojim poslužiteljima:
response = client.responses.create(
model="grok-4.5",
input="User question",
tools=tools,
store_messages=True
)
U kombinaciji s previous_response_id, ovo ti omogućuje vođenje dugih razgovora bez ponovnog slanja pune povijesti sa svakim zahtjevom.
Kada koristiti Responses API?
Za novi projekt izgrađen specifično na xAI-u, Responses API je zadani izbor iz nekoliko kumulativnih razloga. Inovacije prvo stižu ovdje – nove značajke dodaju se u Responses API prije bilo kojeg drugog mjesta, ponekad isključivo. Određeni ugrađeni poslužiteljski alati dostupni su samo kroz ovaj kanal. A za duge razgovore, lančanje putem previous_response_id strukturno je učinkovitije od ponovnog slanja pune povijesti u svakom koraku: manje prenesenih tokena, manje koda za upravljanje stanjem na tvojoj strani.
Chat Completions zadržava dva snažna slučaja upotrebe: postojeći kod napisan za OpenAI API, koji radi kakav jest promjenom osnovnog URL-a, te projekti s više pružatelja usluga gdje je prenosivost prioritet – u tim situacijama kompatibilnost nadmašuje ekskluzivne značajke.
Ključne točke
- Responses API koristi
function_call_outputumjesto ulogetool - Polja se mijenjaju:
call_idumjestotool_call_id,outputumjestocontent previous_response_idomogućuje lančanje razgovora bez ponovnog slanja povijestistore_messages=Trueomogućuje pohranu na strani poslužitelja- Responses API je preporučena krajnja točka za nove xAI projekte
- Chat Completions ostaje dostupan za povratnu kompatibilnost s OpenAI-jem