Responses API ir function_call_output
Šiame puslapyje
Responses API: naujas galinis taškas
Responses API yra pagrindinis naujas xAI galinis taškas, besiskiriantis nuo OpenAI suderinamo „Chat Completions“ galinio taško. Jis pristato kitokį funkcijų kvietimo formatą, naudojant function_call_output tipą įrankių rezultatams grąžinti.
Skirtumai nuo Chat Completions
„Chat Completions“ galinis taškas (suderinamas su OpenAI) naudoja tool vaidmens žinutes rezultatams grąžinti. Responses API naudoja kitokį formatą, sukurtą aplink įvykių tipus.
Chat Completions (senasis formatas)
# Grąžinti rezultatą per „tool“ vaidmens žinutę
messages.append({
"role": "tool",
"tool_call_id": "call_abc123",
"content": {temp: 22, city: Paris}
})
Responses API (naujas formatas)
# Grąžinti rezultatą per function_call_output objektą
{
"type": "function_call_output",
"call_id": "call_abc123",
"output": {temp: 22, city: Paris}
}
Pagrindiniai skirtumai:
type: "function_call_output"pakeičiarole: "tool"call_idpakeičiatool_call_idoutputpakeičiacontent
Responses API naudojimas su OpenAI SDK
Galite naudoti OpenAI SDK norėdami kreiptis į xAI Responses API:
from openai import OpenAI
client = OpenAI(
api_key="votre-cle-api",
base_url="https://api.x.ai/v1"
)
# Sukurti atsakymą su įrankiais
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"]
}
}]
)
Atkreipkite dėmesį, kad Responses API naudoja input vietoj messages, o įrankių struktūra šiek tiek skiriasi (nėra įdėto function objekto).
Atsakymo apdorojimas
Responses API atsakyme yra output masyvas su įvykiais:
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}")
# Vykdyti funkciją
result = get_weather(city="Paris")
# Tęsti pokalbį su rezultatu
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
)
previous_response_id laukas
Responses API pristato pokalbių grandinimo mechanizmą per previous_response_id. Užuot siuntę visą žinučių istoriją iš naujo, tiesiog nurodote ankstesnį atsakymą:
# Pirmasis užklausimas
response1 = client.responses.create(
model="grok-4.5",
input="Look up the weather in Paris"
)
# Antrasis užklausimas (grandinėje)
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
)
Tai supaprastina konteksto valdymą ir sumažina užklausos dydį.
Žinučių saugojimas serverio pusėje
Nustačius store_messages=True, xAI saugo žinutes savo serveriuose:
response = client.responses.create(
model="grok-4.5",
input="User question",
tools=tools,
store_messages=True
)
Derinant su previous_response_id, tai leidžia palaikyti ilgus pokalbius nesiunčiant visos istorijos su kiekviena užklausa.
Kada naudoti Responses API?
Naujam projektui, sukurtam specialiai xAI aplinkoje, Responses API yra numatytasis pasirinkimas dėl kelių sustiprinančių priežasčių. Naujovės čia atsiranda pirmiausia – naujos funkcijos pridedamos prie Responses API anksčiau nei bet kur kitur, kartais išskirtinai. Tam tikri integruoti serverio įrankiai yra prieinami tik per šį kanalą. Be to, ilgiems pokalbiams grandininimas per previous_response_id yra struktūriškai efektyvesnis nei visos istorijos siuntimas kiekviename etape: perduodama mažiau tokenų, o jūsų pusėje reikia mažiau būsenos valdymo kodo.
„Chat Completions“ išlieka tinkamas dviem pagrindiniams atvejams: esamas kodas, parašytas OpenAI API, kuris veikia iš karto pakeitus tik bazinį URL, ir projektai su keliais tiekėjais, kur portuojamumas yra svarbesnis – tokiose situacijose suderinamumas nusveria išskirtines funkcijas.
Svarbiausi punktai
- Responses API naudoja
function_call_outputvietojtoolvaidmens - Laukai keičiasi:
call_idvietojtool_call_id,outputvietojcontent previous_response_idleidžia grandinti pokalbius nesiunčiant istorijos iš naujostore_messages=Trueįgalina saugojimą serverio pusėje- Responses API yra rekomenduojamas galinis taškas naujiems xAI projektams
- „Chat Completions“ išlieka prieinamas atgaliniam OpenAI suderinamumui užtikrinti