跳至内容
0%

Alchemy CLI 现已支持查询使用数据

作者:Lisa Ma

最后更新:2026年7月2日1 分钟阅读
Alchemy CLI 中的使用数据

用量数据现在可以在 Alchemy CLI 中查询了。你可以直接从终端拉取团队的 compute 和成本数据,包括总量以及随时间变化的明细。同样的数据也可以通过 Alchemy MCP Server 提供给 AI agent,这样 agent 无需自定义集成就能查看团队的消耗情况。

在此之前,查看用量意味着登录 Dashboard 并手动读取图表。此前没有一种可编程的一等方式来获取这些数字。现在有了。

你可以做什么

有两个命令基本能满足大部分需求。

  • alchemy usage summary 给出本月至今、最近 7 天或最近 30 天的总量,单位为 compute unit 和美元。
  • alchemy usage timeseries 给出同样的数字随时间变化的曲线,让你看到流量和支出在什么时候发生了变化。

两者都会在终端中渲染成可读的图表。加上 --json,你会得到结构化输出,可以直接输入脚本、仪表盘或告警系统。

bash
Copied
alchemy usage summary alchemy usage timeseries

如需机器可读的输出:

bash
Copied
alchemy usage summary --json alchemy usage timeseries --json

按 Dashboard 的方式切分数据

你可以按 network、app、method 或 request type 对用量进行分组,并对其中任意一项进行过滤,从而回答诸如哪个 app 占用了更多 compute、或哪个 method 在夜间突然飙升之类的问题。用 --granularity 选择按小时或按天的粒度。这与 Dashboard 的用量视图功能完全对等,Dashboard 仍是可视化的权威来源。

一些示例:

bash
Copied
alchemy usage summary --metrics amount,usd alchemy usage timeseries --group-by network --granularity day alchemy usage summary --app-ids <id> --methods eth_getLogs

让你的 agent 具备用量感知

同样的用量数据通过 Alchemy MCP Server 以两个工具的形式暴露:get_usage_summary 和 get_usage_time_series。将 agent 指向你的 MCP server,它就能把消耗和成本作为上下文的一部分进行推理,让监控你基础设施的 agent 同时了解这套基础设施花费了多少。

如果你已经把 MCP server 连接到了 Cursor、Claude Code 或 Codex——参见 MCP 配置指南或我们的 MCP 发布公告——这些工具会和 Alchemy 的其他功能一起出现。如果你希望 agent 知道如何在代码中调用 Alchemy API,可以搭配 Agent Skills 使用;而 MCP 提供的是对话中的实时用量数据。

适合谁使用

如果你正在构建 agent,或者只是想要对团队的消耗有可编程、可脚本化的可见性,这就是为你准备的。在开发过程中监控支出。把用量接入 agent 的上下文。构建你自己的成本仪表盘或预算告警。追查是哪个 network、app 或 method 导致了 compute 的激增。现在这一切都可以在你已经使用的工具中完成。

开始使用

确保你使用的是 Node 22 或更高版本,然后安装或更新 CLI:

bash
Copied
npm install -g @alchemy/cli

然后运行 alchemy usage summary,就能看到你的数据了。关于各种标志和过滤条件,参见 用量文档;如果想了解完整的命令集,可以看看我们的 用 Alchemy CLI 更快完成的 12 件事 一文。

CLI 和 MCP server 中的用量功能,是迈向一个 agent 与开发者都能直接操作的平台的又一步。更新 CLI,运行一个命令,然后告诉我们你还想看到什么。

Alchemy 新闻通讯

第一时间获取发布信息

订阅我们的新闻通讯

获取 Alchemy 的最新产品更新和资源

A
O
D
+
超过 80,000 名订阅者

填写您的电子邮箱地址即表示您同意接收我们的营销通讯和产品更新。您确认 Alchemy 按照我们的隐私声明处理我们收到的信息。您可以随时取消订阅。