SuperAPI AI 工具集

investigation-cost-guardrail

编程与开发

查看项目

更新于 10-15 17:23

技能介绍

用途:为 AWS DevOps Agent 的调查过程提供成本护栏,覆盖任意 AWS 服务及全部原生 Agent 工具,而非固定清单。技能在 Agent 发起可能收费的 API 调用前估算费用,并执行单次调查预算控制,且始终处于激活状态,无需用户手动调用。

主要能力:采用三层机制。一、启发式分类:按操作命名与行为判断免费(Describe、List、Get、Lookup、Check、Validate、Tag、Untag 等元数据操作)或付费(Query、Scan、Execute、Invoke、读取内容、启动流式会话、名称含 Insights 等),高危免费操作标为 CAUTION,无法判定按 CAUTION 处理。二、已知付费登记表:对 CloudWatch、X-Ray、Athena、DynamoDB、S3、SageMaker、Lambda 等确认收费的操作,用指定的 Pricing API 过滤字段与值取实时费率,并明确 0 结果时 HALT,不得凭记忆或训练数据推测费率。三、响应校验:执行后检查 BytesScanned、RecordsProcessed、ConsumedCapacity、ContentLength、NextToken 等计费字段,发现未分类的付费操作则计入成本并告警。同时包含原生工具成本矩阵(如 get_prometheus_metrics 按样本计费、subagent 按秒计费、fs_read 等免费)。

使用方式:调查开始时默认预算 $10.00,运行成本 $0.00;每次付费操作前估算,超预算即 HALT 并显示预算状态,同时给出缩小时间窗、增加时间步长、增加标签过滤、使用聚合等降本建议。调用次数单项超 200 告警、超 500 拦截,总调用超 1000 拦截。跨区域操作会估算传输成本并标记。PromQL 查询按 min(500, 序列数) ×(时间范围秒数 ÷ 步长秒数)估算样本量,超 $0.50 告警、超 $2.00 拦截;单次查询上限 500 序列,7 天/60 秒步长可达约 500 万样本。付费操作若涉及时间范围而用户未提供时间窗口,将取消并询问,除非操作为有界的单资源查询。

适用场景与限制:适用于 AWS 环境中的事件调查与排障,需在已具备相应 AWS 权限与 Pricing API 访问能力的环境中运行。非 AWS 工具(Splunk、Datadog、Grafana)无实时查价,依赖预设计费模型。write_scratchpad/read_scratchpad 并非所有环境可用,预算累积为行为式,在上下文窗口中维护。部分免费操作可能被工具策略阻止,此时费用为 $0.00。SageMaker InvokeEndpoint 与 Lambda Invoke 默认拦截,需用户明确批准。缺失的费率或查价信息不得编造。