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.

Use o Loom sem o painel

Tudo o que o painel /me faz pode ser feito a partir de um terminal, de um script ou do shell de um agente. Faça login uma vez com loom login e depois use loom call ou o SDK Python. Esta página associa cada tela do painel ao seu comando e à sua chamada do SDK; toda tela que não está listada também corresponde a operações simples (loom call --list).

Entrar

$ loom login --server https://loom.example.com   # approve on any browser: password or SSO
$ loom whoami
$ loom logout

loom login armazena uma sessão que se renova sozinha. Atrás de um roteador de células, loom login --org <org> faz o login na célula própria da organização: ele consulta o GET /cells/lookup do roteador, mantém o servidor informado quando não há roteador ou ainda não há célula, espera um 429 por no máximo --wait segundos (padrão 120) e, caso contrário, recusa sem iniciar um login. A sessão passa então a ser do host da célula: aponte --server ou LOOM_BASE_URL para o host que ele imprime. CI e serviços não têm ninguém para aprovar o código, então entram como bot (abaixo) ou com um token com escopo em LOOM_API_KEY. Veja tokens e concessões. Com apenas o SDK instalado, execute os mesmos comandos como python -m loom login e assim por diante.

Bots e jobs de CI

Um bot não precisa de loom login: registre-o uma vez (loom bot create, ou, como administrador da plataforma, loom call /v1/admin/bots.create) e depois execute-o com LOOM_CLIENT_ID e com a chave privada (LOOM_CLIENT_KEY_FILE, LOOM_CLIENT_KEY ou um segredo do AWS Secrets Manager em LOOM_CLIENT_KEY_SECRET) ou, em um job de CI, com LOOM_WORKLOAD_AUDIENCE. O SDK obtém e renova o próprio token: ele dura uma hora, ou menos quando o máximo do bot é menor. Veja login único (single sign-on).

loom call: a API inteira

$ loom call --list                          # every operation and the role it needs
$ loom call memory.search query="deploy window" top_k:=5
$ loom call grants.approve namespace=support subject=bob@example.com decision=approve
$ loom call /v1/me/service_accounts         # a route outside the operation registry

Os seus próprios tokens para CI e agentes têm um comando específico:

$ loom token create --name ci --namespace-role support=writer --namespace docs --ttl-days 0
$ loom token list
$ loom token revoke --name ci
  • Um nome de operação é enviado com POST para /v1/<op>. org e namespace vêm do seu token; --org e --namespace os substituem.
  • Um caminho (começa com /) é enviado como foi informado: GET sem corpo, POST com corpo.
  • Os campos são key=value para texto, enviado exatamente como digitado, e key:=json para qualquer outro valor (top_k:=5, pinned:=true, tags:='["a","b"]'). --data aceita um objeto JSON completo, @file ou - para stdin.
  • Saída: a resposta é impressa como JSON. Um erro do servidor imprime uma linha com o seu código em stderr e encerra com o código 1; um erro no próprio comando (uma operação desconhecida, um campo malformado) encerra com o código 2.

Os campos de cada operação estão listados na referência de operações.

Em Python, agent.call("<op>", {...}) alcança qualquer operação, e cada operação também é um método de agent.client. As rotas fora do registro estão em agent.account e agent.deployment.

Visão do painel → comando e chamada do SDK

Painel loom call SDK (agent = loom.Agent(org, namespace, name))
Memórias: buscar, navegar, editar memory.search, memory.list, memory.set, memory.update_by_id, memory.delete agent.memory.search(...), .list(...), .set(...)
Conhecimento: enviar, ler, baixar knowledge.add, knowledge.list, knowledge.search, /v1/knowledge.download?org=…&namespace=…&source_uri=… agent.knowledge.add(...), .list(), .download(source_uri)
Namespaces: criar, configurações namespace.register, namespace.get, namespace.list_mine, policy.set, blacklist.add agent.namespaces.*, agent.policy.*, agent.blacklist.*
Entrar em um namespace namespace.browse, namespace.join, namespace.leave agent.client.namespace.join(...)
Aprovar solicitações de entrada grants.pending_for_me, depois grants.approve namespace=… subject=… decision=approve (ou reject) agent.client.grants.pending_for_me(), agent.client.grants.approve(...)
Membros e concessões grants.list, grants.create, grants.revoke agent.grants.*
Fila de revisão (conflitos) conflicts.list, conflicts.resolve, learnings.review agent.conflicts.list(), .resolve(...)
Atividade, log de auditoria profile.activity, audit.list, agents.connected, mentor.brief, memory.exposure_summary, memory.owner_report agent.audit.list(...), agent.profile.*
Custo e orçamentos cost.summary, cost.budget_status agent.cost.summary(...)
Execuções run.list, run.get agent.run.*
Índice de código code.index_status, code.repo.add, … agent.code.*
Apagamento, esquecimento erasure.request, erasure.status, erasure.list, erasure.export, memory.clear agent.erasure.*
Tarefas e caixa de entrada task.create, task.pull, task.updates, inbox.* agent.tasks.*
Fontes do tracker tracker.source.add, tracker.source.list, tracker.item, … agent.tracker.*
Grafo (entidades e fatos) facts.traverse, facts.* agent.facts.*
Conversas e resumos de sessão conversation.*, session.brief_* agent.conversations.*, agent.briefs.*
Configurações: tokens /v1/me/service_accounts, /v1/me/service_accounts.create, /v1/me/service_accounts.revoke, loom token create agent.account.tokens(), .create_token(...), .revoke_token(name)
Namespace padrão /v1/me/set-default-namespace namespace=… agent.account.set_default_namespace(...)
Resumo de compartilhamento /v1/me/sharing-summary agent.account.sharing_summary()
Admin: integridade /v1/health, ops.health agent.deployment.health()
Admin: workers em segundo plano /v1/admin/workers.status agent.deployment.workers_status()
Admin: modelos e provedores /v1/admin/models, /v1/admin/models/validate, /v1/admin/models (POST), /v1/admin/models/reset, /v1/admin/models/retry agent.deployment.models(), .validate_models(...), .save_models(...), .reset_models(...), .retry_models(...)
Admin: usuários, liberar uma reivindicação admin.users, /v1/admin/claim_release agent.client.admin.users(), agent.deployment.release_claim(...)

Valem os mesmos papéis do painel. Aprovar uma entrada exige permissão de admin nesse namespace. As visões de admin exigem um admin da organização ou da plataforma.