未翻訳のページは英語で開き、英語と表示されます。
このページは英語の原文の機械翻訳です。内容は英語の原文が優先されます。 Machine-translated from the English page, which is authoritative.
cost オペレーション
各 cost.* オペレーションが受け取るフィールドと返すフィールドの一覧です。
すべてのオペレーションは、HTTP では POST /v1/<op>、MCP ツールでは loom_<op> として呼び出せます。ID フィールド(org、namespace、agent、user_id、session_id)は、トランスポートが対応している場合、トークンと MCP セッションから補完されます。シングルユーザーのサーバーでトークンなしに HTTP 呼び出しを行った場合は、code.* と tracker.*(それぞれのプレーンの値を保持します)を除くすべてのオペレーションでインストールの org が使われ、一部のオペレーションでは名前空間とエージェントも補完されます。詳細はID と名前空間を参照してください。ロール、種別、MCP の all 一覧についてはオペレーション一覧で説明しています。未知の入力フィールドも処理され、ignored_args に名前が示されます。
cost.agent_summary
コーディングエージェント自身の支出(loom.agent_turn_usage)を、日付の範囲で集計します。cost.summary の対象外の系列で、そちらは LOOM が上流に支払う費用を価格計算の対象としています。
POST /v1/cost.agent_summary · MCP loom_cost_agent_summary · ロール viewer · 読み取り
| 入力フィールド | 型 | デフォルト | 意味 |
|---|---|---|---|
org |
str |
必須 | テナント(アイデンティティタプルの最初の要素)。 |
namespace |
str \| None |
None |
この op が読み書きする名前空間。 |
from_date |
date |
必須 | 範囲の下限(その日を含む)。各ターンの UTC の日付と比較されます。 |
to_date |
date |
必須 | 範囲の上限(その日を含む) |
group_by |
list[Literal['namespace', 'agent', 'day', 'model', 'consumer', 'session_id']] |
['model'] |
GROUP BY に使うディメンション。 |
agent |
str \| None |
None |
書き込みまたは読み取りを行うエージェント。op が許す場合、'-' または '*' は任意のエージェントを意味します。 |
consumer |
str \| None |
None |
呼び出し元インテグレーションのタグ。台帳の行に記録されます。 |
| 出力フィールド | 型 | 意味 |
|---|---|---|
rows |
list[CostAgentSummaryRow] |
group_by のディメンションの値ごとに 1 行。コストの高い順で、最大 5,000 行。呼び出し元が org 内のどの名前空間も読み取れない場合は空になります。 |
total_turns |
int |
返された行の turns の合計。 |
total_sessions |
int |
重複しないセッション数。session_id でグループ化した場合は行の合計、それ以外では最大の行のカウント(セッションが複数の行にまたがる場合は下限値)。 |
total_cost_usd |
float |
返された行の cost_usd の合計(USD)。価格が未設定のターンは 0 として数えます。 |
unpriced_turns |
int |
価格表にモデルが存在しなかったターンの数。返された行について合計します。 |
cost.budget_status
この名前空間の過去 24 時間のアップストリーム支出と、その上限との比較です。
POST /v1/cost.budget_status · MCP loom_cost_budget_status · ロール viewer · 読み取り
| 入力フィールド | 型 | デフォルト | 意味 |
|---|---|---|---|
org |
str |
必須 | テナント(アイデンティティタプルの最初の要素)。 |
namespace |
str \| None |
None |
この op が読み書きする名前空間。 |
user_id |
str \| None |
None |
名前空間内で指定したエンドユーザーの直近 24 時間のローリング予算。省略すると名前空間の合計を返します。 |
| 出力フィールド | 型 | 意味 |
|---|---|---|
namespace |
str |
この op が読み書きする名前空間。 |
user_id |
str \| None |
選択された論理エンドユーザー。名前空間および org の合計の場合は None。 |
spent_24h_usd |
float \| None |
直近 24 時間のローリングのアップストリーム支出(USD)。ユーザーモードでは、呼び出し元が名前空間ロールの制限を受けないプラットフォーム管理者でない限り null を返します。 |
cap_usd |
float |
有効な名前空間またはユーザー指定の上限。名前空間の上書き設定があればそれを使い、なければサーバーのデフォルトを使います。0.0 は上限なしを意味します。org 全体の集計には常に上限がありません。 |
cap_source |
Literal['namespace', 'global', 'namespace_user', 'global_user', 'uncapped', 'org'] |
名前空間の上限では namespace / global、ユーザーの上限では namespace_user / global_user、無効化されている場合は uncapped、org 全体の集計では org。 |
over_cap |
bool |
実際の支出が選択された上限に達した場合は True。値が非公開でも True になります。org 全体では false。 |
namespace_over_cap |
bool \| None |
ユーザーモードでは、名前空間の支出だけでも新しい処理を妨げることがあります。 |
pct_of_cap |
float \| None |
支出の割合。0..1 に丸められます。上限がない場合、またはユーザーの支出が非公開の場合は null。 |
namespaces_with_spend |
int |
org 全体モードのみ |
cost.record_turns
コーディングエージェント自身の1セッション分の支出を、1回の呼び出しで複数ターンまとめて記録します。
POST /v1/cost.record_turns · MCP loom_cost_record_turns · ロール writer · 冪等 · MCP の all ツールセットには含まれません
| 入力フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
org |
str |
必須 | テナント(ID タプルの最初の要素)。 |
namespace |
str |
必須 | op が読み取りまたは書き込みを行う名前空間。 |
agent |
str |
'-' |
書き込みまたは読み取りを行うエージェント。op が許可する場合、'-' または '*' は任意のエージェントを意味します。 |
user_id |
str |
'-' |
行が属するエンドユーザー。なしの場合は '-'。 |
session_id |
str |
必須 | 行が属するセッションまたは会話。なしの場合は '-'。 |
consumer |
str |
'' |
呼び出し元インテグレーションのタグ。台帳の行に記録されます。 |
turns |
list[TurnUsage] |
必須 | 記録するターン。1回の呼び出しにつき1〜200件。同じ message_id で再送されたターンは、以前の行を置き換えます。 |
| 出力フィールド | 型 | 説明 |
|---|---|---|
recorded |
int |
台帳に書き込まれたターン数。書き込みに失敗した場合は 0(呼び出し自体は成功します)。 |
priced |
int |
モデルが価格表に載っているターン数。書き込みに失敗した場合は 0。 |
unpriced_models |
list[str] |
価格表にないモデル。これらの行は cost_usd=0、priced=false になります。$0 を信用せず、PRICE_PER_1K_TOKENS に追加してください。 |
cost_usd |
float |
このバッチ内で価格が判明したターンの合計金額(USD、小数第6位まで丸め)。 |
turns_dated_ahead |
int |
サーバーの時刻より 5 秒を超えて先の日時が付いたターン数。クライアントの時計が進んでいるため、実行のコストウィンドウでは後の時刻に割り当てられる場合があります。 |
cost.summary
指定した日付範囲のコスト集計です。
POST /v1/cost.summary · MCP loom_cost_summary · ロール viewer · 読み取り · MCP の all ツールセットには含まれません
| 入力フィールド | 型 | デフォルト | 意味 |
|---|---|---|---|
org |
str |
必須 | テナント(ID タプルの最初の要素)。 |
namespace |
str \| None |
None |
op が読み書きする名前空間。 |
from_date |
date |
必須 | 範囲の下限(その日を含む)。各イベントの UTC の日と比較されます。 |
to_date |
date |
必須 | 範囲の上限(その日を含む) |
group_by |
list[Literal['namespace', 'agent', 'day', 'operation', 'memory_key', 'user_id', 'model', 'traffic_class', 'instance_label', 'build_commit']] |
(計算される) | GROUP BY のディメンション。 |
agent |
str \| None |
None |
書き込みまたは読み取りを行うエージェント。op が許可する場合、'-' または '*' は任意のエージェントを意味します。 |
operation |
str \| None |
None |
この op 名のみ(例: 'memory.ask')。None の場合はすべての op を集計します。 |
user_id |
str \| None |
None |
1 人のエンドユーザーのみ(events のスキャンが必要)。None または "-" はすべてのユーザー。 |
traffic_class |
str \| None |
None |
1 つのクラスのみ(production | interactive | bench)。user_id と同様に events のスキャンが必要です。 |
instance_label |
str \| None |
None |
1 つのランチャーのプロセスのみ(deploy:web:blue、iso:w6m1:7864、…)。user_id と同様に events のスキャンが必要です。 |
include_cache |
bool |
True |
完全一致プロンプトのレスポンスキャッシュの合計を台帳から読み取ります(memory.ask 行の out_llm_cache_hits / out_llm_cache_saved_usd)。 |
| 出力フィールド | 型 | 意味 |
|---|---|---|
rows |
list[CostSummaryRow] |
group_by ディメンションの値ごとに 1 行。op 数の多い順で、最大 5,000 行。呼び出し元が組織内のどの名前空間も読み取れない場合は空になります。 |
total_ops |
int |
返された行の ops の合計。 |
total_errors |
int |
返された行の errors(失敗した op)の合計。 |
total_cost_usd |
float |
返された行の上流プロバイダー支出(upstream_cost_usd)の合計(USD)。 |
cache_hits |
int |
期間中の完全一致プロンプトのレスポンスキャッシュ。テーブルから返された LLM 呼び出しと、それによって支出されなかった価格表上の金額。 |
cache_saved_usd |
float |
レスポンスキャッシュのヒットにより支出されなかった USD。小数第 6 位に丸められます。include_cache がオフの場合、またはフィルターが memory.ask を除外する場合は 0。 |