Łańcuchowe konwersacje
Na tej stronie
Konwersacje bez zarządzania historią
Główną zaletą Responses API jest możliwość łączenia konwersacji w łańcuch za pomocą parametru previous_response_id. Zamiast wysyłać całą historię z każdym żądaniem, przekazujesz jedynie identyfikator poprzedniej odpowiedzi. Serwer xAI zajmuje się odtworzeniem pełnego kontekstu.
Pierwsze żądanie
Wyślij swój początkowy prompt. Pobierz identyfikator odpowiedzi (resp-xxx).
Kolejne żądania
Przekaż previous_response_id wraz z nową wiadomością. Serwer odtworzy kontekst.
Pełna konwersacja
Łącz tyle wiadomości, ile potrzebujesz. Każda odpowiedź wskazuje na poprzednią.
Kompletny przykład w Pythonie
from openai import OpenAI
client = OpenAI(
api_key="xai-...",
base_url="https://api.x.ai/v1"
)
# Tura 1: Wprowadzenie
response1 = client.responses.create(
model="grok-4.20-0309-reasoning",
instructions="Jesteś cierpliwym i jasnym nauczycielem matematyki.",
input="Cześć, chciałbym zrozumieć pochodne."
)
print(response1.output[0].content[0].text)
# Tura 2: Model pamięta kontekst
response2 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Czy możesz podać mi konkretny przykład?",
previous_response_id=response1.id
)
print(response2.output[0].content[0].text)
# Tura 3: Głębsza analiza
response3 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="A jak obliczyć pochodną z x² + 3x?",
previous_response_id=response2.id
)
print(response3.output[0].content[0].text)
Zauważ, że każde żądanie po pierwszym zawiera tylko nową wiadomość i odniesienie do poprzedniej odpowiedzi. Serwer xAI automatycznie odtwarza całą historię.
Odpowiednik w curl
# Tura 1
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.20-0309-reasoning",
"input": "Cześć, wyjaśnij mi podstawy Pythona."
}'
# Pobierz ID z odpowiedzi: "id": "resp-abc123"
# Tura 2
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.20-0309-reasoning",
"input": "Jak napisać pętlę for?",
"previous_response_id": "resp-abc123"
}'
Łańcuchowanie a instrukcje
Parametr instructions (prompt systemowy) zdefiniowany w pierwszym żądaniu obowiązuje przez całą połączoną konwersację. Nie musisz go powtarzać.
Jeśli zmodyfikujesz instructions w żądaniu będącym częścią łańcucha, nowe instrukcje zastąpią poprzednie dla tego żądania i wszystkich kolejnych.
Ograniczenia łańcuchowania
- Odwoływana odpowiedź musi istnieć na serwerze (czyli mieć
store: truelub pochodzić z niedawnego żądania) - Łańcuchowanie kumuluje tokeny historii – za każde żądanie płacisz za całą konwersację
- Nie ma limitu liczby tur, ale obowiązuje okno kontekstowe modelu
Kluczowe wnioski
previous_response_idpozwala łączyć konwersacje bez ponownego wysyłania historii- Serwer automatycznie odtwarza pełny kontekst
- Instrukcje systemowe utrzymują się z tury na turę
- Każda tura jest rozliczana za całą skumulowaną historię
- Odwoływana odpowiedź musiała zostać zapisana na serwerze