Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Responses API ja function_call_output

Oppitunti 10 / 14 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Responses API: uusi päätepiste
  2. Erot Chat Completionsiin verrattuna
  3. Responses APIn käyttö OpenAI SDK:n kanssa
  4. Vastauksen käsittely
  5. previous_response_id-kenttä
  6. Viestien tallennus palvelinpuolella
  7. Milloin käyttää Responses API:a?
  8. Keskeiset asiat

Responses API: uusi päätepiste

Responses API on xAI:n uusi ensisijainen päätepiste, joka eroaa OpenAI-yhteensopivasta Chat Completions -päätepisteestä. Se ottaa käyttöön erilaisen muodon funktiokutsuille käyttämällä function_call_output-tyyppiä työkalujen tulosten palauttamiseen.

Erot Chat Completionsiin verrattuna

Chat Completions -päätepiste (OpenAI-yhteensopiva) käyttää tool-roolin viestejä tulosten palauttamiseen. Responses API käyttää erilaista, tapahtumatyyppeihin perustuvaa rakennetta.

Chat Completions (vanha muoto)

# Palauta tulos "tool"-roolin viestin kautta
messages.append({
    "role": "tool",
    "tool_call_id": "call_abc123",
    "content": {temp: 22, city: Paris}
})

Responses API (uusi muoto)

# Palauta tulos function_call_output-objektin kautta
{
    "type": "function_call_output",
    "call_id": "call_abc123",
    "output": {temp: 22, city: Paris}
}

Tärkeimmät erot:

  • type: "function_call_output" korvaa role: "tool":n
  • call_id korvaa tool_call_id:n
  • output korvaa content:n

Responses APIn käyttö OpenAI SDK:n kanssa

Voit käyttää OpenAI SDK:ta xAI:n Responses APIn kutsumiseen:

from openai import OpenAI

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

# Luo vastaus työkalujen kanssa
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"]
        }
    }]
)

Huomaa, että Responses API käyttää input:ia messages:in sijaan, ja työkalujen rakenne on hieman erilainen (ei sisäkkäistä function-objektia).

Vastauksen käsittely

Responses API:n vastaus sisältää tapahtumia sisältävän output-taulukon:

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

        # Suorita funktio
        result = get_weather(city="Paris")

        # Jatka keskustelua tuloksen kanssa
        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-kenttä

Responses API ottaa käyttöön keskustelujen ketjutusmekanismin previous_response_id:n kautta. Koko viestihistorian uudelleenlähettämisen sijaan viittaat yksinkertaisesti edelliseen vastaukseen:

# Ensimmäinen pyyntö
response1 = client.responses.create(
    model="grok-4.5",
    input="Look up the weather in Paris"
)

# Toinen pyyntö (ketjutettu)
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ä yksinkertaistaa kontekstin hallintaa ja pienentää pyynnön kokoa.

Viestien tallennus palvelinpuolella

Kun käytät asetusta store_messages=True, xAI tallentaa viestit omille palvelimilleen:

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

Yhdistettynä previous_response_id:hen tämä mahdollistaa pitkien keskustelujen ylläpidon lähettämättä koko historiaa uudelleen jokaisella pyynnöllä.

Milloin käyttää Responses API:a?

Jos rakennat uutta projektia nimenomaan xAI:lle, Responses API on oletusvalinta useista toisiaan vahvistavista syistä. Innovatiot saapuvat tänne ensimmäisenä – uudet ominaisuudet lisätään Responses API:hin ennen muita paikkoja, joskus jopa yksinoikeudella. Tietyt sisäänrakennetut palvelintyökalut ovat saatavilla vain tämän kanavan kautta. Pitkissä keskusteluissa ketjutus previous_response_id:n avulla on rakenteellisesti tehokkaampaa kuin koko historian uudelleenlähetys joka vuorolla: vähemmän siirrettyjä tokeneja ja vähemmän tilanhallintakoodia puolellasi.

Chat Completions säilyttää kaksi vahvaa käyttötapausta: olemassa oleva OpenAI API:lle kirjoitettu koodi, joka toimii sellaisenaan muuttamalla vain base URL:n, sekä monen tarjoajan projektit, joissa siirrettävyys on etusijalla – näissä tilanteissa yhteensopivuus painaa vaakakupissa enemmän kuin yksinoikeusominaisuudet.

Keskeiset asiat

  • Responses API käyttää function_call_output:ia tool-roolin sijaan
  • Kentät muuttuvat: call_id tool_call_id:n sijaan, output content:n sijaan
  • previous_response_id mahdollistaa keskustelujen ketjutuksen ilman historian uudelleenlähetystä
  • store_messages=True ottaa käyttöön palvelinpuoleisen tallennuksen
  • Responses API on suositeltu päätepiste uusille xAI-projekteille
  • Chat Completions pysyy saatavilla OpenAI-taaksepäin yhteensopivuutta varten