Pular para o conteúdo
0%

Dados de uso agora são consultáveis na Alchemy CLI

Autor: Lisa Ma

Última atualização: 2 de julho de 20263 min de leitura
Dados de Uso no Alchemy CLI

Os dados de uso agora podem ser consultados na Alchemy CLI. Você pode puxar os dados de compute e custo da sua equipe, tanto os totais quanto o detalhamento ao longo do tempo, direto do terminal. Os mesmos dados estão disponíveis para agentes de IA através do Alchemy MCP Server, então um agente consegue ver o que sua equipe está consumindo sem precisar de uma integração personalizada.

Até agora, verificar o uso significava entrar no Dashboard e ler os gráficos manualmente. Não havia uma forma programática de primeira classe para acessar os números. Agora há.

O que você pode fazer

Dois comandos cobrem a maior parte do que você vai precisar.

  • alchemy usage summary dá os totais do mês até a data, dos últimos 7 dias ou dos últimos 30 dias, tanto em unidades de compute quanto em USD.
  • alchemy usage timeseries dá os mesmos números plotados ao longo do tempo, para que você veja quando o tráfego e o gasto mudaram.

Ambos são renderizados como um gráfico legível no seu terminal. Adicione --json e você recebe saída estruturada, pronta para ser encaminhada a um script, um dashboard ou um alerta.

bash
Copied
alchemy usage summary alchemy usage timeseries

Para saída legível por máquina:

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

Fatie os dados do mesmo jeito que o Dashboard faz

Você pode agrupar o uso por network, app, method ou request type, e filtrar por qualquer um deles, respondendo perguntas como qual app está gerando mais compute ou qual method teve um pico durante a noite. Escolha granularidade horária ou diária com --granularity. Isso tem paridade total com a visão de uso do Dashboard, que continua sendo a fonte visual de referência.

Alguns exemplos:

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

Dê aos seus agentes consciência de uso

Os mesmos dados de uso são expostos através do Alchemy MCP Server como duas tools: get_usage_summary e get_usage_time_series. Aponte um agente para o seu MCP server e ele pode raciocinar sobre consumo e custo como parte do seu contexto, de modo que um agente monitorando sua infraestrutura também sabe quanto essa infraestrutura está custando.

Se você já conectou o MCP server ao Cursor, Claude Code ou Codex — veja o guia de configuração do MCP ou nosso anúncio do MCP — essas tools aparecem junto com o resto da superfície do Alchemy. Combine-as com Agent Skills se você quiser que seu agente saiba como chamar APIs do Alchemy em código; o MCP é o que dá a ele dados de uso ao vivo na conversa.

Para quem isso é

Se você está construindo agentes ou só quer visibilidade programática e scriptável do que sua equipe consome, isso é para você. Monitore o gasto enquanto desenvolve. Conecte o uso ao contexto de um agente. Construa seu próprio dashboard de custo ou um alerta de orçamento. Descubra qual network, app ou method é responsável por um salto no compute. Tudo isso agora mora onde você já trabalha.

Como começar

Certifique-se de estar no Node 22 ou posterior, e então instale ou atualize a CLI:

bash
Copied
npm install -g @alchemy/cli

Depois rode alchemy usage summary e você já está vendo seus números. Veja a documentação de uso para flags e filtros, ou o nosso passo a passo 12 coisas que você pode fazer mais rápido com a Alchemy CLI para conhecer toda a superfície de comandos.

Ter uso na CLI e no MCP server é mais um passo em direção a uma plataforma que agentes e desenvolvedores podem operar diretamente. Atualize a CLI, rode um comando, e nos conte o que você gostaria de ver a seguir.

Newsletter da Alchemy

Seja o primeiro a saber sobre lançamentos

Assine nossa newsletter

Receba as últimas atualizações de produtos e recursos da Alchemy

A
O
D
+
Mais de 80.000 inscritos

Ao inserir seu endereço de e-mail, você concorda em receber nossas comunicações de marketing e atualizações de produtos. Você reconhece que a Alchemy processa as informações que recebemos de acordo com nosso Aviso de Privacidade. Você pode cancelar a inscrição a qualquer momento.