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

Armazenamento e Persistência de Respostas

Aula 6 de 16 Atualizada a 30 de julho de 2026 Programador
Nesta página
  1. Controle o ciclo de vida dos seus dados
  2. store: true vs store: false
  3. Recuperar uma resposta armazenada
  4. Eliminar uma resposta
  5. Casos de uso de armazenamento
  6. Período de retenção
  7. Pontos-chave

Controle o ciclo de vida dos seus dados

A API de Respostas inclui armazenamento integrado: com store: true, os servidores da xAI mantêm as suas respostas durante 30 dias. Pode recuperá-las, visualizá-las e eliminá-las a qualquer momento através de endpoints dedicados.

store: true vs store: false

Modo armazenado (store: true)

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Write a summary of this project.",
  "store": true
}

A resposta persiste durante 30 dias. Pode:

  • Referenciá-la com previous_response_id para continuar a conversa
  • Recuperá-la mais tarde com GET /v1/responses/{id}
  • Eliminá-la com DELETE /v1/responses/{id}

Modo privado (store: false)

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Analyze this confidential data.",
  "store": false
}

A resposta não é mantida após o pedido. Ainda recebe o resultado na resposta HTTP, mas esta torna-se inacessível posteriormente. O encadeamento via previous_response_id não é possível.

Utilize store: false para dados sensíveis ou quando não precisar de continuar a conversa.

Recuperar uma resposta armazenada

curl https://api.x.ai/v1/responses/resp-abc123 \
  -H "Authorization: Bearer $XAI_API_KEY"

A API devolve o objeto de resposta completo, idêntico ao recebido durante a criação. Isto é útil para:

  • Auditar interações passadas
  • Reconstruir um histórico de conversação
  • Verificar custos a posteriori

Em Python

# Recuperar uma resposta armazenada
stored = client.responses.retrieve("resp-abc123")
print(stored.output[0].content[0].text)
print(f"Cost: {stored.usage.cost_in_nano_usd / 1e9:.6f} USD")

Eliminar uma resposta

curl -X DELETE https://api.x.ai/v1/responses/resp-abc123 \
  -H "Authorization: Bearer $XAI_API_KEY"

A eliminação é permanente. Se outras respostas encadeadas referenciarem esta resposta via previous_response_id, o contexto correspondente deixará de estar disponível.

Em Python

client.responses.delete("resp-abc123")

Casos de uso de armazenamento

Chatbot com histórico

Ative store: true para todos os pedidos. O utilizador pode retomar a conversa mesmo após fechar o navegador, desde que mantenha o último response_id.

Análise de dados sensíveis

Utilize store: false para pedidos que contenham dados pessoais ou confidenciais. A resposta é processada na memória e não é persistida.

Auditoria e conformidade

Recupere respostas armazenadas para criar registos de auditoria. Elimine-as quando já não forem necessárias para cumprir as políticas de retenção.

Período de retenção

As respostas armazenadas são eliminadas automaticamente após 30 dias. Não pode estender este período via API. Se necessitar de um histórico mais longo, guarde as respostas na sua própria base de dados.

Pontos-chave

  • store: true persiste a resposta durante 30 dias — store: false não guarda nada
  • GET /v1/responses/{id} recupera uma resposta armazenada
  • DELETE /v1/responses/{id} elimina permanentemente uma resposta
  • O encadeamento via previous_response_id exige que a resposta esteja armazenada
  • As respostas são purgadas automaticamente após 30 dias
  • Utilize store: false para dados sensíveis