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 agents
Os campos exatos que cada operação agents.* 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 todas as ops, 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.
agents.connected
Os agentes ativos em uma janela: última vez visto, operações e custo por agente.
POST /v1/agents.connected · MCP loom_agents_connected · role viewer · read
| Campo de entrada | Tipo | Padrão | Significado |
|---|---|---|---|
org |
str |
obrigatório | O tenant (primeiro elemento da tupla de identidade). |
namespace |
str \| None |
None |
Vazio → consolidação em toda a org, em todos os namespaces que o chamador pode ver. |
window_hours |
int |
24 |
Até quanto tempo atrás consultar. 24h é o padrão adequado para a verificação "minha reinicialização surtiu efeito"; aumente para inspeção de tendências. |
count_only |
bool |
False |
O selo da barra lateral quer um único número (quantos agentes foram vistos pela primeira vez dentro da janela e fizeram algo), não a linha de cada agente. |
| Campo de saída | Tipo | Significado |
|---|---|---|
rows |
list[ConnectedAgent] |
Uma linha por agente visto na janela, do visto mais recentemente para o mais antigo; vazio com count_only ou quando o chamador não pode ler nenhum namespace da org. |
window_hours |
int |
O período de consulta que as linhas cobrem, em horas (repete o valor da requisição). |
new_count |
int \| None |
Com count_only, o número de agentes vistos pela primeira vez dentro da janela com pelo menos uma op; None caso contrário. |