Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Responses API a function_call_output

Lekce 10 z 14 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Responses API: nový koncový bod
  2. Rozdíly oproti Chat Completions
  3. Používání Responses API se sadou OpenAI SDK
  4. Zpracování odpovědi
  5. Pole previous_response_id
  6. Ukládání zpráv na straně serveru
  7. Kdy používat Responses API?
  8. Klíčové poznatky

Responses API: nový koncový bod

Responses API je hlavní nový koncový bod společnosti xAI, odlišný od koncového bodu Chat Completions kompatibilního s OpenAI. Zavádí odlišný formát pro volání funkcí, který využívá typ function_call_output k vrácení výsledků nástrojů.

Rozdíly oproti Chat Completions

Koncový bod Chat Completions (kompatibilní s OpenAI) používá zprávy s rolí tool k vrácení výsledků. Responses API využívá jiný formát strukturovaný kolem typů událostí.

Chat Completions (starší formát)

# Vrácení výsledku prostřednictvím zprávy s rolí "tool"
messages.append({
    "role": "tool",
    "tool_call_id": "call_abc123",
    "content": {temp: 22, city: Paris}
})

Responses API (nový formát)

# Vrácení výsledku prostřednictvím objektu function_call_output
{
    "type": "function_call_output",
    "call_id": "call_abc123",
    "output": {temp: 22, city: Paris}
}

Klíčové rozdíly:

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

Používání Responses API se sadou OpenAI SDK

K volání Responses API od xAI můžeš použít sadu OpenAI SDK:

from openai import OpenAI

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

# Vytvoření odpovědi s nástroji
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"]
        }
    }]
)

Všimni si, že Responses API používá input místo messages a struktura nástrojů se mírně liší (chybí vnořený objekt function).

Zpracování odpovědi

Odpověď z Responses API obsahuje pole output s událostmi:

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

        # Provedení funkce
        result = get_weather(city="Paris")

        # Pokračování konverzace s výsledkem
        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
        )

Pole previous_response_id

Responses API zavádí mechanismus řetězení konverzací prostřednictvím previous_response_id. Místo opětovného odesílání celé historie zpráv jednoduše odkážeš na předchozí odpověď:

# První požadavek
response1 = client.responses.create(
    model="grok-4.5",
    input="Look up the weather in Paris"
)

# Druhý požadavek (řetězený)
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
)

Tím se zjednodušuje správa kontextu a snižuje velikost požadavků.

Ukládání zpráv na straně serveru

Pomocí store_messages=True ukládá xAI zprávy na svých serverech:

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

V kombinaci s previous_response_id ti to umožňuje udržovat dlouhé konverzace bez nutnosti odesílat při každém požadavku celou historii.

Kdy používat Responses API?

Pro nový projekt postavený specificky na xAI je Responses API výchozí volbou z několika kumulativních důvodů. Inovace se zde objevují jako první – nové funkce jsou přidávány do Responses API dříve než kamkoli jinam, někdy výhradně. Určité vestavěné serverové nástroje jsou dostupné pouze prostřednictvím tohoto kanálu. A pro dlouhé konverzace je řetězení přes previous_response_id strukturálně efektivnější než opakované odesílání celé historie v každém kole: přenáší se méně tokenů a ty musíš psát méně kódu pro správu stavu.

Chat Completions si zachovává dvě silná použití: existující kód napsaný pro API OpenAI, který funguje tak, jak je, po změně základní URL, a projekty s více poskytovateli, kde má prioritu přenositelnost – v těchto situacích převažuje kompatibilita nad exkluzivními funkcemi.

Klíčové poznatky

  • Responses API používá function_call_output místo role tool
  • Pole se mění: call_id místo tool_call_id, output místo content
  • previous_response_id ti umožňuje řetězit konverzace bez opětovného odesílání historie
  • store_messages=True umožňuje ukládání na straně serveru
  • Responses API je doporučený koncový bod pro nové projekty na xAI
  • Chat Completions zůstává dostupný pro zpětnou kompatibilitu s OpenAI