Responses API un function_call_output
Šajā lapā
Responses API: jaunais galapunkts
Responses API ir xAI galvenais jaunais galapunkts, kas atšķiras no OpenAI saderīgā Chat Completions galapunkta. Tas ievieš citu funkciju izsaukšanas formātu, izmantojot tipu function_call_output, lai atgrieztu rīku rezultātus.
Atšķirības no Chat Completions
Chat Completions galapunkts (OpenAI saderīgs) izmanto ziņojumus ar lomu tool, lai atgrieztu rezultātus. Responses API izmanto citu formātu, kas strukturēts ap notikumu tipiem.
Chat Completions (vecais formāts)
# Return the result via a "tool" role message
messages.append({
"role": "tool",
"tool_call_id": "call_abc123",
"content": {temp: 22, city: Paris}
})
Responses API (jaunais formāts)
# Return the result via a function_call_output object
{
"type": "function_call_output",
"call_id": "call_abc123",
"output": {temp: 22, city: Paris}
}
Galvenās atšķirības:
type: "function_call_output"aizstājrole: "tool"call_idaizstājtool_call_idoutputaizstājcontent
Responses API izmantošana ar OpenAI SDK
Tu vari izmantot OpenAI SDK, lai izsauktu xAI Responses API:
from openai import OpenAI
client = OpenAI(
api_key="votre-cle-api",
base_url="https://api.x.ai/v1"
)
# Create a response with tools
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"]
}
}]
)
Ņem vērā, ka Responses API izmanto input messages vietā, un rīku struktūra ir nedaudz atšķirīga (nav ligzdotā function objekta).
Atbildes apstrāde
Responses API atbilde satur masīvu output ar notikumiem:
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}")
# Execute the function
result = get_weather(city="Paris")
# Continue the conversation with the result
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
)
Lauks previous_response_id
Responses API ievieš sarunu ķēdes mehānismu, izmantojot previous_response_id. Visa ziņojumu vēstures nosūtīšanas vietā tu vienkārši atsaucies uz iepriekšējo atbildi:
# First request
response1 = client.responses.create(
model="grok-4.5",
input="Look up the weather in Paris"
)
# Second request (chained)
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
)
Tas vienkāršo konteksta pārvaldību un samazina pieprasījuma lielumu.
Ziņojumu glabāšana servera pusē
Izmantojot store_messages=True, xAI glabā ziņojumus savos serveros:
response = client.responses.create(
model="grok-4.5",
input="User question",
tools=tools,
store_messages=True
)
Kombinējot to ar previous_response_id, tu vari uzturēt garas sarunas, katrā pieprasījumā nenosūtot pilnu vēsturi.
Kad lietot Responses API?
Jaunam projektam, kas veidots specifiski uz xAI bāzes, Responses API ir noklusējuma izvēle vairāku savstarpēji pastiprinošu iemeslu dēļ. Inovācijas vispirms parādās šeit – jaunas funkcijas tiek pievienotas Responses API pirms jebkur citur, dažreiz tikai tur. Noteikti iebūvētie servera rīki ir pieejami tikai caur šo kanālu. Turklāt garām sarunām ķēdes veidošana, izmantojot previous_response_id, ir strukturāli efektīvāka nekā pilnas vēstures nosūtīšana katrā solī: tiek pārsūtīts mazāk tokenus, un tev ir jāraksta mazāk koda stāvokļa pārvaldībai.
Chat Completions saglabā divus spēcīgus lietojumgadījumus: esošs kods, kas rakstīts OpenAI API, kas strādā tāpat, mainot tikai bāzes URL, un multi-provider projekti, kur portējamība ir prioritāte – šādās situācijās saderība ir svarīgāka par ekskluzīvām funkcijām.
Galvenās atziņas
- Responses API izmanto
function_call_outputlomastoolvietā - Lauki mainās:
call_idtool_call_idvietā,outputcontentvietā previous_response_idļauj ķēdēt sarunas, nenosūtot vēsturi atkārtotistore_messages=Trueaktivizē glabāšanu servera pusē- Responses API ir ieteicamais galapunkts jauniem xAI projektiem
- Chat Completions paliek pieejams atpakaļsaderībai ar OpenAI