用途:通过 Cargo CLI 的 billing 子命令管理账单与积分,包括拉取用量指标、查看订阅状态、查看发票、管理积分,适合用量报表与成本分析。
前提:先安装并登录。npm install -g @cargo-ai/cli;cargo-ai login --token <your-api-token>;可加 --workspace-uuid <uuid>。用 cargo-ai whoami 验证。未全局安装时,每条命令前加 npx @cargo-ai/cli。所有命令输出 JSON 到 stdout;失败时以非零状态退出并返回 {"errorMessage": "..."}。账单命令需要具备工作区管理员权限的令牌。
主要能力:usage get-metrics 可按时间范围拉取用量,支持 --group-by(workflow_uuid、connector_uuid、model_uuid、integration_slug、agent_uuid)与过滤参数(--workflow-uuid、--model-uuid、--connector-uuid、--integration-slug、--slug、--agent-uuid),可用 --unit credits 指定单位。subscription get 返回当前套餐与积分使用情况,剩余积分等于 subscriptionAvailableCreditsCount 减 subscriptionCreditsUsedCount;get-invoices 返回发票历史(金额以分为单位,除以 100 得美元);get-credit-card 查看已绑定卡;create-portal-session 生成自助账单的 Stripe 门户链接。
使用方式:查询前可先用 orchestration play list、orchestration tool list、ai agent list、connection connector list、storage model list 发现资源 UUID。批量运行前先估算成本:查余额后,单条记录试运行并测其消耗,再按 记录数×每条消耗 估算,并与可用积分比较;批量过程中可重复拉取用量监控。降低成本可考虑换更便宜模型、在图中前置过滤节点、设置 fallbackOnFailure: false、减少 agent 节点的 maxSteps。每条命令均支持 --help。
适用场景:账单分析、用量报表、批量任务前的成本预估。限制:需管理员权限令牌;其余平台细节、收费与价格信息暂未提供。