Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Responses API és function_call_output

10. lecke 14 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. A Responses API: az új végpont
  2. Különbségek a Chat Completions-höz képest
  3. A Responses API használata az OpenAI SDK-val
  4. A válasz kezelése
  5. A previous_response_id mező
  6. Üzenetek szerveroldali tárolása
  7. Mikor használd a Responses API-t?
  8. Főbb megállapítások

A Responses API: az új végpont

A Responses API az xAI új elsődleges végpontja, amely elkülönül az OpenAI-kompatibilis Chat Completions végponttól. Bevezet egy eltérő formátumot a függvényhívásokhoz, ahol az function_call_output típust használja az eszközök eredményeinek visszaadására.

Különbségek a Chat Completions-höz képest

A Chat Completions végpont (OpenAI-kompatibilis) a tool szerepkörű üzeneteket használja az eredmények visszaadására. A Responses API ettől eltérő, eseménytípusokra épülő formátumot alkalmaz.

Chat Completions (régi formátum)

# Az eredmény visszaadása "tool" szerepkörű üzenettel
messages.append({
    "role": "tool",
    "tool_call_id": "call_abc123",
    "content": {temp: 22, city: Paris}
})

Responses API (új formátum)

# Az eredmény visszaadása function_call_output objektummal
{
    "type": "function_call_output",
    "call_id": "call_abc123",
    "output": {temp: 22, city: Paris}
}

Fő különbségek:

  • A type: "function_call_output" helyettesíti a role: "tool" mezőt
  • A call_id helyettesíti a tool_call_id mezőt
  • Az output helyettesíti a content mezőt

A Responses API használata az OpenAI SDK-val

Az OpenAI SDK-t használhatod az xAI Responses API-jának hívására:

from openai import OpenAI

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

# Válasz létrehozása eszközökkel
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"]
        }
    }]
)

Vedd észre, hogy a Responses API az input mezőt használja a messages helyett, és az eszközök struktúrája is kissé eltér (nincs beágyazott function objektum).

A válasz kezelése

A Responses API válasza egy output tömböt tartalmaz eseményekkel:

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

        # A függvény végrehajtása
        result = get_weather(city="Paris")

        # A beszélgetés folytatása az eredménnyel
        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
        )

A previous_response_id mező

A Responses API bevezet egy beszélgetés-láncolási mechanizmust a previous_response_id segítségével. A teljes üzenetelőzmények újbóli elküldése helyett egyszerűen hivatkozhatsz az előző válaszra:

# Első kérés
response1 = client.responses.create(
    model="grok-4.5",
    input="Look up the weather in Paris"
)

# Második kérés (láncolt)
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
)

Ez leegyszerűsíti a kontextuskezelést és csökkenti a kérések méretét.

Üzenetek szerveroldali tárolása

A store_messages=True beállítással az xAI a szerverein tárolja az üzeneteket:

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

A previous_response_id-vel kombinálva ez lehetővé teszi hosszú beszélgetések kezelését anélkül, hogy minden kéréssel elküldenéd a teljes előzményt.

Mikor használd a Responses API-t?

Ha egy kifejezetten az xAI-ra épülő új projektet indítasz, a Responses API az alapértelmezett választás, több egymást erősítő okból is. Az innovációk itt jelennek meg először – az új funkciókat először (néha kizárólag) a Responses API-ban adják hozzá. Bizonyos beépített szerveres eszközök csak ezen a csatornán érhetők el. Hosszú beszélgetések esetén a previous_response_id-n keresztüli láncolás szerkezetileg hatékonyabb, mint a teljes előzmények minden körbeni újbóli elküldése: kevesebb tokent kell átvinni, és neked is kevesebb állapotkezelő kódot kell írnod.

A Chat Completions továbbra is két erős felhasználási esetet szolgál ki: a meglévő, OpenAI API-hoz írt kódokat, amelyek az alapértelmezett URL megváltoztatásával változtatás nélkül működnek, valamint a több szolgáltatót használó projekteket, ahol a hordozhatóság elsőbbséget élvez – ezekben a helyzetekben a kompatibilitás fontosabb, mint a kizárólagos funkciók.

Főbb megállapítások

  • A Responses API a function_call_output típust használja a tool szerepkör helyett
  • A mezők megváltoznak: call_id a tool_call_id helyett, output a content helyett
  • A previous_response_id lehetővé teszi a beszélgetések láncolását az előzmények újbóli elküldése nélkül
  • A store_messages=True engedélyezi a szerveroldali tárolást
  • A Responses API az ajánlott végpont az új xAI-projektekhez
  • A Chat Completions továbbra is elérhető az OpenAI visszafelé való kompatibilitás biztosítására