Pular para o conteúdo
ClickHouse Loom
Esc
↑↓navegar↵abrir⌘Jpré-visualizar
Nesta página

Operações mentor

Operações mentor

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.

Os campos exatos que cada operação mentor.* 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; em uma chamada HTTP sem token em um servidor de usuário único, vale a org da instalação em toda op exceto code.* e tracker.* (que mantêm a 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.

mentor.brief

O perfil de uso de um agente e as dicas do armazenamento.

POST /v1/mentor.brief · MCP loom_mentor_brief · role viewer · read

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 escreve.
agent str '' O agente que escreve ou lê; '-' ou '*' significa qualquer agente quando a op permite.
window_seconds int 604800 Até onde no passado chega a leitura do ledger, em segundos; de 1 hora a 90 dias.
Campo de saída Tipo Significado
org str O tenant (primeiro elemento da tupla de identidade).
namespace str O namespace que a op lê ou escreve.
agent str O agente que escreve ou lê; '-' ou '*' significa qualquer agente quando a op permite.
window_seconds int A janela sobre a qual o perfil foi calculado, em segundos; um perfil servido do cache mantém a janela com que foi calculado.
computed_at datetime Quando o perfil foi calculado (UTC); anterior à chamada quando servido do cache.
sessions int Sessões distintas nomeadas pelo cliente deste agente na janela (- e * não contam).
usage dict[str, int] Chamadas por operação feitas por este agente na janela.
planes list[MentorPlane] Todos os planos que o mentor conhece, com as chamadas deste agente a cada um e se está disponível.
hints list[MentorHint] As regras que dispararam para este agente, cada uma com as contagens que a dispararam; vazia quando nenhuma.
adoption list[MentorAdoption] Por código de dica, as sessões em que foi exibida e em que foi seguida, das mais exibidas para as menos; vazia quando nenhuma dica chegou ao agente ou a leitura falhou.
usage_evidence list[UsageRung] O uso do Loom pelo agente na janela, um degrau cada, da afirmação mais fraca para a mais forte: de uma chamada feita a uma execução avaliada.
ledger_from datetime | None A linha mais antiga do ledger deste agente na janela, de qualquer tipo; None quando não há nenhuma ou a leitura falhou.
ledger_retention_days int | None Dias que a retenção configurada mantém as linhas do ledger de chamadas deste namespace; 0 mantém até serem apagadas, None quando a leitura falhou.
agents list[str] Os escritores do namespace na janela, dos mais ativos para os menos; o brief usa o primeiro por padrão quando quem chama não tem nome de agente próprio (o painel) — agent_defaulted indica isso.
agent_defaulted bool True quando quem chamou não informou um agente real e o brief escolheu o escritor mais ativo em agents.
skipped list[str] Fatos que o brief não conseguiu ler, no formato “etapa: motivo”.
healthy bool Nenhuma dica de aviso ou crítica.

mentor.guide

O guia do agente que este servidor distribui; o mesmo para todo chamador.

POST /v1/mentor.guide · MCP loom_mentor_guide · role viewer · read · não listada no toolset all do MCP

Campo de entrada Tipo Padrão Significado
org str '' O tenant (primeiro elemento da tupla de identidade).
part Literal['skill', 'reference', 'all'] 'skill' Qual parte: skill (o ciclo e as regras, o padrão), reference (cada plano) ou all.
Campo de saída Tipo Significado
version str A versão do guia (metadata.version de skills/loom/SKILL.md).
part Literal['skill', 'reference', 'all'] A parte retornada, conforme solicitada.
text str O guia em Markdown, sem o frontmatter da skill.

Esta página foi útil?