用途:管理 Cargo 账户的计费与额度,包括拉取用量指标、查看订阅状态、查看发票、更新支付方式,并在触发大批量任务前估算信用点消耗。
主要能力:cargo-ai billing usage get-metrics 按时间范围查询用量,支持 --group-by(workflow_uuid、connector_uuid、model_uuid、integration_slug、agent_uuid)与 --unit(仅接受 billing.credits、orchestration.executions、storage.records);cargo-ai billing subscription get 查看套餐与已用/可用额度,剩余额度为 subscriptionAvailableCreditsCount 减 subscriptionCreditsUsedCount;get-invoices 查看发票(金额单位为分);get-credit-card 查看卡;update-payment-method 更新卡;create-portal-session 生成 Stripe 自助计费门户链接。
用法要点:先安装 npm install -g @cargo-ai/cli(无全局安装可前缀 npx @cargo-ai/cli),用 cargo-ai login --email 登录(也支持 --oauth、--token),cargo-ai whoami 确认工作区。命令输出 JSON,失败以非零退出。所有命令需要具管理员权限的令牌,否则返回 forbidden。可用 orchestration play list、orchestration tool list、ai agent list、connection connector list、storage model list 先发现资源 UUID。
估算与计费:每次节点执行计 0.01 信用点,估算公式为 credits =(每记录供应商成本 × 记录数)+(每记录节点数 × 记录数 ÷ 100);该执行费不体现在按节点归因中,但可通过 --unit orchestration.executions 查看。工具节点内部节点也会分别计费。
卡片更新:优先用 --card-stdin 避免明细进入 shell 历史;也可用参数或由命令打印 Stripe 托管表单 URL。卡更新限每小时 10 次。
限制:新账户含 100 免费信用点;具体价格与套餐以账户实际返回为准,资料未提供完整价格表。本技能仅覆盖计费相关命令。