Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Responses API a function_call_output

Lekcia 10 z 14 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Responses API: nový koncový bod
  2. Rozdiely oproti Chat Completions
  3. Používanie Responses API s OpenAI SDK
  4. Spracovanie odpovede
  5. Pole previous_response_id
  6. Ukladanie správ na strane servera
  7. Kedy používať Responses API?
  8. Kľúčové poznatky

Responses API: nový koncový bod

Responses API je hlavný nový koncový bod od xAI, ktorý sa líši od koncového bodu Chat Completions kompatibilného s OpenAI. Zavádza odlišný formát pre volanie funkcií, kde sa na vrátenie výsledkov nástrojov používa typ function_call_output.

Rozdiely oproti Chat Completions

Koncový bod Chat Completions (kompatibilný s OpenAI) používa na vrátenie výsledkov správy s rolou tool. Responses API používa iný formát štruktúrovaný okolo typov udalostí.

Chat Completions (starší formát)

# Vrátite výsledok prostredníctvom správy s rolou "tool"
messages.append({
    "role": "tool",
    "tool_call_id": "call_abc123",
    "content": {temp: 22, city: Paris}
})

Responses API (nový formát)

# Vrátite výsledok prostredníctvom objektu function_call_output
{
    "type": "function_call_output",
    "call_id": "call_abc123",
    "output": {temp: 22, city: Paris}
}

Kľúčové rozdiely:

  • type: "function_call_output" nahrádza role: "tool"
  • call_id nahrádza tool_call_id
  • output nahrádza content

Používanie Responses API s OpenAI SDK

Na volanie Responses API od xAI môžeš použiť OpenAI SDK:

from openai import OpenAI

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

# Vytvorenie odpovede s nástrojmi
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žíva input namiesto messages a štruktúra nástrojov sa mierne líši (chýba vnorený objekt function).

Spracovanie odpovede

Odpoveď z Responses API obsahuje pole output s udalosťami:

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

        # Vykonanie funkcie
        result = get_weather(city="Paris")

        # Pokračovanie v konverzácii s výsledkom
        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ádza mechanizmus reťazenia konverzácií prostredníctvom previous_response_id. Namiesto opätovného odoslania celej histórie správ jednoducho odkážeš na predchádzajúcu odpoveď:

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

# Druhá požiadavka (reťazená)
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
)

Toto zjednodušuje správu kontextu a znižuje veľkosť požiadaviek.

Ukladanie správ na strane servera

Pomocou store_messages=True ukladá xAI správy na svojich serveroch:

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

V kombinácii s previous_response_id ti to umožňuje udržiavať dlhé konverzácie bez potreby odosielať pri každej požiadavke celú históriu.

Kedy používať Responses API?

Pre nový projekt postavený špecificky na xAI je Responses API predvolenou voľbou z niekoľkých dôvodov. Inovácie prichádzajú ako prvé sem – nové funkcie sa pridávajú do Responses API skôr než kamkoľvek inde, niekedy výlučne. Určité vstavané serverové nástroje sú dostupné len cez tento kanál. A pre dlhé konverzácie je reťazenie cez previous_response_id štrukturálne efektívnejšie než opätovné odosielanie celej histórie v každom kole: prenáša sa menej tokenov a ty máš menej kódu na správu stavu.

Chat Completions si zachováva dva silné prípady použitia: existujúci kód napísaný pre API OpenAI, ktorý funguje tak, ako je, po zmene base URL, a projekty s viacerými poskytovateľmi, kde má prioritu prenositeľnosť – v týchto situáciách preváža kompatibilita nad exkluzívnymi funkciami.

Kľúčové poznatky

  • Responses API používa function_call_output namiesto roly tool
  • Polia sa menia: call_id namiesto tool_call_id, output namiesto content
  • previous_response_id ti umožňuje reťaziť konverzácie bez opätovného odoslania histórie
  • store_messages=True povoľuje ukladanie na strane servera
  • Responses API je odporúčaný koncový bod pre nové projekty na xAI
  • Chat Completions zostáva dostupný pre spätnú kompatibilitu s OpenAI