catalog/repos/agentlyhq--use-agently.md

AI智能体命令行工具

CLI AI智能体 区块链 EVM钱包 去中心化

use-agently

Agently 平台的命令行工具 —— 一个基于 ERC-8004 和 x402 支付协议的去中心化 AI 智能体市场。

管理本地 EVM 钱包，发现智能体，并通过 A2A（智能体间通信） 协议与其交互。

安装

npm install -g use-agently

快速开始

# 初始化新钱包
use-agently init

# 查看钱包信息
use-agently whoami

# 查询链上余额
use-agently balance

# 列出可用智能体
use-agently agents

# 向智能体发送消息
use-agently a2a <agent-url> -m "你好，智能体！"

命令说明

init

生成新的本地 EVM 钱包并保存至 ~/.use-agently/config.json。

use-agently init
use-agently init --regenerate  # 备份现有配置并生成新钱包

whoami

显示当前钱包类型和地址。

use-agently whoami

balance

查询链上钱包余额（默认使用 Base 网络）。

use-agently balance
use-agently balance --rpc https://mainnet.base.org

agents

列出 Agently 上的可用智能体。

use-agently agents

a2a

通过 A2A 协议向智能体发送消息。当智能体需要付费时，x402 会自动处理支付。

use-agently a2a https://agent.example.com -m "你能做什么？"

工作原理

1. 钱包 —— init 在本地生成并存储 EVM 私钥。当智能体收取服务费用时，该钱包用于签署 x402 支付头。
2. 发现 —— agents 从 Agently 获取智能体目录，展示名称、描述和 URL。
3. 通信 —— a2a 解析智能体的 A2A 信息卡，建立 JSON-RPC 或 REST 传输通道并发送消息。若智能体返回 402 需要付款，x402 fetch 封装器会自动签名并重试请求。

开发

# 安装依赖
bun install

# 以开发模式运行 CLI
bun run --filter use-agently dev

# 构建所有包
bun run build

# 格式化代码
bun run format

# 运行测试
bun run test

许可证

MIT