Przejdź do głównej treści
Polski— Wybierz język
Menu

Responses API i function_call_output

Lekcja 10 z 14 Zaktualizowano 29 lipca 2026 Programista
Na tej stronie
  1. Responses API: nowy punkt końcowy
  2. Różnice względem Chat Completions
  3. Korzystanie z Responses API przy użyciu OpenAI SDK
  4. Obsługa odpowiedzi
  5. Pole previous_response_id
  6. Przechowywanie wiadomości po stronie serwera
  7. Kiedy używać Responses API?
  8. Kluczowe wnioski

Responses API: nowy punkt końcowy

Responses API to główny nowy punkt końcowy xAI, odrębny od kompatybilnego z OpenAI endpointu Chat Completions. Wprowadza on inny format wywoływania funkcji, wykorzystując typ function_call_output do zwracania wyników działania narzędzi.

Różnice względem Chat Completions

Endpoint Chat Completions (kompatybilny z OpenAI) używa wiadomości z rolą tool do zwracania wyników. Responses API stosuje odmienny format, oparty na typach zdarzeń.

Chat Completions (format legacy)

# Zwróć wynik poprzez wiadomość z rolą "tool"
messages.append({
    "role": "tool",
    "tool_call_id": "call_abc123",
    "content": {temp: 22, city: Paris}
})

Responses API (nowy format)

# Zwróć wynik poprzez obiekt function_call_output
{
    "type": "function_call_output",
    "call_id": "call_abc123",
    "output": {temp: 22, city: Paris}
}

Kluczowe różnice:

  • type: "function_call_output" zastępuje role: "tool"
  • call_id zastępuje tool_call_id
  • output zastępuje content

Korzystanie z Responses API przy użyciu OpenAI SDK

Możesz użyć OpenAI SDK do wywołania Responses API od xAI:

from openai import OpenAI

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

# Utwórz odpowiedź z narzędziami
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"]
        }
    }]
)

Zauważ, że Responses API używa input zamiast messages, a struktura narzędzi jest nieco inna (brak zagnieżdżonego obiektu function).

Obsługa odpowiedzi

Odpowiedź z Responses API zawiera tablicę output ze zdarzeniami:

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

        # Wykonaj funkcję
        result = get_weather(city="Paris")

        # Kontynuuj rozmowę z wynikiem
        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
        )

Pole previous_response_id

Responses API wprowadza mechanizm łańcuchowania rozmów poprzez previous_response_id. Zamiast ponownie wysyłać całą historię wiadomości, po prostu odwołujesz się do poprzedniej odpowiedzi:

# Pierwsze żądanie
response1 = client.responses.create(
    model="grok-4.5",
    input="Look up the weather in Paris"
)

# Drugie żądanie (łańcuchowe)
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
)

Upraszcza to zarządzanie kontekstem i zmniejsza rozmiar żądań.

Przechowywanie wiadomości po stronie serwera

Dzięki store_messages=True, xAI przechowuje wiadomości na swoich serwerach:

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

W połączeniu z previous_response_id pozwala to utrzymywać długie rozmowy bez konieczności ponownego wysyłania pełnej historii przy każdym żądaniu.

Kiedy używać Responses API?

W przypadku nowego projektu budowanego specjalnie pod xAI, Responses API jest wyborem domyślnym z kilku nakładających się powodów. Innowacje pojawiają się tutaj jako pierwsze – nowe funkcje są dodawane do Responses API przed wszelkimi innymi miejscami, czasem wyłącznie. Pewne wbudowane narzędzia serwerowe są dostępne tylko przez ten kanał. Ponadto w przypadku długich rozmów, łańcuchowanie poprzez previous_response_id jest strukturalnie bardziej wydajne niż ponowne wysyłanie pełnej historii przy każdej turze: mniej przesyłanych tokenów i mniej kodu zarządzającego stanem po Twojej stronie.

Chat Completions zachowuje dwa silne przypadki użycia: istniejący kod napisany pod API OpenAI, który działa bez zmian po zmianie adresu bazowego URL, oraz projekty wielodostawcze, gdzie przenośność ma pierwszeństwo – w tych sytuacjach kompatybilność przeważa nad ekskluzywnymi funkcjami.

Kluczowe wnioski

  • Responses API używa function_call_output zamiast roli tool
  • Pola ulegają zmianie: call_id zamiast tool_call_id, output zamiast content
  • previous_response_id pozwala łańcuchować rozmowy bez ponownego wysyłania historii
  • store_messages=True włącza przechowywanie po stronie serwera
  • Responses API to zalecany punkt końcowy dla nowych projektów xAI
  • Chat Completions pozostaje dostępny dla zachowania wstecznej kompatybilności z OpenAI