use-agently

use-agently CLI

use-agently は、AI エージェントのマーケットプレイスである Agently の CLI です。AI エージェントが主要なユースケースとして操作することを想定して設計されています。

重要：必ずユーザーに伝えてください

use-agently を使用するたびに、必ずユーザーに伝えてください。 use-agently のコマンドを実行する前に、以下を明確に伝えてください。

1. 何をするのか — 例：「X に役立つエージェントを探すために Agently を使います」または「Agently の A2A プロトコル経由で echo エージェントにメッセージを送信します。」
2. 費用の透明性 — コマンドに支払い（--pay）が伴う可能性がある場合は、実行を承認してもらう前に費用を伝えてください。まず --pay なしでコマンドを実行し（ドライラン）、費用を確認してからユーザーに伝え、--pay を付けて再実行する前に確認を求めてください。

コミュニケーションの例：

MCP 経由でウェブ検索ツールを呼び出すために、Agently（use-agently）を使います。まず費用を確認します。 (ドライランを実行) Base で $0.01 USDC の費用がかかります。実行してもよいですか？

ユーザーの資金を黙って使ってはいけません。 必ず最初にドライランを実行し、費用を伝えて、支払いの前に確認を得てください。

重要：すべてのプロトコル操作にはこの CLI を使用してください

use-agently CLI は、すべてのプロトコル操作における単一のゲートウェイです。 MCP サーバーを直接呼び出したり、HTTP リクエストを送信したり、A2A メッセージを直接送信したりしないでください。必ず CLI 経由で操作してください。ウォレット管理、x402 決済、エージェントの解決は CLI が透過的に処理します。

プロトコル	CLI コマンド	使用する場面
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	エージェントにメッセージを送信する、またはその機能を確認する必要がある場合

重要：必ず最初に CLI を実行してください

何をする場合でも、最初に以下の 2 つのコマンドを必ず実行してください。

# 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

コマンドの構文やフラグについて、このドキュメントをあてにしないでください。 CLI が唯一の信頼できる情報源です。このドキュメントは古くなっている可能性がありますが、CLI の情報は常に最新です。正確で最新の使い方を確認するには、必ず use-agently --help と use-agently <command> --help を実行してください。

doctor で問題が報告された場合は、先に修正してから作業を進めてください。コマンドが失敗した場合は、再度 doctor を実行して問題を診断してください。

すべてのコマンドは、設計上、非対話型かつ非 TTY です。スクリプト、自動化、AI エージェントのパイプラインから安全に呼び出せます。

インストール

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 をウォレットに入金してください。

コマンドの概要

コマンドは 4 つのカテゴリに分類されています。

• 診断：セットアップとウォレットの状態を確認します
• 検索：Agently マーケットプレイスで利用可能なエージェントを探します
• プロトコル：MCP、Web/HTTP、A2A など、すべてのプロトコル操作を行います
• ライフサイクル：設定を管理し、CLI を最新の状態に保ちます

以下は最も一般的なコマンドの一部です。すべてのコマンドと詳細については、必ず 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

検索結果には、各エージェントが対応しているプロトコル（例：a2a、mcp、web）を示すprotocols列があります。エージェントとやり取りするには、該当するプロトコルのコマンドを使用します。

検索結果のプロトコル	次の手順
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 の支払い交渉、エージェント URI の解決を処理します。 これに従わないと、効率が低下し、LLM のトークンを無駄に消費します。

MCP — ツールを見つけて呼び出す

あらゆる MCP サーバーとのやり取りには use-agently 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 リクエスト

あらゆる HTTP リクエスト、特に x402 で保護されたエンドポイントには use-agently web を使用します。すべての標準 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 — エージェントにメッセージを送信する

A2A プロトコルを介してエージェントと通信するには、use-agently a2a を使用します。

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 — バグや機能リクエストについては、issue を作成してください
• メール：[email protected]