Responses API i function_call_output
Na tej stronie
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ępujerole: "tool"call_idzastępujetool_call_idoutputzastępujecontent
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_outputzamiast rolitool - Pola ulegają zmianie:
call_idzamiasttool_call_id,outputzamiastcontent previous_response_idpozwala łańcuchować rozmowy bez ponownego wysyłania historiistore_messages=Truewłą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