What is AgentKit, and which one should I use?

AgentKit commonly refers to Coinbase AgentKit for onchain actions and Inngest AgentKit for orchestrating agents. Choose Coinbase for Web3 tasks (wallets, tokens) and Inngest for multi-agent, event-driven workflows.

How do I safely let an AI agent move funds onchain?

Use small balances, strict tool schemas, and confirmation prompts for risky actions. For production, integrate Safe smart accounts and require multisig or policy approvals.

Can I combine OpenAI Agents with Coinbase AgentKit?

Yes. Connect your reasoning layer (OpenAI Agents/function calling) to Coinbase AgentKit tools. Many devs also add Inngest for orchestration and retries.

What are common pitfalls when using AgentKit?

Hardcoding keys, skipping testnets, and allowing unbounded actions are the big ones. Add rate limits, spend caps, and robust observability to stay safe.

Where can I find a quickstart to build a Web3 AI agent?

Start with Coinbase’s AgentKit quickstart for setup and examples, plus tutorials from QuickNode and workshop videos for end-to-end guidance.

Cách sử dụng AgentKit: Hướng dẫn toàn diện và thiết thực để xây dựng AI Agent

Nếu bạn đã nghe nói về “AgentKit” và tự hỏi làm thế nào để thực sự đưa nó vào hoạt động, bạn đã đến đúng nơi. Vấn đề là: AgentKit không phải là một sản phẩm duy nhất. Tên này được sử dụng bởi nhiều hệ sinh thái—đáng chú ý nhất là AgentKit của Coinbase cho các hành động onchain/Web3, AgentKit của Inngest để điều phối các mạng lưới agent và nhiều hướng dẫn khác nhau sử dụng OpenAI Agents SDK cùng với bộ công cụ của Coinbase. Hướng dẫn này sẽ giải thích từng loại AgentKit là gì, tại sao bạn nên chọn loại này thay vì loại khác và cách thiết lập từng bước, với các mẹo chuyên nghiệp và các mẫu thực tế mà bạn có thể tái sử dụng.

Chúng ta sẽ thực hiện một cách tiếp cận thực tế và hướng đến giải pháp: so sánh nhanh chóng, thiết lập rõ ràng, các ví dụ có thể chạy được và những cạm bẫy cần tránh.

Bạn đang nói về loại “AgentKit” nào?

Coinbase AgentKit (CDP/Onchain): Cho phép các AI agent quản lý ví, gửi giao dịch onchain, triển khai token và nhiều hơn nữa trên các mạng được hỗ trợ. Lý tưởng để xây dựng các agent gốc Web3 (ví dụ: bot tiền thưởng, trình triển khai token, nhà phân phối NFT). Các hướng dẫn khởi động nhanh và hội thảo có sẵn rộng rãi.

Inngest AgentKit: Một framework để xác định các agent, công cụ và chạy chúng bên trong một mạng lưới, tập trung vào khả năng mở rộng, thực thi dựa trên sự kiện. Tuyệt vời để điều phối nhiều agent, logic thử lại và quy trình làm việc nền.

Safe/Protocol Kits (bối cảnh): Nếu agent của bạn cần kiểm soát tài khoản thông minh (multisig, chính sách, các lệnh gọi theo lô), thì Safe’s Protocol Kit thường được ghép nối với các agent onchain để thực thi an toàn.

Nếu mục tiêu của bạn là xây dựng một AI agent onchain một cách nhanh chóng, hãy bắt đầu với Coinbase AgentKit. Nếu bạn cần một kiến trúc đa agent mạnh mẽ và lập lịch, Inngest AgentKit là một lựa chọn phù hợp. Nhiều nhóm kết hợp cả hai: OpenAI Agents để suy luận + Coinbase AgentKit cho các hành động onchain + Inngest để điều phối.

: Hướng dẫn quyết định nhanh

Bạn muốn một Web3 agent có thể di chuyển tiền, triển khai token hoặc tương tác với dapps → Sử dụng Coinbase AgentKit.

Bạn cần một hệ thống bền bỉ, hướng sự kiện để điều phối nhiều agent/công cụ với các lần thử lại và trạng thái → Sử dụng Inngest AgentKit.

Bạn yêu cầu bảo mật ví cấp doanh nghiệp hoặc quản trị multisig cho agent của mình → Tích hợp Safe’s Protocol Kit cùng với agent của bạn.

Phần 1: Cách sử dụng Coinbase AgentKit (Onchain Agents)

Tại sao nên chọn Coinbase AgentKit

Được xây dựng cho các tác vụ onchain ngay khi xuất xưởng (hoạt động ví, chuyển khoản, quản lý token)

Trải nghiệm nhà phát triển rõ ràng và công cụ khởi động nhanh

Lý tưởng cho các bot/agent giao tiếp với người dùng trên mạng xã hội (ví dụ: X) và giải quyết các hành động onchain

Tổng quan về thiết lập

Cài đặt CLI và SDK (theo hướng dẫn khởi động nhanh) và định cấu hình các biến môi trường cho mạng, khóa và điểm cuối RPC.

Khởi tạo một dự án và chọn các khả năng onchain bạn cần.

Liên kết các công cụ (ví dụ: hoạt động ví, triển khai token) với agent của bạn.

Kết nối agent với một mô hình suy luận (OpenAI hoặc tương tự) để quyết định thời điểm gọi công cụ.

Làm theo hướng dẫn khởi động nhanh chính thức để chạy trong vài phút. Để có một hướng dẫn thực hành về xây dựng một AI agent Web3 quản lý ví và tương tác trên Twitter/X, hãy xem hướng dẫn QuickNode và một video demo về tạo một bot Twitter AgentKit.

Kiến trúc ví dụ

Lớp suy luận: LLM với chức năng/gọi công cụ

Lớp hành động: Các công cụ Coinbase AgentKit (chuyển khoản, triển khai token)

Tính bền bỉ: Lưu trữ bộ nhớ/mục tiêu của agent trong cơ sở dữ liệu

Giao diện người dùng: Chat UI hoặc bot xã hội (X) cho các lệnh nhắc của người dùng

Các phương pháp hay nhất

Nguyên tắc đặc quyền tối thiểu: hạn chế các khóa agent cho các phạm vi cần thiết và số dư nhỏ

Các lệnh nhắc chính sách: xác định các quy tắc rõ ràng về thời điểm cho phép các hành động onchain

Hàng rào bảo vệ: triển khai xem trước/xác nhận giao dịch, giới hạn theo khung thời gian

Khả năng quan sát: ghi lại các lệnh gọi công cụ, giao dịch và đầu ra mô hình để kiểm tra được

Những cạm bẫy phổ biến

Quản lý khóa lỏng lẻo: không bao giờ mã hóa cứng các bí mật; sử dụng vault

Các hành động không giới hạn: yêu cầu xác nhận cho các chuyển khoản giá trị lớn

Thiếu giới hạn tốc độ: bảo vệ các điểm cuối RPC và API xã hội

Phần 2: Cách sử dụng Inngest AgentKit (Agent Networks & Orchestration)

Tại sao nên chọn Inngest AgentKit

Các agent là những worker vô trạng thái hạng nhất với các mục tiêu và bộ công cụ

Các mạng lưới để điều phối nhiều agent cho các quy trình làm việc phức tạp

Thiết kế hướng sự kiện với các lần thử lại và thực thi bền bỉ

Bắt đầu với hướng dẫn khởi động nhanh để khởi động agent đầu tiên của bạn và chạy nó bên trong một mạng lưới. Đọc các khái niệm cốt lõi—agent, công cụ, mạng lưới—trước khi kết nối logic nghiệp vụ.

Các bước thiết lập

Xác định mục tiêu và các công cụ có sẵn của agent (API, dịch vụ nội bộ, bộ công cụ onchain).

Tạo một mạng lưới và đăng ký các agent.

Phát ra các sự kiện để kích hoạt các agent; sử dụng các lần thử lại và backoff để có khả năng phục hồi.

Thêm khả năng quan sát: nhật ký, dấu vết, kết quả.

Các mẫu điều phối

Giám sát-worker: một agent lập kế hoạch ủy quyền các tác vụ cho các agent chuyên gia

Event-sourcing: các thay đổi trạng thái kích hoạt các agent phản ứng (ví dụ: payment_received → fulfillment_agent)

Human-in-the-loop: phê duyệt cho các hành động rủi ro, với tạm dừng/tiếp tục

Mẹo

Giữ cho các agent không trạng thái; truyền ngữ cảnh thông qua các sự kiện/kho lưu trữ trạng thái

Phiên bản hóa các công cụ và lệnh nhắc để theo dõi hiệu suất theo thời gian

Mô phỏng các chế độ lỗi; xác minh tính lũy đẳng cho các lệnh gọi bên ngoài

Phần 3: Thực thi an toàn với Safe (Tùy chọn nhưng được khuyến nghị)

Nếu agent của bạn quản lý tiền hoặc thực hiện các hoạt động quản trị, hãy tích hợp các tài khoản thông minh với quản trị. Safe’s Protocol Kit cung cấp khả năng tạo, cấu hình và thực thi cho các tài khoản thông minh và quy trình multisig.

Trường hợp sử dụng: Một agent onchain gửi giao dịch, trong khi chủ sở hữu (con người hoặc agent giám sát) đồng ký

Lợi ích: Kiểm soát chính sách, giới hạn chi tiêu và phục hồi an toàn

Mẫu: Agent đề xuất giao dịch; một công cụ chính sách (hoặc con người) ký và thực thi

Từng bước: Xây dựng một Onchain Agent tối thiểu

Dưới đây là một luồng khái niệm bạn có thể điều chỉnh (không phụ thuộc vào ngôn ngữ, kiểu mã giả). Tham khảo hướng dẫn khởi động nhanh của Coinbase để có mã đang hoạt động và các lệnh CLI.

Khởi tạo dự án và cài đặt các dependency

Tạo một thư mục dự án và cài đặt AgentKit SDK và máy khách LLM của bạn

Đặt các biến môi trường: URL RPC, khóa riêng hoặc ví được quản lý, mạng

Xác định các công cụ và khả năng

Ví: get_balance, transfer(to, amount)

Token: deploy_erc20(name, symbol, supply)

Đọc/ghi các lệnh gọi hợp đồng khi cần

Kết nối mô hình suy luận

Cung cấp một lệnh nhắc hệ thống xác định các mục tiêu và ràng buộc

Đăng ký các công cụ với các lược đồ để gọi hàm an toàn

Thêm an toàn và chính sách

Thực thi xác nhận cho các chuyển khoản trên ngưỡng

Giới hạn chi tiêu hàng ngày, cho phép danh sách các địa chỉ người nhận cho sản xuất

Xuất xưởng một giao diện cơ bản

CLI: agent ask "Send 0.01 ETH to 0x..."

Web/Chat: UI tối thiểu để gửi các tác vụ và hiển thị biên lai

Kiểm tra trên một testnet trước

Faucet tiền; xác minh nhật ký hành động và băm giao dịch

Chuyển sang sản xuất với khả năng quan sát

Ghi lại đo từ xa, cảnh báo về các giao dịch không thành công và sự trôi dạt trong hành vi của mô hình

Các mẫu hoạt động trong sản xuất

Lập kế hoạch-sau đó-hành động: sử dụng mô hình để phác thảo các bước trước khi gọi các công cụ

Chế độ chạy thử: xem trước các giao dịch và yêu cầu phê duyệt

Phong bì ngân sách: cung cấp cho mỗi tác vụ một giới hạn chi tiêu và thời gian chờ công cụ

Giám sát tổng hợp: các tác vụ theo lịch trình xác thực tình trạng của agent và kết nối RPC

Các kịch bản ví dụ thực tế

Bot tiền thưởng cộng đồng: Người dùng đề cập đến bot trên X; agent tiền thưởng các ví đã xác minh trênchain

Phần thưởng cho khách hàng: Agent theo dõi các hành động onchain và gửi token phần thưởng hàng tuần

Các hoạt động của DAO: Agent soạn thảo các giao dịch Safe cho các đề xuất; multisig ký sau khi xem xét

Trợ lý thị trường: Agent liệt kê NFT và trả lời các câu hỏi của người dùng, thực hiện giao dịch sau khi xác nhận

Để có một bản dựng agent Web3 được hướng dẫn, hãy xem hướng dẫn QuickNode và hội thảo của Coinbase đi qua Agents SDK + tích hợp AgentKit.

Khắc phục sự cố: Các bản sửa lỗi nhanh

Agent của tôi không thể gửi giao dịch: Kiểm tra mạng, cài đặt gas và quyền khóa; hãy thử một testnet trước

Các lệnh gọi công cụ thất thường: Thắt chặt các lược đồ và xác thực công cụ; thêm các lệnh nhắc kiểm tra trước

Các lần chạy không ổn định: Thêm các lần thử lại với backoff; theo dõi giới hạn tốc độ và mã trạng thái RPC

Các mối quan tâm về bảo mật: Xoay khóa, cách ly tiền, chuyển sang phê duyệt dựa trên Safe

Nhân tiện: Tăng tốc quy trình làm việc của bạn với Sider.AI

Đáng chú ý—nếu bạn đang lặp lại các lệnh nhắc, mã keo và tài liệu, một trợ lý có thể giúp ích. Với Sider.AI, bạn có thể giữ cho nghiên cứu, đoạn mã và nhật ký thử nghiệm được sắp xếp cùng với trình chỉnh sửa của bạn, tăng tốc các vòng lặp xây dựng-đo lường-học hỏi cho các agent. Khám phá nó ở đây:

Những điều quan trọng cần nhớ

“AgentKit” thường đề cập đến bộ công cụ onchain của Coinbase và bộ công cụ điều phối của Inngest—chọn dựa trên nhu cầu của bạn về các hành động onchain so với điều phối đa agent.

Bắt đầu nhỏ: testnet, các công cụ tối thiểu, các chính sách nghiêm ngặt; thêm khả năng dần dần.

Đối với cơ quan tài chính hoặc quản trị, hãy tích hợp Safe để quản trị và bảo mật.

Đối xử với agent như phần mềm sản xuất: ghi nhật ký, cảnh báo, giới hạn và phê duyệt của con người.

Tìm hiểu thêm

Hướng dẫn khởi động nhanh và CLI của Coinbase AgentKit

Hội thảo: OpenAI Agents SDK với Coinbase AgentKit

Xây dựng hướng dẫn AI agent Web3 (QuickNode)

Hướng dẫn khởi động nhanh và các khái niệm của Inngest AgentKit,

Safe Protocol Kit cho các tài khoản thông minh an toàn

FAQ

Q1: AgentKit là gì và tôi nên sử dụng loại nào? AgentKit thường đề cập đến Coinbase AgentKit cho các hành động onchain và Inngest AgentKit để điều phối các agent. Chọn Coinbase cho các tác vụ Web3 (ví, token) và Inngest cho các quy trình làm việc đa agent, hướng sự kiện.

Q2: Làm cách nào để cho phép một AI agent di chuyển tiền onchain một cách an toàn? Sử dụng số dư nhỏ, các lược đồ công cụ nghiêm ngặt và các lệnh nhắc xác nhận cho các hành động rủi ro. Đối với sản xuất, hãy tích hợp các tài khoản thông minh Safe và yêu cầu phê duyệt multisig hoặc chính sách.

Q3: Tôi có thể kết hợp OpenAI Agents với Coinbase AgentKit không? Có. Kết nối lớp suy luận của bạn (OpenAI Agents/gọi hàm) với các công cụ Coinbase AgentKit. Nhiều nhà phát triển cũng thêm Inngest để điều phối và thử lại.

Q4: Những cạm bẫy phổ biến khi sử dụng AgentKit là gì? Mã hóa cứng các khóa, bỏ qua testnet và cho phép các hành động không giới hạn là những điều lớn. Thêm giới hạn tốc độ, giới hạn chi tiêu và khả năng quan sát mạnh mẽ để luôn an toàn.

Q5: Tôi có thể tìm hướng dẫn khởi động nhanh để xây dựng một AI agent Web3 ở đâu? Bắt đầu với hướng dẫn khởi động nhanh của Coinbase’s AgentKit để thiết lập và ví dụ, cộng với các hướng dẫn từ QuickNode và video hội thảo để được hướng dẫn toàn diện.