Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Responses API i function_call_output

Lekcija 10 od 14 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Responses API: nova krajnja točka
  2. Razlike u odnosu na Chat Completions
  3. Korištenje Responses API-ja s OpenAI SDK-om
  4. Rukovanje odgovorom
  5. Polje previous_response_id
  6. Pohrana poruka na strani poslužitelja
  7. Kada koristiti Responses API?
  8. Ključne točke

Responses API: nova krajnja točka

Responses API je nova glavna krajnja točka tvrtke xAI, različita od krajnje točke Chat Completions kompatibilne s OpenAI-jem. Uvodi drugačiji format za pozivanje funkcija, koristeći tip function_call_output za vraćanje rezultata alata.

Razlike u odnosu na Chat Completions

Krajnja točka Chat Completions (kompatibilna s OpenAI-jem) koristi poruke s ulogom tool za vraćanje rezultata. Responses API koristi drugačiji format strukturiran oko vrsta događaja.

Chat Completions (stariji format)

# Vrati rezultat putem poruke s ulogom "tool"
messages.append({
    "role": "tool",
    "tool_call_id": "call_abc123",
    "content": {temp: 22, city: Paris}
})

Responses API (novi format)

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

Ključne razlike:

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

Korištenje Responses API-ja s OpenAI SDK-om

Možeš koristiti OpenAI SDK za pozivanje xAI-jevog Responses API-ja:

from openai import OpenAI

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

# Stvori odgovor s alatima
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"]
        }
    }]
)

Imaj na umu da Responses API koristi input umjesto messages, a struktura alata je nešto drugačija (nema ugniježđenog objekta function).

Rukovanje odgovorom

Odgovor Responses API-ja sadrži polje output s nizom događaja:

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

        # Izvrši funkciju
        result = get_weather(city="Paris")

        # Nastavi razgovor s 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 uvodi mehanizam lančanja razgovora putem previous_response_id. Umjesto ponovnog slanja cijele povijesti poruka, jednostavno referenciraš prethodni odgovor:

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

# Drugi zahtjev (lančan)
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
)

Ovo pojednostavljuje upravljanje kontekstom i smanjuje veličinu zahtjeva.

Pohrana poruka na strani poslužitelja

S store_messages=True, xAI pohranjuje poruke na svojim poslužiteljima:

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

U kombinaciji s previous_response_id, ovo ti omogućuje vođenje dugih razgovora bez ponovnog slanja pune povijesti sa svakim zahtjevom.

Kada koristiti Responses API?

Za novi projekt izgrađen specifično na xAI-u, Responses API je zadani izbor iz nekoliko kumulativnih razloga. Inovacije prvo stižu ovdje – nove značajke dodaju se u Responses API prije bilo kojeg drugog mjesta, ponekad isključivo. Određeni ugrađeni poslužiteljski alati dostupni su samo kroz ovaj kanal. A za duge razgovore, lančanje putem previous_response_id strukturno je učinkovitije od ponovnog slanja pune povijesti u svakom koraku: manje prenesenih tokena, manje koda za upravljanje stanjem na tvojoj strani.

Chat Completions zadržava dva snažna slučaja upotrebe: postojeći kod napisan za OpenAI API, koji radi kakav jest promjenom osnovnog URL-a, te projekti s više pružatelja usluga gdje je prenosivost prioritet – u tim situacijama kompatibilnost nadmašuje ekskluzivne značajke.

Ključne točke

  • Responses API koristi function_call_output umjesto uloge tool
  • Polja se mijenjaju: call_id umjesto tool_call_id, output umjesto content
  • previous_response_id omogućuje lančanje razgovora bez ponovnog slanja povijesti
  • store_messages=True omogućuje pohranu na strani poslužitelja
  • Responses API je preporučena krajnja točka za nove xAI projekte
  • Chat Completions ostaje dostupan za povratnu kompatibilnost s OpenAI-jem