Responses API ja function_call_output
Sellel lehel
Responses API: uus lõpp-punkt
Responses API on xAI uus peamine lõpp-punkt, mis erineb OpenAI-ga ühilduvast Chat Completionsi lõpp-punktist. See toob kasutusele funktsioonide kutsumiseks erineva vormingu, kasutades tööriista tulemuste tagastamiseks tüüpi function_call_output.
Erinevused Chat Completionsist
Chat Completionsi lõpp-punkt (OpenAI-ga ühilduv) kasutab tulemuste tagastamiseks sõnumeid rolliga tool. Responses API kasutab sündmuste tüüpidele üles ehitatud erinevat vormingut.
Chat Completions (vananenud vorming)
# Tagasta tulemus "tool" rolliga sõnumi kaudu
messages.append({
"role": "tool",
"tool_call_id": "call_abc123",
"content": {temp: 22, city: Paris}
})
Responses API (uus vorming)
# Tagasta tulemus function_call_output objekti kaudu
{
"type": "function_call_output",
"call_id": "call_abc123",
"output": {temp: 22, city: Paris}
}
Peamised erinevused:
type: "function_call_output"asendabrole: "tool"call_idasendabtool_call_idoutputasendabcontent
Responses API kasutamine OpenAI SDK-ga
Saad xAI Responses API kutsumiseks kasutada OpenAI SDK-d:
from openai import OpenAI
client = OpenAI(
api_key="votre-cle-api",
base_url="https://api.x.ai/v1"
)
# Loo vastus koos tööriistadega
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"]
}
}]
)
Pane tähele, et Responses API kasutab messages asemel input ja tööriistade struktuur on veidi erinev (pesastatud function objekti pole).
Vastuse töötlemine
Responses API vastus sisaldab sündmustega output massiivi:
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}")
# Käivita funktsioon
result = get_weather(city="Paris")
# Jätka vestlust tulemusega
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
)
Väli previous_response_id
Responses API tutvustab vestluse aheldamise mehhanismi välja previous_response_id kaudu. Kogu sõnumite ajaloo uuesti saatmise asemel viidad lihtsalt eelmisele vastusele:
# Esimene päring
response1 = client.responses.create(
model="grok-4.5",
input="Look up the weather in Paris"
)
# Teine päring (aheldatud)
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
)
See lihtsustab konteksti haldamist ja vähendab päringu suurust.
Sõnumite serveripoolne salvestamine
Kasutades store_messages=True, salvestab xAI sõnumid oma serveritesse:
response = client.responses.create(
model="grok-4.5",
input="User question",
tools=tools,
store_messages=True
)
Kombineerituna previous_response_id-ga võimaldab see pidada pikki vestlusi, saatmata iga päringuga kaasas kogu ajalugu.
Millal kasutada Responses API-t?
Uue projekti puhul, mis on ehitatud spetsiaalselt xAI peale, on Responses API vaikimisi valik mitmel põhjusel. Uuendused jõuavad esmalt just siia – uusi funktsioone lisatakse Responses API-le enne kui mujale, mõnikord isegi ainult sinna. Teatud sisseehitatud serveritööriistad on kättesaadavad ainult selle kanali kaudu. Pikemate vestluste puhul on aheldamine previous_response_id abil struktuurselt tõhusam kui kogu ajaloo uuesti saatmine igal sammul: edastatakse vähem tokeneid ja sinu poolt on vaja vähem oleku haldamise koodi.
Chat Completionsil on endiselt kaks tugevat kasutusjuhtu: olemasolev kood, mis on kirjutatud OpenAI API jaoks ja töötab muutmata kujul, kui muudad ainult baas-URL-i, ning mitut pakkujat hõlmavad projektid, kus ühilduvus on esmatähtis – sellistes olukordades kaalub ühilduvus üles eksklusiivsed funktsioonid.
Peamised punktid
- Responses API kasutab
toolrolli asemelfunction_call_output - Väljad muutuvad:
tool_call_idasemelcall_id,contentasemeloutput previous_response_idvõimaldab vestlusi aheldada ilma ajaloo uuesti saatmisetastore_messages=Truevõimaldab serveripoolset salvestamist- Responses API on soovitatav lõpp-punkt uutele xAI projektidele
- Chat Completions jääb kättesaadavaks OpenAI tagasiühilduvuse jaoks