Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Responses API ir function_call_output

Paskaita 10 iš 14 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Responses API: naujas galinis taškas
  2. Skirtumai nuo Chat Completions
  3. Responses API naudojimas su OpenAI SDK
  4. Atsakymo apdorojimas
  5. previous_response_id laukas
  6. Žinučių saugojimas serverio pusėje
  7. Kada naudoti Responses API?
  8. Svarbiausi punktai

Responses API: naujas galinis taškas

Responses API yra pagrindinis naujas xAI galinis taškas, besiskiriantis nuo OpenAI suderinamo „Chat Completions“ galinio taško. Jis pristato kitokį funkcijų kvietimo formatą, naudojant function_call_output tipą įrankių rezultatams grąžinti.

Skirtumai nuo Chat Completions

„Chat Completions“ galinis taškas (suderinamas su OpenAI) naudoja tool vaidmens žinutes rezultatams grąžinti. Responses API naudoja kitokį formatą, sukurtą aplink įvykių tipus.

Chat Completions (senasis formatas)

# Grąžinti rezultatą per „tool“ vaidmens žinutę
messages.append({
    "role": "tool",
    "tool_call_id": "call_abc123",
    "content": {temp: 22, city: Paris}
})

Responses API (naujas formatas)

# Grąžinti rezultatą per function_call_output objektą
{
    "type": "function_call_output",
    "call_id": "call_abc123",
    "output": {temp: 22, city: Paris}
}

Pagrindiniai skirtumai:

  • type: "function_call_output" pakeičia role: "tool"
  • call_id pakeičia tool_call_id
  • output pakeičia content

Responses API naudojimas su OpenAI SDK

Galite naudoti OpenAI SDK norėdami kreiptis į xAI Responses API:

from openai import OpenAI

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

# Sukurti atsakymą su įrankiais
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"]
        }
    }]
)

Atkreipkite dėmesį, kad Responses API naudoja input vietoj messages, o įrankių struktūra šiek tiek skiriasi (nėra įdėto function objekto).

Atsakymo apdorojimas

Responses API atsakyme yra output masyvas su įvykiais:

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

        # Vykdyti funkciją
        result = get_weather(city="Paris")

        # Tęsti pokalbį su rezultatu
        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
        )

previous_response_id laukas

Responses API pristato pokalbių grandinimo mechanizmą per previous_response_id. Užuot siuntę visą žinučių istoriją iš naujo, tiesiog nurodote ankstesnį atsakymą:

# Pirmasis užklausimas
response1 = client.responses.create(
    model="grok-4.5",
    input="Look up the weather in Paris"
)

# Antrasis užklausimas (grandinėje)
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
)

Tai supaprastina konteksto valdymą ir sumažina užklausos dydį.

Žinučių saugojimas serverio pusėje

Nustačius store_messages=True, xAI saugo žinutes savo serveriuose:

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

Derinant su previous_response_id, tai leidžia palaikyti ilgus pokalbius nesiunčiant visos istorijos su kiekviena užklausa.

Kada naudoti Responses API?

Naujam projektui, sukurtam specialiai xAI aplinkoje, Responses API yra numatytasis pasirinkimas dėl kelių sustiprinančių priežasčių. Naujovės čia atsiranda pirmiausia – naujos funkcijos pridedamos prie Responses API anksčiau nei bet kur kitur, kartais išskirtinai. Tam tikri integruoti serverio įrankiai yra prieinami tik per šį kanalą. Be to, ilgiems pokalbiams grandininimas per previous_response_id yra struktūriškai efektyvesnis nei visos istorijos siuntimas kiekviename etape: perduodama mažiau tokenų, o jūsų pusėje reikia mažiau būsenos valdymo kodo.

„Chat Completions“ išlieka tinkamas dviem pagrindiniams atvejams: esamas kodas, parašytas OpenAI API, kuris veikia iš karto pakeitus tik bazinį URL, ir projektai su keliais tiekėjais, kur portuojamumas yra svarbesnis – tokiose situacijose suderinamumas nusveria išskirtines funkcijas.

Svarbiausi punktai

  • Responses API naudoja function_call_output vietoj tool vaidmens
  • Laukai keičiasi: call_id vietoj tool_call_id, output vietoj content
  • previous_response_id leidžia grandinti pokalbius nesiunčiant istorijos iš naujo
  • store_messages=True įgalina saugojimą serverio pusėje
  • Responses API yra rekomenduojamas galinis taškas naujiems xAI projektams
  • „Chat Completions“ išlieka prieinamas atgaliniam OpenAI suderinamumui užtikrinti