Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Responses API in function_call_output

Lekcija 10 od 14 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Responses API: nova končna točka
  2. Razlike glede na Chat Completions
  3. Uporaba Responses API z OpenAI SDK
  4. Obdelava odziva
  5. Polje previous_response_id
  6. Shranjevanje sporočil na strežniku
  7. Kdaj uporabiti Responses API?
  8. Ključne ugotovitve

Responses API: nova končna točka

Responses API je nova glavna končna točka xAI, ločena od končne točke Chat Completions, združljive z OpenAI. Uvaja drugačen format za klicanje funkcij, ki uporablja tip function_call_output za vračanje rezultatov orodij.

Razlike glede na Chat Completions

Končna točka Chat Completions (združljiva z OpenAI) uporablja sporočila z vlogo tool za vračanje rezultatov. Responses API uporablja drugačen format, strukturiran okoli vrst dogodkov.

Chat Completions (stari format)

# Vrni rezultat prek sporočila z vlogo "tool"
messages.append({
    "role": "tool",
    "tool_call_id": "call_abc123",
    "content": {temp: 22, city: Paris}
})

Responses API (novi format)

# Vrni rezultat prek objekta function_call_output
{
    "type": "function_call_output",
    "call_id": "call_abc123",
    "output": {temp: 22, city: Paris}
}

Ključne razlike:

  • type: "function_call_output" nadomesti role: "tool"
  • call_id nadomesti tool_call_id
  • output nadomesti content

Uporaba Responses API z OpenAI SDK

Za klicanje Responses API xAI lahko uporabiš OpenAI SDK:

from openai import OpenAI

client = OpenAI(
    api_key="votre-cle-api",
    base_url="https://api.x.ai/v1"
)

# Ustvari odziv z orodji
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"]
        }
    }]
)

Upoštevaj, da Responses API uporablja input namesto messages, struktura orodij pa je nekoliko drugačna (ni gnezdenega objekta function).

Obdelava odziva

Odziv Responses API vsebuje polje output z dogodki:

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}")

        # Izvedi funkcijo
        result = get_weather(city="Paris")

        # Nadaljuj pogovor z 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 uvaja mehanizem povezovanja pogovorov prek previous_response_id. Namesto ponovnega pošiljanja celotne zgodovine sporočil preprosto sklicuješ prejšnji odziv:

# Prva zahteva
response1 = client.responses.create(
    model="grok-4.5",
    input="Look up the weather in Paris"
)

# Druga zahteva (povezana)
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
)

To poenostavi upravljanje konteksta in zmanjša velikost zahtev.

Shranjevanje sporočil na strežniku

Z nastavitvijo store_messages=True xAI shrani sporočila na svojih strežnikih:

response = client.responses.create(
    model="grok-4.5",
    input="User question",
    tools=tools,
    store_messages=True
)

V kombinaciji z previous_response_id ti to omogoča vzdrževanje dolgih pogovorov, ne da bi moral pri vsaki zahtevi znova pošiljati celotno zgodovino.

Kdaj uporabiti Responses API?

Za nov projekt, zgrajen posebej na xAI, je Responses API privzeta izbira iz več medsebojno okrepljujočih razlogov. Inovacije se najprej pojavijo tukaj – nove funkcije so dodane v Responses API pred kjer koli drugje, včasih izključno. Določena vgrajena strežniška orodja so na voljo samo prek tega kanala. Pri dolgih pogovorih je povezovanje prek previous_response_id strukturno učinkovitejše od ponovnega pošiljanja celotne zgodovine ob vsakem koraku: prenese se manj žetonov, na tvoji strani pa je potrebnega manj kode za upravljanje stanja.

Chat Completions ohranja dva močna primera uporabe: obstoječa koda, napisana za API OpenAI, ki deluje brez sprememb zgolj z menjavo osnovnega URL-ja, ter projekti z več ponudniki, kjer ima prenosljivost prednost – v teh situacijah združljivost tehtneje od ekskluzivnih funkcij.

Ključne ugotovitve

  • Responses API uporablja function_call_output namesto vloge tool
  • Polja se spremenijo: call_id namesto tool_call_id, output namesto content
  • previous_response_id ti omogoča povezovanje pogovorov brez ponovnega pošiljanja zgodovine
  • store_messages=True omogoča shranjevanje na strežniku
  • Responses API je priporočena končna točka za nove projekte xAI
  • Chat Completions ostaja na voljo za povratno združljivost z OpenAI