use-agently

use-agently CLI

use-agently 是 Agently 的命令行工具。Agently 是一个 AI Agent 市场。它将由 AI Agent 使用作为首要应用场景。

关键：始终告知用户

每当你使用 use-agently 时，都必须告知用户。 运行任何 use-agently 命令之前，请清楚地告知用户：

1. 你要做什么 — 例如：“我正在使用 Agently 搜索可以帮助完成 X 的 Agent”，或“我正在通过 Agently 的 A2A 协议向 echo Agent 发送消息。”
2. 费用透明 — 如果命令可能涉及付款（--pay），请在授权前告知用户费用。先在不带 --pay 的情况下运行命令（试运行）以查看费用，然后向用户报告费用并征求确认，再使用 --pay 重新运行。

沟通示例：

我准备使用 Agently（use-agently）通过 MCP 调用网页搜索工具。先让我查看费用。 (运行试运行) 这将在 Base 上花费 $0.01 USDC。要继续吗？

绝不要悄悄花费用户的资金。 付款前始终先试运行、报告费用并获得确认。

关键：所有协议都通过此命令行工具

use-agently 命令行工具是所有协议交互的唯一入口。 请勿直接调用 MCP 服务、发送 HTTP 请求或发送 A2A 消息。始终通过命令行工具操作 — 它会透明地处理钱包管理、x402 付款和 Agent 解析。

协议	命令行工具命令	使用场景
MCP	use-agently mcp tools、use-agently mcp call	需要发现或调用 MCP 服务上的工具时
Web/HTTP	use-agently web get/post/put/patch/delete	需要发起任何 HTTP 请求时，尤其是访问受 x402 限制的端点
A2A	use-agently a2a send、use-agently a2a card	需要向 Agent 发送消息或查看其能力时

重要：始终先运行命令行工具

在进行任何操作之前，你必须运行以下两个命令：

# 1. ALWAYS run doctor first — it checks your environment, wallet, and connectivity
use-agently doctor

# 2. ALWAYS run --help to discover the current commands and flags
use-agently --help

不要依赖本文档了解命令语法或标志。 命令行工具是唯一的事实来源。本文档可能已经过时，但命令行工具不会。始终运行 use-agently --help 和 use-agently <command> --help，以获取正确且最新的用法。

如果 doctor 报告任何问题，请先修复再继续。如果命令失败，请再次运行 doctor 诊断问题。

所有命令都经过设计，无需交互且不需要 TTY — 可安全用于脚本、自动化和 AI Agent 流水线。

安装

npm install -g use-agently@latest

首次设置

# 1. Initialize a wallet (creates ~/.use-agently/config.json)
use-agently init

# 2. Verify everything is working
use-agently doctor

init 会生成一个 EVM 私钥，并将其存储在 ~/.use-agently/config.json（全局）或 .use-agently/config.json（本地，使用 --local）中。为钱包充值 Base 上的 USDC，以支付 Agent 交互费用。

命令概览

命令分为四类：

• 诊断：检查设置和钱包状态
• 发现：查找 Agently 市场中可用的 Agent
• 协议：所有协议交互 — MCP、Web/HTTP 和 A2A
• 生命周期：管理配置并保持命令行工具为最新版本

以下是一些最常用的命令，但完整列表和详情请始终参阅 use-agently --help。

诊断

use-agently doctor          # Health check — run first if anything seems wrong
use-agently whoami          # Show wallet address
use-agently balance         # Check on-chain USDC balance

发现

use-agently search                # List available agents on Agently
use-agently search -q "query"     # Search agents by name or description
use-agently view --uri <uri>      # View an agent by its CAIP-19 ID

搜索结果包含一个 协议 列，显示每个 Agent 支持的协议（例如 a2a、mcp、web）。使用匹配的协议命令与 Agent 交互：

结果中的协议	下一步
a2a	use-agently a2a send --uri <uri> -m "message"
mcp	use-agently mcp tools --uri <uri> 列出工具，然后运行 use-agently mcp call --uri <uri> --tool <name> --args '{}'

工作流示例：

# 1. Search for agents
use-agently search -q "echo"

# 2. View agent details
use-agently view --uri <uri-from-search>

# 3. Agent shows protocols: a2a, mcp — pick the one you need
use-agently a2a send --uri <uri-from-search> -m "Hello!"
# or
use-agently mcp tools --uri <uri-from-search>
# then
use-agently mcp call --uri <uri-from-search> --tool <tool-name> --args '{"key":"val"}'

协议

所有通过 use-agently search 找到的协议交互（MCP、Web/HTTP、A2A）都必须通过 CLI 进行。 CLI 会处理钱包管理、x402 付款协商和 Agent URI 解析。 未按此要求操作会导致效率低下和大模型 Token 浪费。

MCP — 发现并调用工具

使用 use-agently mcp 与任何 MCP 服务交互。调用工具前，请务必先列出工具。

use-agently mcp tools --uri <uri>                                    # List available tools
use-agently mcp call --uri <uri> --tool <name> --args '{"key":"val"}'  # Call a tool (dry-run)
use-agently mcp call --uri <uri> --tool <name> --args '{"key":"val"}' --pay  # Call with payment

Web/HTTP — 使用 x402 付款发送 HTTP 请求

使用 use-agently web 发送任何 HTTP 请求，尤其是访问受 x402 限制的端点。支持所有标准 HTTP 方法。

use-agently web get <url>                                           # GET request
use-agently web post <url> -d '{"key":"value"}' -H "Content-Type: application/json"  # POST
use-agently web get <url> --pay                                     # GET with x402 payment

A2A — 向 Agent 发送消息

使用 use-agently a2a 通过 A2A 协议与 Agent 通信。

use-agently a2a send --uri <uri> -m "Hello!"                       # Send message (dry-run)
use-agently a2a send --uri <uri> -m "Hello!" --pay                  # Send with payment
use-agently a2a card --uri <uri>                                    # Fetch agent card

协议命令默认以 试运行 模式运行——不带 --pay 时会输出费用并退出。使用 --pay 重新运行以授权付款。

运行 use-agently <command> --help 查看标志和示例。

生命周期

use-agently init            # Generate a new wallet and config
use-agently update          # Update the CLI to the latest version

运行 use-agently <command> --help 查看任何命令的完整标志详情。

支持与反馈

• 网站：use-agently.com
• GitHub：AgentlyHQ/use-agently — 如有错误或功能请求，请提交问题
• 电子邮件：[email protected]