Conversas em Cadeia
Nesta página
Conversas sem Gestão do Histórico
Uma das principais vantagens da API de Respostas é a capacidade de encadear conversas através do parâmetro previous_response_id. Em vez de reenviar todo o histórico em cada pedido, basta passar o ID da resposta anterior. O servidor da xAI encarrega-se de reconstruir o contexto completo.
Primeiro Pedido
Envie o seu prompt inicial. Recupere o ID da resposta (resp-xxx).
Pedidos Subsequentes
Passe o previous_response_id juntamente com a sua nova mensagem. O servidor reconstrói o contexto.
Conversa Completa
Encadeie quantas mensagens forem necessárias. Cada resposta aponta para a anterior.
Exemplo Completo em Python
from openai import OpenAI
client = OpenAI(
api_key="xai-...",
base_url="https://api.x.ai/v1"
)
# Turno 1: Introdução
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)
# Turno 2: O modelo recorda-se do contexto
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)
# Turno 3: Aprofundamento
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)
Note que cada pedido, após o primeiro, contém apenas a nova mensagem e a referência à resposta anterior. O servidor da xAI reconstrói automaticamente todo o histórico.
Equivalente em curl
# Turno 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."
}'
# Recupere o ID da resposta: "id": "resp-abc123"
# Turno 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"
}'
Encadeamento e Instruções
As instructions (prompt de sistema) definidas no primeiro pedido mantêm-se ativas durante toda a conversa em cadeia. Não precisa de as repetir.
Se modificar as instructions num pedido encadeado, as novas instruções substituem as anteriores para esse pedido e para os subsequentes.
Limites do Encadeamento
- A resposta referenciada deve existir no servidor (seja com
store: trueou proveniente de um pedido recente) - O encadeamento acumula tokens de histórico — cada pedido é faturado com base na conversa completa
- Não existe limite para o número de turnos, mas aplica-se a janela de contexto do modelo
Pontos-chave
- O
previous_response_idpermite encadear conversas sem reenviar o histórico - O servidor reconstrói automaticamente o contexto completo
- As instruções de sistema persistem de turno para turno
- Cada turno é faturado com base em todo o histórico acumulado
- A resposta referenciada tem de ter sido armazenada no servidor