コンテンツにスキップ

未翻訳のページは英語で開き、英語と表示されます。

このページは英語の原文の機械翻訳です。内容は英語の原文が優先されます。 Machine-translated from the English page, which is authoritative.

ダッシュボードを使わずに Loom を使う

/me ダッシュボードでできることは、すべてターミナル、スクリプト、またはエージェントのシェルから実行できます。loom login で一度サインインしたら、loom call または Python SDK を使います。このページでは、ダッシュボードの各ビューに対応するコマンドと SDK 呼び出しを示します。ここに載っていないビューも、すべて通常のオペレーションとして実行できます(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 として出力されます。サーバーからのエラーは、コードを含む 1 行が 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(...)

ダッシュボードと同じロールが適用されます。参加の承認には、その名前空間の admin 権限が必要です。管理ビューには、組織またはプラットフォームの admin が必要です。