如何使用 AgentKit：构建 AI Agent 的实用端到端指南
更新于 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 管理钱包、发送链上交易、部署 token 等，支持多个网络。非常适合构建 Web3 原生 agent（例如，打赏机器人、token 部署器、NFT 分发器）。快速入门指南和研讨会随处可见。
- Inngest AgentKit：一个用于定义 agent、工具并在网络内部运行它们的框架，专注于可扩展的、事件驱动的执行。非常适合编排多个 agent、重试逻辑和后台工作流程。
- Safe/Protocol Kits（上下文）：如果您的 agent 需要智能账户控制（多重签名、策略、批量调用），Safe 的 Protocol Kit 通常与链上 agent 结合使用，以实现安全执行。
如果您的目标是快速构建链上 AI agent，请从 Coinbase AgentKit 开始。如果您需要一个强大的多 agent 架构和调度，Inngest AgentKit 是一个不错的选择。许多团队将两者混合使用：OpenAI Agents 用于推理 + Coinbase AgentKit 用于链上操作 + Inngest 用于编排。
：快速决策指南
- 您想要一个可以转移资金、部署 token 或与 dApp 交互的 Web3 agent → 使用 Coinbase AgentKit。
- 您需要一个持久的、事件驱动的系统来编排具有重试和状态的多个 agent/工具 → 使用 Inngest AgentKit。
- 您的 agent 需要企业级钱包安全性或多重签名治理 → 将 Safe 的 Protocol Kit 与您的 agent 集成。
第 1 部分：如何使用 Coinbase AgentKit（链上 Agent）
为什么选择 Coinbase AgentKit
- 开箱即用地构建链上任务（钱包操作、转账、token 管理）
- 简洁的开发者体验和快速入门工具
- 非常适合在社交媒体（例如 X）上与用户交互并在链上执行操作的机器人/agent
设置概述
- 安装 CLI 和 SDK（按照快速入门），并为网络、密钥和 RPC 端点配置环境变量。
- 初始化项目并选择您需要的链上功能。
- 将工具（例如，钱包操作、token 部署）绑定到您的 agent。
- 将 agent 连接到推理模型（OpenAI 或类似模型），以决定何时调用工具。
按照官方快速入门指南在几分钟内开始运行。有关构建管理钱包并在 Twitter/X 上交互的 Web3 AI agent 的实践教程，请参阅 QuickNode 演练以及关于创建 AgentKit Twitter 机器人的视频演示。
示例架构
- 推理层：具有函数/工具调用的 LLM
- 操作层：Coinbase AgentKit 工具（转账、token 部署）
- 持久性：将 agent 内存/目标存储在数据库中
- 前端：聊天 UI 或社交机器人 (X)，用于用户提示
最佳实践
- 最小权限原则：将 agent 密钥限制在必要的范围内和小额余额
- 策略提示：定义关于何时允许链上操作的明确规则
- 护栏：实施交易预览/确认、每个时间窗口的限制
- 可观察性：记录工具调用、交易和模型输出以进行审计
常见陷阱
- 密钥管理不严：切勿硬编码密钥；使用密钥库
- 无限制的操作：需要确认大额转账
- 缺少速率限制：保护 RPC 端点和社交 API
第 2 部分：如何使用 Inngest AgentKit（Agent 网络和编排）
为什么选择 Inngest AgentKit
- Agent 作为具有目标和工具集的一流无状态 worker
- 网络用于协调多个 agent 以实现复杂的工作流程
- 具有重试和持久执行的事件驱动设计
从快速入门开始，启动您的第一个 agent 并在网络内部运行它。在连接业务逻辑之前，请阅读核心概念——agent、工具、网络。
设置步骤
- 定义您的 agent 目标和可用工具（API、内部服务、链上工具包）。
- 创建一个网络并注册 agent。
- 发出事件以触发 agent；使用重试和退避来实现弹性。
- 添加可观察性：日志、跟踪、结果。
编排模式
- 监督者-worker：规划者 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)
- Token：
deploy_erc20(name, symbol, supply)
- 根据需要读取/写入合约调用
- 连接推理模型
- 提供一个定义目标和约束的系统提示
- 使用模式注册工具以实现安全的函数调用
- 添加安全性和策略
- 强制执行高于阈值的转账确认
- 限制每日支出，允许生产环境中的接收者地址
- 发布一个基本界面
- CLI：
agent ask "Send 0.01 ETH to 0x..."
- Web/Chat：用于提交任务和显示收据的最小 UI
- 首先在测试网上进行测试
- Faucet 资金；验证操作日志和交易哈希
- 通过可观察性转向生产
- 捕获遥测数据、失败交易的警报以及模型行为的漂移
在生产中有效的模式
- 计划然后行动：在使用工具之前，使用模型概述步骤
- 试运行模式：预览交易并请求批准
- 预算包络：为每个任务提供支出上限和工具超时
- 综合监控：计划任务验证 agent 的健康状况和 RPC 连接
真实示例场景
- 社区打赏机器人：用户在 X 上提及机器人；agent 在链上打赏验证过的钱包
- 客户奖励：Agent 跟踪链上操作并每周发送奖励 token
- 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 任务（钱包、token），选择 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 的教程和研讨会视频，以获得端到端指导。
