AgentKitの使い方：AIエージェント構築のための実践的なエンドツーエンドガイド
更新日: 2025年9月23日
7 分
AgentKit の使い方: AI エージェント構築のための実践的エンドツーエンドガイド
「AgentKit」という言葉を耳にして、実際にどのように活用できるのか疑問に思っているなら、まさにぴったりの場所です。注意点として、AgentKit は単一の製品ではありません。この名前は複数のエコシステムで使用されており、最も顕著なのはオンチェーン/Web3 アクションのための Coinbase の AgentKit、エージェントネットワークを調整するための Inngest の AgentKit、そして Coinbase のキットと並行して OpenAI Agents SDK を使用するさまざまなチュートリアルです。このガイドでは、各 AgentKit の内容、どれを選ぶべきか、そしてステップバイステップでのセットアップ方法を、プロのヒントと再利用可能な実際のパターンとともに解説します。
実践的かつソリューション指向のアプローチを取ります。迅速な比較、明確なセットアップ、実行可能な例、そして避けるべき落とし穴を紹介します。
どの「AgentKit」について話しているのですか？
- Coinbase AgentKit (CDP/オンチェーン): AI エージェントがウォレットを管理し、オンチェーンのトランザクションを送信し、トークンをデプロイし、サポートされているネットワーク全体でさらに多くのことを行えるようにします。Web3 ネイティブのエージェント (例: チップボット、トークンデプロイヤー、NFT ディストリビューター) の構築に最適です。クイックスタートガイドとワークショップが広く利用可能です。
- Inngest AgentKit: スケーラブルなイベント駆動型の実行に焦点を当て、エージェント、ツールを定義し、ネットワーク内で実行するためのフレームワークです。複数のエージェント、リトライロジック、およびバックグラウンドワークフローの調整に最適です。
- Safe/Protocol Kits (コンテキスト): エージェントがスマートアカウントの制御 (マルチシグ、ポリシー、バッチ化された呼び出し) を必要とする場合、Safe の Protocol Kit は、安全な実行のためにオンチェーンエージェントと組み合わせて使用されることがよくあります。
オンチェーン AI エージェントを迅速に構築したい場合は、Coinbase AgentKit から始めてください。堅牢なマルチエージェントアーキテクチャとスケジューリングが必要な場合は、Inngest AgentKit が適しています。多くのチームが両方を組み合わせて使用しています。OpenAI Agents を推論に、Coinbase AgentKit をオンチェーンアクションに、Inngest をオーケストレーションに使用します。
：クイック意思決定ガイド
- 資金を移動したり、トークンをデプロイしたり、dapps とやり取りできる Web3 エージェントが必要な場合 → Coinbase AgentKit を使用します。
- 複数のエージェント/ツールをリトライとステートで調整する、耐久性のあるイベント駆動型システムが必要な場合 → Inngest AgentKit を使用します。
- エージェントにエンタープライズグレードのウォレットセキュリティまたはマルチシグガバナンスが必要な場合 → Safe の Protocol Kit をエージェントと統合します。
パート 1: Coinbase AgentKit の使い方 (オンチェーンエージェント)
Coinbase AgentKit を選ぶ理由
- すぐに使えるオンチェーンタスク用に構築 (ウォレット操作、送金、トークン管理)
- クリーンな開発者エクスペリエンスとクイックスタートツール
- ソーシャル (例: X) でユーザーと連携し、アクションをオンチェーンで決済するボット/エージェントに最適
セットアップの概要
- CLI と SDK をインストールし (クイックスタートに従って)、ネットワーク、キー、および RPC エンドポイントの環境変数を構成します。
- プロジェクトを初期化し、必要なオンチェーン機能を選択します。
- ツール (例: ウォレット操作、トークンデプロイメント) をエージェントにバインドします。
- ツールを呼び出すタイミングを決定するために、エージェントを推論モデル (OpenAI など) に接続します。
公式のクイックスタートに従って、数分で実行を開始してください。ウォレットを管理し、Twitter/X でやり取りする Web3 AI エージェントの構築に関する実践的なチュートリアルについては、QuickNode のウォークスルーと、AgentKit Twitter ボットの作成に関するビデオデモを参照してください。
アーキテクチャの例
- 推論レイヤー: 関数/ツール呼び出しを行う LLM
- アクションレイヤー: Coinbase AgentKit ツール (送金、トークンデプロイ)
- 永続性: エージェントのメモリ/目標をデータベースに保存
- フロントエンド: ユーザープロンプト用のチャット UI またはソーシャルボット (X)
ベストプラクティス
- 最小特権の原則: エージェントキーを必要なスコープと少額の残高に制限します
- ポリシースクリプト: オンチェーンアクションが許可されるタイミングに関する明示的なルールを定義します
- ガードレール: トランザクションのプレビュー/確認、時間枠ごとの制限を実装します
- 可観測性: 監査のためにツール呼び出し、トランザクション、およびモデル出力をログに記録します
よくある落とし穴
- ずさんなキー管理: シークレットをハードコードしないでください。Vault を使用してください
- 無制限のアクション: 高額の送金には確認を要求します
- レート制限の欠如: RPC エンドポイントとソーシャル API を保護します
パート 2: Inngest AgentKit の使い方 (エージェントネットワークとオーケストレーション)
Inngest AgentKit を選ぶ理由
- 目標とツールセットを備えた、ファーストクラスのステートレスワーカーとしてのエージェント
- 複雑なワークフローのために複数のエージェントを連携させるネットワーク
- リトライと永続的な実行によるイベント駆動型設計
クイックスタートから始めて、最初のエージェントを立ち上げ、ネットワーク内で実行します。ビジネスロジックを接続する前に、エージェント、ツール、ネットワークというコアコンセプトを読んでください。
セットアップ手順
- エージェントの目標と利用可能なツール (API、内部サービス、オンチェーンキット) を定義します。
- ネットワークを作成し、エージェントを登録します。
- イベントを発行してエージェントをトリガーします。回復力のためにリトライとバックオフを使用します。
- 可観測性を追加します: ログ、トレース、結果。
オーケストレーションパターン
- スーパーバイザーワーカー: プランナーエージェントがタスクをスペシャリストエージェントに委任します
- イベントソーシング: 状態の変化がエージェントをトリガーして反応します (例: payment_received → fulfillment_agent)
- ヒューマンインザループ: リスクの高いアクションに対する承認、一時停止/再開
ヒント
- エージェントをステートレスに保ちます。イベント/ステートストア経由でコンテキストを渡します
- ツールとプロンプトをバージョン管理して、時間の経過に伴うパフォーマンスを追跡します
- 障害モードをシミュレートします。外部呼び出しのべき等性を検証します
パート 3: Safe による安全な実行 (オプションですが推奨)
エージェントが資金を管理したり、管理操作を実行したりする場合は、ガバナンスを備えたスマートアカウントを統合します。Safe の Protocol Kit は、スマートアカウントとマルチシグフローの作成、構成、および実行を提供します。
- ユースケース: オンチェーンエージェントがトランザクションを送信し、所有者 (人間またはスーパーバイザーエージェント) が共同署名します
- 利点: ポリシー制御、支出制限、および安全なリカバリ
- パターン: エージェントがトランザクションを提案します。ポリシーエンジン (または人間) が署名して実行します
ステップバイステップ: 最小限のオンチェーンエージェントの構築
以下は、適応できる概念的なフローです (言語に依存しない、疑似コードスタイル)。動作するコードと CLI コマンドについては、Coinbase のクイックスタートを参照してください。
- プロジェクトを初期化し、依存関係をインストールします
- プロジェクトディレクトリを作成し、AgentKit SDK と LLM クライアントをインストールします
- 環境変数を設定します: RPC URL、秘密キーまたは管理ウォレット、ネットワーク
- ツールと機能を定義します
- ウォレット:
get_balance,transfer(to, amount)
- トークン:
deploy_erc20(name, symbol, supply)
- 必要に応じてコントラクト呼び出しを読み書きします
- 推論モデルを接続します
- 目標と制約を定義するシステムプロンプトを提供します
- 安全な関数呼び出しのために、スキーマを持つツールを登録します
- 安全性とポリシーを追加します
- しきい値を超える送金には確認を強制します
- 1 日の支出を制限し、本番環境の受信者アドレスを許可リストに登録します
- 基本的なインターフェイスを提供します
- CLI:
agent ask "0.01 ETH を 0x... に送信"
- Web/チャット: タスクを送信し、レシートを表示するための最小限の UI
- 最初にテストネットでテストします
- ファセット資金。アクションログとトランザクションハッシュを確認します
- 可観測性とともに本番環境に移行します
- テレメトリをキャプチャし、失敗したトランザクションとモデルの動作のずれに関するアラートを送信します
本番環境で機能するパターン
- 計画してから行動: モデルを使用してツールを呼び出す前に手順の概要を説明します
- ドライランモード: トランザクションをプレビューし、承認を求めます
- 予算エンベロープ: 各タスクに支出上限とツールのタイムアウトを設定します
- 合成モニタリング: スケジュールされたタスクがエージェントのヘルスと RPC 接続を検証します
実際のシナリオの例
- コミュニティチップボット: ユーザーが X でボットについて言及します。エージェントは確認済みのウォレットにオンチェーンでチップを渡します
- 顧客報酬: エージェントはオンチェーンアクションを追跡し、毎週報酬トークンを送信します
- DAO 運用: エージェントは提案のために Safe トランザクションを下書きします。マルチシグはレビュー後に署名します
- マーケットプレイスアシスタント: エージェントは NFT をリストし、ユーザーの質問に答え、確認後に取引を実行します
ガイド付き Web3 エージェントの構築については、QuickNode チュートリアルと、Agents SDK + AgentKit の統合に関する Coinbase のワークショップをご覧ください。
トラブルシューティング: 迅速な修正
- エージェントがトランザクションを送信できません: ネットワーク、ガス設定、およびキーのアクセス許可を確認します。最初にテストネットを試してください
- ツールの呼び出しが不安定です: ツールのスキーマと検証を強化します。事前チェックプロンプトを追加します
- 実行が不安定です: バックオフありでリトライを追加します。RPC レート制限とステータスコードを監視します
- セキュリティ上の懸念: キーをローテーションし、資金を隔離し、Safe ベースの承認に移行します
ちなみに: Sider.AI でワークフローを加速
注目すべきは、プロンプト、グルーコード、ドキュメントを反復処理している場合、相棒が役立つことです。Sider.AI を使用すると、エディターと並行して調査、コードスニペット、実験ログを整理し、エージェントの構築、測定、学習のループを高速化できます。こちらでご確認ください:
重要なポイント
- 「AgentKit」は通常、Coinbase のオンチェーンツールキットと Inngest のオーケストレーションキットを指します。オンチェーンアクションとマルチエージェント連携のどちらが必要かに応じて選択してください。
- 小さく始めてください: テストネット、最小限のツール、厳格なポリシー。機能を徐々に追加します。
- 財務または管理権限については、ガバナンスとセキュリティのために Safe を統合します。
- エージェントを本番環境ソフトウェアのように扱います: ロギング、アラート、制限、および人間の承認。
さらに学習する
- Coinbase AgentKit クイックスタートと CLI
- ワークショップ: Coinbase AgentKit を使用した OpenAI Agents SDK
- Web3 AI エージェントのウォークスルーを構築する (QuickNode)
- Inngest AgentKit クイックスタートとコンセプト
- 安全なスマートアカウントのための Safe Protocol Kit
よくある質問
Q1:AgentKit とは何ですか？また、どれを使用すべきですか？
AgentKit は通常、オンチェーンアクションのための Coinbase AgentKit と、エージェントのオーケストレーションのための Inngest AgentKit を指します。Web3 タスク (ウォレット、トークン) には Coinbase を、マルチエージェントのイベント駆動型ワークフローには Inngest を選択してください。
Q2:AI エージェントがオンチェーンで安全に資金を移動できるようにするにはどうすればよいですか？
少額の残高、厳格なツールスキーマ、およびリスクの高いアクションの確認プロンプトを使用します。本番環境では、Safe スマートアカウントを統合し、マルチシグまたはポリシーの承認を要求します。
Q3:OpenAI Agents を Coinbase AgentKit と組み合わせることはできますか？
はい。推論レイヤー (OpenAI Agents/関数呼び出し) を Coinbase AgentKit ツールに接続します。多くの開発者は、オーケストレーションとリトライのために Inngest も追加します。
Q4:AgentKit を使用する際の一般的な落とし穴は何ですか？
キーのハードコーディング、テストネットのスキップ、および無制限のアクションの許可が大きなものです。安全を保つために、レート制限、支出上限、および堅牢な可観測性を追加します。
Q5:Web3 AI エージェントを構築するためのクイックスタートはどこにありますか？
セットアップと例については、Coinbase の AgentKit クイックスタートから始め、エンドツーエンドのガイダンスについては、QuickNode のチュートリアルとワークショップビデオをご覧ください。
