Pular para o conteúdo principal
GET
Ler o contexto por perfil

Autorizações

Authorization
string
header
obrigatório

nia_sk_...

Cabeçalhos

if-none-match
string | null

O ETag que você já tem. Se ele ainda vale, a resposta é 304.

Parâmetros de consulta

profile_id
string<uuid>
obrigatório

O perfil, como as rotas de identidade e de perfis devolvem.

view
string
padrão:chat

View de canal, de sujeito ou de tarefa, como voice, chat ou task:billing.

verification
enum<string>
padrão:V0

O nível provado nesta conversa; o nível efetivo nunca passa do teto da fonte. Nível de verificação da sessão. V0 autodeclarado, V1 plausível pelo canal, V2 atestado pelo canal, V3 desafiado (OTP ou login), V4 conferido com um sistema de registro ou por um atendente. no_customer vale para tarefas sem cliente presente e só é aceito de fontes de agente interno.

Opções disponíveis:
V0,
V1,
V2,
V3,
V4,
no_customer
conversation_id
string | null

Fixa o contexto na conversa: todo turno recebe os mesmos bytes.

task_id
string | null

Para agentes internos, no lugar de conversation_id.

format
enum<string>
padrão:text
Opções disponíveis:
text,
json

Resposta

O contexto.

etag
string
obrigatório
path
enum<string>
obrigatório

Qual camada de leitura respondeu. holdout quer dizer que o perfil está no grupo de controle de um experimento e o contexto vem vazio de propósito.

Opções disponíveis:
t0,
t1,
t2,
t3,
t4,
holdout,
not_modified
verification
VerificationResult · object
obrigatório
version
string
obrigatório

Geração do contexto, como g42. A versão da especificação do contexto como dado é pack.spec; o texto não leva atributo de versão.

about_unlinked
boolean
padrão:false

about citou uma conta ou parceiro sem vínculo ativo com o sujeito: o contexto é o do próprio sujeito, sem o bloco dessa organização. Nunca diz se a organização existe.

as_of
string<date-time> | null

O contexto reflete os eventos até este instante.

budget
BudgetBlock · object | null

Com include: ["budget"]: o que o contexto custa por seção, o que este agente já gastou na conversa e no caso, e o que a medição diz que pode sair; mostrado, nunca imposto.

cache
CacheDirectives · object | null
constraints
ConstraintsBlock · object | null

Com include: ["constraints"]: o que o cliente quer, recusa e é, para as ferramentas deste turno (constraints.v0).

coordination
CoordinationBlock · object | null

Com include: ["coordination"]: quem detém o cliente, as finalidades para as quais ele não pode ser contatado, os contatos que restam a cada finalidade com orçamento e os compromissos que valem. Aviso para o turno: só uma pergunta decide.

coverage
SourceCoverage · object[]
degraded
boolean
padrão:false
delta
string | null

Com delta: o que a memória aprendeu desde a última leitura deste agente, para o fim do prompt. O bloco do turno depois de text é live, depois slots, depois delta.

guards
PackGuard · object[]

O que as linhas de guarda entre os slots afirmam, tipado. Um SDK confere a resposta do agente contra elas e nomeia no turno do agente a guarda que a resposta contrariou (backing.guard_violations).

lag_seconds
number | null
live
LiveTurn · object[]

Falas recentes das outras conversas do cliente que o contexto compilado ainda não cobre, da mais antiga para a mais nova: no máximo as 50 mais novas, tiradas das 100 falas mais novas de cada handle do cliente.

live_complete
boolean
padrão:true

Falso quando a camada quente estava fora do ar, uma fala não pôde ser lida ou um handle tinha mais falas recentes do que as lidas.

manifest_hash
string | null

Hash do manifesto de proveniência por trás deste contexto. O comprovante aponta para ele.

not_modified
boolean
padrão:false
pack
ContextPack · object | null

Com format: "json"; ausente quando text está ausente.

slots
string | null

Com query: o que o último turno do cliente escolheu da memória para este turno, um bloco para o fim do prompt, depois de live e antes de delta. Nunca faz parte de text, que mantém os mesmos bytes durante a conversa inteira.

state
StateView · object | null

Com include: ["state"]: os objetos do cliente nos tipos declarados, cada um como uma leitura display o serve (object-state.v1): valores com o valor lógico, os carimbos, a fonte e o frescor calculado agora, e o que não pode ser afirmado com eles.

text
string | null

O Context Pack, pronto para o prompt.

timing
Timing · object

Milissegundos por etapa.

variables
Variables · object

O mesmo conteúdo em variáveis nomeadas, para templates.

withheld
integer
padrão:0

Itens e turnos de live que a política reteve para quem lê, neste nível de verificação. Verificar libera mais.