Pular para conteúdo

As páginas sem tradução abrem em inglês e são identificadas como inglês.

Esta página é uma tradução automática da página em inglês, que prevalece. Machine-translated from the English page, which is authoritative.

Operações de context

Os campos exatos que cada operação context.* recebe e retorna.

Toda op é POST /v1/<op> via HTTP e a ferramenta MCP loom_<op>. Os campos de identidade (org, namespace, agent, user_id, session_id) são preenchidos a partir do token e da sessão MCP quando o transporte consegue fazer isso; em uma chamada HTTP sem token em um servidor de usuário único, é preenchida a org da instalação em todas as ops, exceto code.* e tracker.* (que mantêm a org do seu plano), e, em algumas ops, também o namespace e o agente; veja identidades e namespaces. O índice de operações explica role, kind e a listagem all do MCP. Campos de entrada desconhecidos são atendidos e listados em ignored_args.

context.fetch

Lê de volta um resultado armazenado por chave: uma fatia de caracteres (offset/limit) ou apenas as linhas que correspondem a uma regex (pattern, com context_lines).

POST /v1/context.fetch · MCP loom_context_fetch · papel viewer · leitura · não listada no toolset all do MCP

Campo de entrada Tipo Padrão Significado
org str obrigatório O tenant (primeiro elemento da tupla de identidade).
namespace str obrigatório O namespace que a op lê ou grava.
agent str obrigatório O agente que grava ou lê; '-' ou '*' significa qualquer agente, onde a op permitir.
user_id str '-' O usuário final a quem a linha pertence; '-' para nenhum.
session_id str '-' A sessão ou conversa a que a linha pertence; '-' para nenhuma.
run_id str '-' A execução do agente (escopo da tarefa) à qual a chamada pertence; '-' para nenhuma.
blob_key str obrigatório A chave que context.offload retornou.
offset int 0 Deslocamento de caracteres em que a fatia começa; com pattern, quantas correspondências ignorar.
limit int 4000 No máximo esta quantidade de caracteres de conteúdo por chamada (1-64000).
pattern str '' Regex (sintaxe RE2, sem distinção entre maiúsculas e minúsculas; sem backreferences ou lookaround).
context_lines int 0 Com pattern, linhas de contexto exibidas ao redor de cada correspondência (0-10); as linhas de contexto são numeradas como lineno- e as correspondências como lineno:.
Campo de saída Tipo Significado
found bool False quando nenhum blob ativo e não expirado tem esta chave no namespace.
blob_key str Eco do blob_key de entrada.
content str A fatia de caracteres ou, com pattern, as linhas correspondentes no formato lineno: text.
content_type str Tipo de mídia armazenado com o blob.
summary str O resumo armazenado com o blob.
total_chars int Tamanho de todo o conteúdo armazenado, em caracteres.
total_lines int Número de linhas de todo o conteúdo armazenado.
offset int Eco do offset de entrada.
next_offset int -1 quando a fatia (ou a lista de correspondências) se esgotou.
matched_lines int Com pattern, quantas linhas de todo o conteúdo correspondem; 0 caso contrário.
expires_at datetime \| None Quando o blob deixa de poder ser lido; None quando não encontrado.

context.offload

Estaciona um resultado grande de ferramenta (log, página, diff, saída de consulta) fora do contexto do modelo.

POST /v1/context.offload · MCP loom_context_offload · role writer · idempotente · não listado no toolset all do MCP

Campo de entrada Tipo Padrão Significado
org str obrigatório O tenant (primeiro elemento da tupla de identidade).
namespace str obrigatório O namespace que a op lê ou grava.
agent str obrigatório O agente que grava ou lê; '-' ou '*' significa qualquer agente quando a op permite.
user_id str '-' O usuário final a quem a linha pertence; '-' para nenhum.
session_id str '-' A sessão ou conversa a que a linha pertence; '-' para nenhuma.
run_id str '-' A execução do agente (escopo da tarefa) a que a chamada pertence; '-' para nenhuma.
content str obrigatório O texto a estacionar; acima de LOOM_CONTEXT_OFFLOAD_MAX_BYTES (bytes UTF-8) resulta em 413.
blob_key str '' Vazio = endereçado por conteúdo (blob/<sha256 prefix>): estacionar a mesma saída duas vezes gera a mesma chave e uma única linha armazenada.
content_type str 'text/plain' Tipo de mídia armazenado com o conteúdo e retornado por context.fetch.
summary str '' Resumo de uma linha fornecido pelo chamador (o nome da ferramenta e o que ela retornou).
ttl_seconds int 604800 Por quanto tempo o blob continua disponível para busca, em segundos (de 1 minuto a 90 dias).
Campo de saída Tipo Significado
blob_key str A chave para buscar o conteúdo: a informada ou blob/<sha256 prefix>.
content_bytes int Tamanho do conteúdo armazenado em bytes UTF-8.
content_chars int Tamanho do conteúdo armazenado em caracteres.
sha256 str Digest SHA-256 em hexadecimal do conteúdo.
summary str O resumo armazenado com o blob: o informado ou os primeiros 200 caracteres do conteúdo.
expires_at datetime Quando o blob deixa de estar disponível para busca.
pointer str Pronto para substituir o conteúdo na transcrição.

context.pack

As memórias, decisões e procedimentos de uma tarefa: chame-o primeiro em cada tarefa, a menos que um hook do Loom já tenha colocado o contexto do Loom nesta sessão.

POST /v1/context.pack · MCP loom_context_pack · role viewer · leitura

Campo de entrada Tipo Padrão Significado
org str obrigatório O tenant (primeiro elemento da tupla de identidade).
namespace str obrigatório O namespace que a op lê ou grava.
agent str obrigatório O agente que grava ou lê; '-' ou '*' significa qualquer agente, onde a op permitir.
user_id str '-' O usuário para o qual o pack lê; "-" lê todos os usuários nas seções de memórias, perfil, procedimentos e execuções, e as linhas registradas sem usuário nas seções de stack e de memória de trabalho.
session_id str '-' A sessão para a qual o pack lê; "-" lê todas as sessões na seção de memórias, e as linhas registradas sem sessão nas seções de stack e de memória de trabalho.
run_id str '-' A execução do agente (escopo da tarefa) à qual a chamada pertence; '-' para nenhuma.
query str '' Tarefa/pergunta opcional usada para selecionar memórias e documentos relevantes.
situation str '' Descrição opcional da situação usada para encontrar procedimentos correspondentes.
procedure_explore_rate float \| None None Taxa de exploração da seção de procedimentos; None = 0 (nunca).
token_budget int 2000 Limite de tamanho do pack renderizado inteiro, em tokens (cerca de 4 caracteres cada); um pack maior é cortado e truncated é definido.
top_k int 5 Quantos resultados cada seção baseada em busca pede (procedimentos e a camada de conhecimento do stack limitam isso a 5).
read_scope Literal['namespace', 'own_user', 'own_session'] 'namespace' Mesma semântica de memory.search.read_scope; vincula-se ao user_id / session_id desta op.
mode Literal['startup', 'task', 'debug', 'handoff'] 'task' Orçamentos das seções e receita de busca, sem chamada a LLM em nenhum modo: startup (recuperação rápida; sem query, serve pins e memórias recentes), task e handoff (equilibrado), debug (qualidade).
include_knowledge bool False Adiciona uma seção knowledge com trechos de documentos correspondentes; exige uma query.
include_conversations bool False Adiciona uma seção conversations com mensagens passadas correspondentes; exige uma query.
include_runs bool False O manifesto de execuções: uma linha por sessão recente desta identidade (data, status e objetivo da execução, chamadas de ferramenta por tipo com erros, arquivos tocados, resumo), da mais nova para a mais antiga, runs_limit linhas.
runs_limit int 12 Quantas sessões recentes o manifesto de execuções lista quando include_runs está definido (1-50).
include_chunks bool False Amplia o pool do reranker da busca de memórias com 20 candidatos recentes; sem efeito sem um reranker.
section_token_budgets dict[str, int] (calculado) Orçamentos de tokens por seção que substituem os padrões do modo, indexados pelo nome da seção; uma seção nunca recebe menos de 80 tokens.
block_order list[str] (calculado) Ordenação de blocos opcional, definida pelo chamador.
session_block str '' O marcador de sessão do próprio chamador (session:<project>, a nota do hook Stop do plugin).
only_sections list[Literal['working_memory', 'memory_stack', 'profile', 'memories', 'procedures', 'decisions', 'knowledge', 'conversations', 'runs', 'namespace_health', 'namespace_guide', 'mentor']] (calculado) Restringe o pack a estas seções.
include_decisions bool True Os resultados do tipo decisão saem do bloco de memórias e são renderizados em sua própria seção etiquetada , com o registro estruturado (cenário, resultado, resultado realizado).
Campo de saída Tipo Significado
rendered str O pack como um único texto: cada seção não vazia dentro de uma tag <name>, na ordem dos blocos, cortado em token_budget.
sections dict[str, str] O corpo de cada seção por nome, na ordem dos blocos; seções que não renderizaram nada ficam ausentes.
blocks list[ContextBlock] Uma entrada por seção não vazia: rótulo, corpo, estimativa de tokens, citações, contagem de fontes e priority (sua posição na ordem dos blocos).
section_meta dict[str, dict[str, Any]] Detalhes por seção, por nome: contagem de fontes, citações, se foi cortada, seu tamanho, seu orçamento de tokens e a taxa de preenchimento (acima de 1.0 significa que foi cortada).
section_count int Quantas seções renderizaram algo.
truncated bool True quando qualquer seção, ou o pack inteiro, foi cortado até o seu orçamento.
token_budget int Eco do token_budget de entrada.
mode str Eco do mode de entrada.
tokens_estimate int Pressão sobre o orçamento.
fill_ratio float tokens_estimate / token_budget, com três casas decimais.
stable_sections list[str] A sequência inicial de rendered que não depende de query nem de situation: os mesmos bytes para toda pergunta que esta identidade faz, até que sua memória de trabalho, perfil ou pins mudem.
stable_prefix_chars int Comprimento, em caracteres, desse prefixo de rendered; 0 quando a primeira seção depende da query.
stable_hash str SHA-256 do prefixo estável; vazio quando stable_prefix_chars é 0.
procedure_keys list[str] Procedimentos que o pack colocou diante do agente: o lado "mostrado" do registro de que uma utility precisa.
procedure_keys_withheld list[str] Procedimentos que o pack encontrou e deliberadamente reteve: o lado "não mostrado" do mesmo registro.