Responses API ja function_call_output
Tällä sivulla
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"korvaarole: "tool":ncall_idkorvaatool_call_id:noutputkorvaacontent: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:iatool-roolin sijaan - Kentät muuttuvat:
call_idtool_call_id:n sijaan,outputcontent:n sijaan previous_response_idmahdollistaa keskustelujen ketjutuksen ilman historian uudelleenlähetystästore_messages=Trueottaa käyttöön palvelinpuoleisen tallennuksen- Responses API on suositeltu päätepiste uusille xAI-projekteille
- Chat Completions pysyy saatavilla OpenAI-taaksepäin yhteensopivuutta varten