Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Responses API og function_call_output

Lektion 10 af 14 Opdateret 29. juli 2026 Udvikler
På denne side
  1. Responses API: Det nye endpoint
  2. Forskelle fra Chat Completions
  3. Brug af Responses API med OpenAI SDK
  4. Håndtering af svaret
  5. Feltet previous_response_id
  6. Lagring af beskeder på serveren
  7. Hvornår skal du bruge Responses API?
  8. Vigtige pointer

Responses API: Det nye endpoint

Responses API er xAI’s nye primære endpoint, som adskiller sig fra det OpenAI-kompatible Chat Completions-endpoint. Det introducerer et andet format til funktionskald ved at bruge typen function_call_output til at returnere værktøjsresultater.

Forskelle fra Chat Completions

Chat Completions-endpointet (OpenAI-kompatibelt) bruger beskeder med rollen tool til at returnere resultater. Responses API bruger et andet format struktureret omkring begivenhedstyper.

Chat Completions (gammelt format)

# Returner resultatet via en besked med rollen "tool"
messages.append({
    "role": "tool",
    "tool_call_id": "call_abc123",
    "content": {temp: 22, city: Paris}
})

Responses API (nyt format)

# Returner resultatet via et function_call_output-objekt
{
    "type": "function_call_output",
    "call_id": "call_abc123",
    "output": {temp: 22, city: Paris}
}

Vigtige forskelle:

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

Brug af Responses API med OpenAI SDK

Du kan bruge OpenAI SDK til at kalde xAI’s Responses API:

from openai import OpenAI

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

# Opret et svar med værktøjer
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"]
        }
    }]
)

Bemærk, at Responses API bruger input i stedet for messages, og at værktøjsstrukturen er lidt anderledes (ingen indlejret function-objekt).

Håndtering af svaret

Svaret fra Responses API indeholder et output-array med begivenheder:

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

        # Udfør funktionen
        result = get_weather(city="Paris")

        # Fortsæt samtalen med resultatet
        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
        )

Feltet previous_response_id

Responses API introducerer en mekanisme til kædning af samtaler via previous_response_id. I stedet for at gensende hele historikken for beskeder, henviser du blot til det foregående svar:

# Første anmodning
response1 = client.responses.create(
    model="grok-4.5",
    input="Look up the weather in Paris"
)

# Anden anmodning (kædet)
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
)

Dette forenkler konteksthåndteringen og reducerer størrelsen på anmodninger.

Lagring af beskeder på serveren

Med store_messages=True gemmer xAI beskeder på deres servere:

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

Kombineret med previous_response_id giver dette dig mulighed for at opretholde lange samtaler uden at skulle gensende hele historikken med hver anmodning.

Hvornår skal du bruge Responses API?

Til et nyt projekt, der er bygget specifikt på xAI, er Responses API det standardvalg af flere sammenfaldende årsager. Innovationer ankommer hertil først – nye funktioner føjes til Responses API før noget andet sted, nogle gange eksklusivt. Visse indbyggede serverværktøjer er kun tilgængelige gennem denne kanal. Og til lange samtaler er kædning via previous_response_id strukturelt mere effektiv end at gensende hele historikken ved hver tur: færre tokens overføres, og mindre kode til tilstandshåndtering på din side.

Chat Completions beholder to stærke anvendelsestilfælde: Eksisterende kode skrevet til OpenAI API, som fungerer som den er ved blot at ændre base-URL’en, og projekter med flere udbydere, hvor portabilitet har førsteprioritet – i disse situationer vejer kompatibilitet tungere end eksklusive funktioner.

Vigtige pointer

  • Responses API bruger function_call_output i stedet for rollen tool
  • Felter ændres: call_id i stedet for tool_call_id, output i stedet for content
  • previous_response_id lader dig kæde samtaler uden at gensende historikken
  • store_messages=True aktiverer lagring på serveren
  • Responses API er det anbefalede endpoint til nye xAI-projekter
  • Chat Completions forbliver tilgængelig for bagudkompatibilitet med OpenAI