Contexto e schemas

Contexto que explica o problema

O contexto é uma projeção autorizada dos dados do aplicativo no começo da conversa. O servidor valida, reduz e redige padrões conhecidos de segredos antes de persistir o snapshot. Isso complementa a seleção de dados feita pelo seu backend.

Três blocos obrigatórios

userState.userId e userState.tenantId precisam corresponder à sessão emitida. Não envie o formato interno de snapshot no lugar do contexto push.

{
  "userState": {
    "userId": "usr_usuario_autenticado",
    "tenantId": "ten_do_projeto",
    "roles": [
      "member"
    ],
    "plan": "standard",
    "featuresEnabled": [],
    "entities": [],
    "activeErrors": [],
    "limitsReached": []
  },
  "userHistory": {
    "windowHours": 24,
    "events": []
  },
  "userLogs": {
    "recentRequests": [],
    "jobs": [],
    "errors": []
  },
  "knowledgePack": {
    "docs": []
  }
}

Campos e limites

O orçamento total de contexto é de até 262.144 bytes UTF-8, sujeito ao limite menor configurado para o tenant. Datas devem ter timezone. Use os limites do JSON Schema para validar o corpo completo.

Atualidade e privacidade

Registre fonte e horário reais. Não transforme sucesso de envio em pagamento confirmado, nem logs de ações em requisições HTTP fictícias. Informe quais fontes estão indisponíveis.

updateContext vale para o próximo caso. Para consultar dados atuais durante a conversa, configure uma ferramenta MCP de leitura.

Não envie tokens, cookies, strings de conexão, URLs assinadas, exportações completas ou dados de outras pessoas. Um campo retentionDays não comprova que o expurgo operacional esteja configurado.