如何使用 AgentKit：構建 AI 代理的實用端到端指南
更新於 2025年9月23日
7 分鐘
如何使用 AgentKit：構建 AI Agent 的實用端到端指南
如果您聽說過“AgentKit”的熱潮，並想知道如何實際應用它，那麼您來對地方了。需要注意的是：AgentKit 不是單一產品。多個生態系統都使用這個名稱——最著名的是 Coinbase 的 AgentKit 用於鏈上/Web3 操作，Inngest 的 AgentKit 用於協調 Agent 網絡，以及各種使用 OpenAI Agents SDK 和 Coinbase 工具包的教程。本指南將詳細介紹每個 AgentKit 是什麼、為什麼要選擇其中一個而不是另一個，以及如何逐步設置它，並提供您可以重複使用的專業提示和真實模式。
我們將採取實用且以解決方案為導向的方法：快速比較、清晰的設置、可運行的示例以及要避免的陷阱。
您在說哪個“AgentKit”？
- Coinbase AgentKit (CDP/Onchain)： 允許 AI Agent 管理錢包、發送鏈上交易、部署代幣以及在支援的網絡上執行更多操作。非常適合構建 Web3 原生 Agent（例如，打賞機器人、代幣部署器、NFT 分發器）。快速入門指南和研討會廣泛可用。
- Inngest AgentKit： 一個用於定義 Agent、工具並在網絡內部運行的框架，專注於可擴展的、事件驅動的執行。非常適合協調多個 Agent、重試邏輯和後台工作流程。
- Safe/Protocol Kits (context)： 如果您的 Agent 需要智能帳戶控制（多重簽名、策略、批次呼叫），Safe 的 Protocol Kit 通常與鏈上 Agent 搭配使用以實現安全執行。
如果您的目標是快速構建鏈上 AI Agent，請從 Coinbase AgentKit 開始。如果您需要一個穩健的多 Agent 架構和調度，Inngest AgentKit 是一個強大的選擇。許多團隊將兩者結合使用：OpenAI Agents 用於推理 + Coinbase AgentKit 用於鏈上操作 + Inngest 用於協調。
：快速決策指南
- 您需要一個可以轉移資金、部署代幣或與 dApp 交互的 Web3 Agent → 使用 Coinbase AgentKit。
- 您需要一個持久的、事件驅動的系統來協調具有重試和狀態的多個 Agent/工具 → 使用 Inngest AgentKit。
- 您的 Agent 需要企業級別的錢包安全或多重簽名治理 → 將 Safe 的 Protocol Kit 與您的 Agent 集成。
第 1 部分：如何使用 Coinbase AgentKit（鏈上 Agent）
為什麼選擇 Coinbase AgentKit
- 專為開箱即用的鏈上任務而構建（錢包操作、轉帳、代幣管理）
- 簡潔的開發者體驗和快速入門工具
- 非常適合在社交媒體（例如 X）上與用戶交互並在鏈上結算操作的機器人/Agent
設置概述
- 安裝 CLI 和 SDK（按照快速入門），並為網絡、金鑰和 RPC 端點配置環境變數。
- 初始化一個項目並選擇您需要的鏈上功能。
- 將工具（例如，錢包操作、代幣部署）綁定到您的 Agent。
- 將 Agent 連接到推理模型（OpenAI 或類似模型），以決定何時呼叫工具。
按照官方快速入門，在幾分鐘內開始運行。 有關構建管理錢包並在 Twitter/X 上互動的 Web3 AI Agent 的動手教程，請參閱 QuickNode 演練和有關創建 AgentKit Twitter 機器人的影片演示。
示例架構
- 推理層：具有函數/工具呼叫的 LLM
- 操作層：Coinbase AgentKit 工具（轉帳、代幣部署）
- 持久性：將 Agent 記憶/目標儲存在資料庫中
- 前端：聊天 UI 或社交機器人 (X) 用於使用者提示
最佳實踐
- 最小權限原則：將 Agent 金鑰限制在必要的範圍和小餘額內
- 策略提示：定義關於何時允許鏈上操作的明確規則
- 護欄：實施交易預覽/確認、每個時間窗口的限制
- 可觀察性：記錄工具呼叫、交易和模型輸出以進行審計
常見陷阱
- 鬆懈的金鑰管理：切勿硬編碼密碼；使用保管庫
- 無限制的操作：需要確認大額轉帳
- 缺少速率限制：保護 RPC 端點和社交 API
第 2 部分：如何使用 Inngest AgentKit（Agent 網絡和協調）
為什麼選擇 Inngest AgentKit
- Agent 作為具有目標和工具集的一流無狀態工作者
- 用於協調多個 Agent 以實現複雜工作流程的網絡
- 具有重試和持久執行的事件驅動設計
從快速入門開始，啟動您的第一個 Agent 並在網絡內部運行它。 在連接業務邏輯之前，請閱讀核心概念——Agent、工具、網絡。
設置步驟
- 定義您的 Agent 目標和可用工具（API、內部服務、鏈上工具包）。
- 創建一個網絡並註冊 Agent。
- 發出事件以觸發 Agent；使用重試和退避來提高彈性。
- 新增可觀察性：日誌、追蹤、結果。
協調模式
- 主管-工作者：規劃 Agent 將任務委派給專業 Agent
- 事件溯源：狀態更改觸發 Agent 做出反應（例如，payment_received → fulfillment_agent）
- 人為參與：批准高風險操作，帶有暫停/恢復
提示
- 保持 Agent 無狀態；透過事件/狀態儲存傳遞上下文
- 版本工具和提示以追蹤隨時間推移的效能
- 模擬故障模式；驗證外部呼叫的冪等性
第 3 部分：使用 Safe 進行安全執行（可選但建議）
如果您的 Agent 管理資金或執行管理操作，請將智能帳戶與治理集成。 Safe 的 Protocol Kit 提供智能帳戶和多重簽名流程的創建、配置和執行。
- 用例：鏈上 Agent 提交交易，而所有者（人類或主管 Agent）共同簽署
- 優勢：策略控制、支出限制和安全恢復
- 模式：Agent 提議交易；策略引擎（或人類）簽署並執行
逐步指南：構建最小鏈上 Agent
以下是您可以調整的概念流程（與語言無關，偽代碼風格）。 有關工作程式碼和 CLI 命令，請參閱 Coinbase 快速入門。
- 初始化專案並安裝相依性
- 創建一個項目目錄並安裝 AgentKit SDK 和您的 LLM 客戶端
- 設定環境變數：RPC URL、私鑰或託管錢包、網絡
- 定義工具和功能
- 錢包：
get_balance,transfer(to, amount)
- 代幣：
deploy_erc20(name, symbol, supply)
- 根據需要讀取/寫入合約呼叫
- 連接推理模型
- 提供一個定義目標和約束的系統提示
- 使用架構註冊工具以進行安全的功能呼叫
- 添加安全性和策略
- 對高於閾值的轉帳強制執行確認
- 限制每日支出，允許生產環境的接收者地址
- 發布一個基本介面
- CLI：
agent ask "Send 0.01 ETH to 0x..."
- Web/Chat：用於提交任務和顯示收據的最小 UI
- 首先在測試網上測試
- 水龍頭資金；驗證操作日誌和交易雜湊
- 透過可觀察性轉移到生產環境
- 捕獲遙測數據、失敗交易的警報以及模型行為的漂移
在生產環境中運作的模式
- 計劃-然後-行動：在使用工具之前，使用模型概述步驟
- 試運行模式：預覽交易並請求批准
- 預算信封：為每個任務提供支出上限和工具超時
- 綜合監控：排定的任務驗證 Agent 的健康狀況和 RPC 連線
真實示例場景
- 社群打賞機器人：使用者在 X 上提及機器人；Agent 在鏈上打賞經過驗證的錢包
- 客戶獎勵：Agent 追蹤鏈上操作並每週發送獎勵代幣
- DAO 操作：Agent 為提案起草 Safe 交易；多重簽名在審查後簽署
- 市場助理：Agent 列出 NFT 並回覆使用者問題，在確認後執行交易
有關引導式 Web3 Agent 建構，請參閱 QuickNode 教程和 Coinbase 的研討會，其中逐步介紹了 Agents SDK + AgentKit 集成。
故障排除：快速修復
- 我的 Agent 無法發送交易：檢查網絡、gas 設置和金鑰權限；首先嘗試測試網
- 工具呼叫不穩定：收緊工具架構和驗證；添加預先檢查提示
- 運行不穩定：添加帶有退避的重試；監控 RPC 速率限制和狀態代碼
- 安全問題：輪換金鑰、隔離資金、轉移到基於 Safe 的批准
順便說一句：使用 Sider.AI 加速您的工作流程
值得注意的是 - 如果您正在迭代提示、膠水代碼和文檔，輔助工具可以提供幫助。 透過 Sider.AI，您可以將研究、程式碼片段和實驗日誌與您的編輯器一起整理，從而加速 Agent 的構建-測量-學習循環。 在此處探索它：
主要要點
- “AgentKit”通常指的是 Coinbase 的鏈上工具包和 Inngest 的協調工具包——根據您對鏈上操作與多 Agent 協調的需求來選擇。
- 從小處著手：測試網、最小工具、嚴格策略；逐步新增功能。
- 對於財務或管理授權，集成 Safe 以實現治理和安全性。
- 像對待生產軟體一樣對待 Agent：日誌記錄、警報、限制和人工批准。
進一步學習
- Coinbase AgentKit 快速入門和 CLI
- 研討會：具有 Coinbase AgentKit 的 OpenAI Agents SDK
- 構建 Web3 AI Agent 演練 (QuickNode)
- Inngest AgentKit 快速入門和概念
- 用於安全智能帳戶的 Safe Protocol Kit
常見問題
Q1：什麼是 AgentKit，我應該使用哪一個？
AgentKit 通常指的是用於鏈上操作的 Coinbase AgentKit 和用於協調 Agent 的 Inngest AgentKit。 選擇 Coinbase 用於 Web3 任務（錢包、代幣），選擇 Inngest 用於多 Agent、事件驅動的工作流程。
Q2：如何安全地讓 AI Agent 在鏈上轉移資金？
使用小餘額、嚴格的工具架構和高風險操作的確認提示。 對於生產環境，集成 Safe 智能帳戶並要求多重簽名或策略批准。
Q3：我可以將 OpenAI Agents 與 Coinbase AgentKit 結合使用嗎？
可以。 將您的推理層（OpenAI Agents/函數呼叫）連接到 Coinbase AgentKit 工具。 許多開發人員還添加了 Inngest 用於協調和重試。
Q4：使用 AgentKit 時有哪些常見陷阱？
硬編碼金鑰、跳過測試網和允許無限制的操作是最大的問題。 添加速率限制、支出上限和強大的可觀察性以確保安全。
Q5：在哪裡可以找到構建 Web3 AI Agent 的快速入門？
從 Coinbase 的 AgentKit 快速入門開始進行設定和示例，以及來自 QuickNode 的教程和用於端到端指導的研討會影片。
