Свързване на разговори
На тази страница
Разговори без управление на историята
Основното предимство на Responses API е възможността за свързване на разговори чрез previous_response_id. Вместо да изпращате цялата история при всяка заявка, просто предавате идентификатора на предишния отговор. Сървърът на xAI се грижи за реконструирането на пълния контекст.
Първа заявка
Изпратете първоначалния си промпт. Извлечете идентификатора на отговора (resp-xxx).
Последващи заявки
Предайте previous_response_id заедно с новото си съобщение. Сървърът реконструира контекста.
Пълен разговор
Свържете толкова съобщения, колкото е необходимо. Всеки отговор сочи към предишния.
Пълен пример на Python
from openai import OpenAI
client = OpenAI(
api_key="xai-...",
base_url="https://api.x.ai/v1"
)
# Рунд 1: Въведение
response1 = client.responses.create(
model="grok-4.20-0309-reasoning",
instructions="You are a patient and clear math teacher.",
input="Hello, I would like to understand derivatives."
)
print(response1.output[0].content[0].text)
# Рунд 2: Моделът помни контекста
response2 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Can you give me a concrete example?",
previous_response_id=response1.id
)
print(response2.output[0].content[0].text)
# Рунд 3: Задълбочаване
response3 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="And how do I calculate the derivative of x² + 3x?",
previous_response_id=response2.id
)
print(response3.output[0].content[0].text)
Забележете, че всяка заявка след първата съдържа само новото съобщение и референцията към предишния отговор. Сървърът на xAI автоматично реконструира цялата история.
Еквивалент в curl
# Рунд 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": "Hello, explain the basics of Python to me."
}'
# Извлечете ID от отговора: "id": "resp-abc123"
# Рунд 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": "How do I write a for loop?",
"previous_response_id": "resp-abc123"
}'
Свързване и инструкции
Инструкциите (instructions или системният промпт), дефинирани в първата заявка, остават валидни през целия свързан разговор. Няма нужда да ги повтаряте.
Ако промените instructions в свързана заявка, новите инструкции заместват предишните за тази и следващите заявки.
Ограничения при свързването
- Реферираният отговор трябва да съществува на сървъра (или чрез
store: true, или да е от скорошна заявка) - Свързването натрупва токени за история – всяка заявка се таксува за целия разговор
- Няма лимит за броя рундове, но важи ограничението на прозореца за контекст на модела
Ключови изводи
previous_response_idсвързва разговори без повторно изпращане на историята- Сървърът автоматично реконструира пълния контекст
- Системните инструкции се запазват от рунд на рунд
- Всеки рунд се таксува за цялата натрупана история
- Реферираният отговор трябва да е бил съхранен на сървъра