Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Responses API ja function_call_output

Õppetund 10 / 14 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Responses API: uus lõpp-punkt
  2. Erinevused Chat Completionsist
  3. Responses API kasutamine OpenAI SDK-ga
  4. Vastuse töötlemine
  5. Väli previous_response_id
  6. Sõnumite serveripoolne salvestamine
  7. Millal kasutada Responses API-t?
  8. Peamised punktid

Responses API: uus lõpp-punkt

Responses API on xAI uus peamine lõpp-punkt, mis erineb OpenAI-ga ühilduvast Chat Completionsi lõpp-punktist. See toob kasutusele funktsioonide kutsumiseks erineva vormingu, kasutades tööriista tulemuste tagastamiseks tüüpi function_call_output.

Erinevused Chat Completionsist

Chat Completionsi lõpp-punkt (OpenAI-ga ühilduv) kasutab tulemuste tagastamiseks sõnumeid rolliga tool. Responses API kasutab sündmuste tüüpidele üles ehitatud erinevat vormingut.

Chat Completions (vananenud vorming)

# Tagasta tulemus "tool" rolliga sõnumi kaudu
messages.append({
    "role": "tool",
    "tool_call_id": "call_abc123",
    "content": {temp: 22, city: Paris}
})

Responses API (uus vorming)

# Tagasta tulemus function_call_output objekti kaudu
{
    "type": "function_call_output",
    "call_id": "call_abc123",
    "output": {temp: 22, city: Paris}
}

Peamised erinevused:

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

Responses API kasutamine OpenAI SDK-ga

Saad xAI Responses API kutsumiseks kasutada OpenAI SDK-d:

from openai import OpenAI

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

# Loo vastus koos tööriistadega
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"]
        }
    }]
)

Pane tähele, et Responses API kasutab messages asemel input ja tööriistade struktuur on veidi erinev (pesastatud function objekti pole).

Vastuse töötlemine

Responses API vastus sisaldab sündmustega output massiivi:

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

        # Käivita funktsioon
        result = get_weather(city="Paris")

        # Jätka vestlust tulemusega
        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
        )

Väli previous_response_id

Responses API tutvustab vestluse aheldamise mehhanismi välja previous_response_id kaudu. Kogu sõnumite ajaloo uuesti saatmise asemel viidad lihtsalt eelmisele vastusele:

# Esimene päring
response1 = client.responses.create(
    model="grok-4.5",
    input="Look up the weather in Paris"
)

# Teine päring (aheldatud)
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
)

See lihtsustab konteksti haldamist ja vähendab päringu suurust.

Sõnumite serveripoolne salvestamine

Kasutades store_messages=True, salvestab xAI sõnumid oma serveritesse:

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

Kombineerituna previous_response_id-ga võimaldab see pidada pikki vestlusi, saatmata iga päringuga kaasas kogu ajalugu.

Millal kasutada Responses API-t?

Uue projekti puhul, mis on ehitatud spetsiaalselt xAI peale, on Responses API vaikimisi valik mitmel põhjusel. Uuendused jõuavad esmalt just siia – uusi funktsioone lisatakse Responses API-le enne kui mujale, mõnikord isegi ainult sinna. Teatud sisseehitatud serveritööriistad on kättesaadavad ainult selle kanali kaudu. Pikemate vestluste puhul on aheldamine previous_response_id abil struktuurselt tõhusam kui kogu ajaloo uuesti saatmine igal sammul: edastatakse vähem tokeneid ja sinu poolt on vaja vähem oleku haldamise koodi.

Chat Completionsil on endiselt kaks tugevat kasutusjuhtu: olemasolev kood, mis on kirjutatud OpenAI API jaoks ja töötab muutmata kujul, kui muudad ainult baas-URL-i, ning mitut pakkujat hõlmavad projektid, kus ühilduvus on esmatähtis – sellistes olukordades kaalub ühilduvus üles eksklusiivsed funktsioonid.

Peamised punktid

  • Responses API kasutab tool rolli asemel function_call_output
  • Väljad muutuvad: tool_call_id asemel call_id, content asemel output
  • previous_response_id võimaldab vestlusi aheldada ilma ajaloo uuesti saatmiseta
  • store_messages=True võimaldab serveripoolset salvestamist
  • Responses API on soovitatav lõpp-punkt uutele xAI projektidele
  • Chat Completions jääb kättesaadavaks OpenAI tagasiühilduvuse jaoks