Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Responses API un function_call_output

Nodarbība 10 no 14 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. Responses API: jaunais galapunkts
  2. Atšķirības no Chat Completions
  3. Responses API izmantošana ar OpenAI SDK
  4. Atbildes apstrāde
  5. Lauks previous_response_id
  6. Ziņojumu glabāšana servera pusē
  7. Kad lietot Responses API?
  8. Galvenās atziņas

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āj role: "tool"
  • call_id aizstāj tool_call_id
  • output aizstāj content

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_output lomas tool vietā
  • Lauki mainās: call_id tool_call_id vietā, output content vietā
  • previous_response_id ļauj ķēdēt sarunas, nenosūtot vēsturi atkārtoti
  • store_messages=True aktivizē glabāšanu servera pusē
  • Responses API ir ieteicamais galapunkts jauniem xAI projektiem
  • Chat Completions paliek pieejams atpakaļsaderībai ar OpenAI