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

Estado de legado e o princípio stateless

Aula 1 de 12 Atualizada a 3 de novembro de 2026 Programador
Nesta página
  1. O endpoint Chat Completions no ecossistema xAI
  2. Um endpoint stateless: envie tudo em cada pedido
  3. Pontos-chave

Atualizado a 3 de novembro de 2026 com base nas melhores práticas da xAI: a xAI classifica agora as Chat Completions como obsoletas (deprecated) e recomenda a API de Respostas (Responses API) para os modelos de raciocínio Grok. Motivo concreto: as Chat Completions não dispõem de um campo para o raciocínio encriptado do modelo, pelo que cada conversa com várias trocas ou chamada de ferramenta perde o raciocínio das interações anteriores. As novas funcionalidades também chegam primeiro à API de Respostas. Fontes: Melhores práticas da xAI · Chat Completions (legado).

O endpoint Chat Completions no ecossistema xAI

A API da xAI oferece dois endpoints principais para interagir com os modelos Grok: a API de Respostas (endpoint principal) e o endpoint Chat Completions. Este último está assinalado como legado: continua totalmente funcional, mas as novas funcionalidades são agora priorizadas para a API de Respostas.

Por que razão deve importar-se com isto? Porque as Chat Completions continuam a ser o endpoint mais adotado no ecossistema. Todos os SDKs existentes da OpenAI, frameworks como o LangChain ou o LlamaIndex e milhares de tutoriais utilizam este formato. Se estiver a migrar de outro fornecedor ou a trabalhar com ferramentas de terceiros, este será provavelmente o primeiro endpoint que irá utilizar.

Legado
Estado oficial
Stateless
Sem estado no servidor
OpenAI
Formato compatível
3600s
Timeout recomendado

Um endpoint stateless: envie tudo em cada pedido

O princípio fundamental das Chat Completions é que estas são stateless: o servidor não guarda qualquer histórico de conversação. Em cada chamada, deve incluir todo o histórico das mensagens anteriores no seu pedido.

Especificamente, isto significa que, numa conversação com 10 trocas, o seu 11.º pedido deve conter as 10 mensagens anteriores (utilizador + assistente) mais a nova mensagem. A sua aplicação gere este histórico.

{
  "model": "grok-4.20-0309-reasoning",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Hello!"},
    {"role": "assistant", "content": "Hello! How can I help you?"},
    {"role": "user", "content": "Explain deep learning to me."}
  ]
}

Neste exemplo, as primeiras três mensagens representam o histórico da conversação. Apenas a última é a nova mensagem do utilizador. O modelo necessita de todo este contexto para produzir uma resposta coerente.

Implicações práticas

Esta abordagem stateless tem várias implicações:

  • Controlo total: decide exatamente quais as mensagens enviadas ao modelo. Pode filtrar, resumir ou modificar o histórico antes de cada chamada.
  • Custo proporcional: cada pedido é faturado por todos os tokens enviados, incluindo o histórico. Quanto mais longa for a conversação, mais cara será cada troca.
  • Sem persistência no servidor: nenhuns dados são armazenados do lado da xAI entre pedidos. Isto é uma vantagem para a privacidade, mas exige que gere a persistência por sua conta.

Comparação com a API de Respostas

A API de Respostas, por outro lado, é stateful: mantém o histórico no lado do servidor através do parâmetro previous_response_id. Não precisa de reenviar as mensagens anteriores; basta um simples identificador. As respostas podem ser armazenadas até 30 dias com store: true.

A escolha entre os dois depende do seu caso de uso. Se estiver a trabalhar com um SDK existente da OpenAI ou a migrar de outro fornecedor, as Chat Completions são o ponto de partida lógico. Para um novo projeto, recomenda-se a API de Respostas.

Pontos-chave

  • As Chat Completions estão assinaladas como legado, mas permanecem totalmente funcionais e compatíveis com o ecossistema OpenAI
  • O endpoint é stateless: deve reenviar o histórico completo em cada pedido
  • O custo de cada pedido inclui todos os tokens do histórico
  • A API de Respostas oferece uma alternativa stateful com persistência no lado do servidor
  • Para modelos de raciocínio, recomenda-se um timeout de 3600 segundos