콘텐츠로 이동

번역되지 않은 페이지는 영어로 열리며 영어로 표시됩니다.

이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. Machine-translated from the English page, which is authoritative.

대시보드 없이 Loom 사용하기

/me 대시보드에서 하는 모든 작업은 터미널, 스크립트 또는 에이전트의 셸에서도 할 수 있습니다. loom login으로 한 번 로그인한 다음 loom call 또는 Python SDK를 사용하세요. 이 페이지는 각 대시보드 화면을 해당하는 명령과 SDK 호출에 대응시켜 보여 줍니다. 목록에 없는 화면도 모두 일반 operation으로 처리할 수 있습니다(loom call --list).

로그인

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

loom login은 스스로 갱신되는 세션을 저장합니다. 라우터 뒤에 셀이 있는 환경에서 loom login --org <org>는 해당 조직의 셀에 직접 로그인합니다. 이때 라우터의 GET /cells/lookup을 호출하며, 라우터나 셀이 아직 없으면 지정받은 서버를 그대로 사용합니다. 429 응답을 받으면 최대 --wait초(기본값 120) 동안 기다리고, 그 외의 경우에는 로그인을 시작하지 않고 거부합니다. 이후 세션은 해당 셀 호스트의 세션이 되므로, --server 또는 LOOM_BASE_URL이 출력된 호스트를 가리키도록 설정하세요. CI와 서비스에는 코드를 승인해 줄 사람이 없으므로, 봇으로 로그인하거나(아래 참고) LOOM_API_KEY에 범위가 지정된 토큰을 설정해 사용합니다. 토큰과 권한 부여를 참고하세요. SDK만 설치되어 있다면 같은 명령을 python -m loom login과 같은 형태로 실행하세요.

봇과 CI 작업

봇은 loom login이 필요 없습니다. 봇을 한 번 등록한 뒤(loom bot create 또는 플랫폼 관리자의 loom call /v1/admin/bots.create), LOOM_CLIENT_ID와 개인 키(LOOM_CLIENT_KEY_FILE, LOOM_CLIENT_KEY, 또는 LOOM_CLIENT_KEY_SECRET에 지정한 AWS Secrets Manager 시크릿) 중 하나를 사용해 실행합니다. CI 작업에서는 LOOM_WORKLOAD_AUDIENCE를 사용할 수 있습니다. SDK는 토큰을 직접 발급받고 갱신합니다. 토큰 유효 시간은 1시간이며, 봇의 최대 유효 시간이 더 짧으면 그보다 짧아집니다. 싱글 사인온을 참고하세요.

loom call: 전체 API

$ 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

CI와 에이전트용 개인 토큰에는 전용 명령이 있습니다.

$ loom token create --name ci --namespace-role support=writer --namespace docs --ttl-days 0
$ loom token list
$ loom token revoke --name ci
  • 작업 이름은 /v1/<op>로 POST됩니다. org와 namespace는 토큰에서 가져오며, --org와 --namespace로 덮어쓸 수 있습니다.
  • 경로(/로 시작하는 값)는 입력한 그대로 전송됩니다. 본문이 없으면 GET, 본문이 있으면 POST입니다.
  • 필드는 텍스트의 경우 key=value 형식이며 입력한 그대로 전송됩니다. 그 외의 값은 key:=json 형식을 사용합니다(top_k:=5, pinned:=true, tags:='["a","b"]'). --data는 JSON 객체 전체를 받으며, @file 또는 표준 입력을 뜻하는 -도 사용할 수 있습니다.
  • 출력: 응답은 JSON으로 출력됩니다. 서버에서 오류가 발생하면 오류 코드가 포함된 한 줄을 stderr에 출력하고 종료 코드 1로 끝납니다. 명령 자체의 실수(알 수 없는 작업, 잘못된 형식의 필드)는 종료 코드 2로 끝납니다.

각 작업의 필드는 작업 레퍼런스에 나와 있습니다.

Python에서는 agent.call("<op>", {...})로 모든 작업에 접근할 수 있으며, 모든 작업은 agent.client의 메서드로도 제공됩니다. 레지스트리 밖의 경로는 agent.account와 agent.deployment에 있습니다.

대시보드 보기 → 명령과 SDK 호출

대시보드 loom call SDK (agent = loom.Agent(org, namespace, name))
메모리: 검색, 탐색, 편집 memory.search, memory.list, memory.set, memory.update_by_id, memory.delete agent.memory.search(...), .list(...), .set(...)
지식: 업로드, 읽기, 다운로드 knowledge.add, knowledge.list, knowledge.search, /v1/knowledge.download?org=…&namespace=…&source_uri=… agent.knowledge.add(...), .list(), .download(source_uri)
네임스페이스: 생성, 설정 namespace.register, namespace.get, namespace.list_mine, policy.set, blacklist.add agent.namespaces.*, agent.policy.*, agent.blacklist.*
네임스페이스 참여 namespace.browse, namespace.join, namespace.leave agent.client.namespace.join(...)
참여 요청 승인 grants.pending_for_me, 이어서 grants.approve namespace=… subject=… decision=approve (또는 reject) agent.client.grants.pending_for_me(), agent.client.grants.approve(...)
멤버와 권한 grants.list, grants.create, grants.revoke agent.grants.*
검토 대기열 (충돌) conflicts.list, conflicts.resolve, learnings.review agent.conflicts.list(), .resolve(...)
활동, 감사 로그 profile.activity, audit.list, agents.connected, mentor.brief, memory.exposure_summary, memory.owner_report agent.audit.list(...), agent.profile.*
비용과 예산 cost.summary, cost.budget_status agent.cost.summary(...)
실행 run.list, run.get agent.run.*
코드 인덱스 code.index_status, code.repo.add, … agent.code.*
삭제, 잊기 erasure.request, erasure.status, erasure.list, erasure.export, memory.clear agent.erasure.*
작업과 받은 편지함 task.create, task.pull, task.updates, inbox.* agent.tasks.*
트래커 소스 tracker.source.add, tracker.source.list, tracker.item, … agent.tracker.*
그래프 (엔터티와 사실) facts.traverse, facts.* agent.facts.*
대화와 세션 브리프 conversation.*, session.brief_* agent.conversations.*, agent.briefs.*
설정: 토큰 /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)
기본 네임스페이스 /v1/me/set-default-namespace namespace=… agent.account.set_default_namespace(...)
공유 요약 /v1/me/sharing-summary agent.account.sharing_summary()
관리자: 상태 /v1/health, ops.health agent.deployment.health()
관리자: 백그라운드 워커 /v1/admin/workers.status agent.deployment.workers_status()
관리자: 모델과 프로바이더 /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.users, /v1/admin/claim_release agent.client.admin.users(), agent.deployment.release_claim(...)

대시보드와 동일한 역할이 적용됩니다. 참여를 승인하려면 해당 네임스페이스의 관리자 권한이 필요합니다. 관리자 보기에는 조직 관리자 또는 플랫폼 관리자 권한이 필요합니다.