Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Conversas em Cadeia

Aula 5 de 16 Atualizada a 30 de julho de 2026 Programador
Nesta página
  1. Conversas sem Gestão do Histórico
  2. Exemplo Completo em Python
  3. Equivalente em curl
  4. Encadeamento e Instruções
  5. Limites do Encadeamento
  6. Pontos-chave

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.

1

Primeiro Pedido

Envie o seu prompt inicial. Recupere o ID da resposta (resp-xxx).

2

Pedidos Subsequentes

Passe o previous_response_id juntamente com a sua nova mensagem. O servidor reconstrói o contexto.

3

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: true ou 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_id permite 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